Koofr VPS Gateway & Monitor

Koofr Storage

245 GB / 1.1 TB

VPS SSD Cache

-- MB / 5.0 GB

VPS RAM & CPU

-- MB / 8GB

Rate Limit Protection

5 TPS Safe Mode

/mnt/koofr/

Upload File

Kéo và thả file vào đây để tải lên trực tiếp VPS (Không giới hạn dung lượng)

Uploading... 0%

Tên file / thư mục	Kích thước	Ngày chỉnh sửa	Thao tác
Đang tải danh sách file...

Dung lượng Koofr Cloud & Local Cache

Koofr 1TB Storage (Used: -- GB) --%

VPS VFS SSD Cache (Used: -- MB / 5.0 GB) --%

VPS Disk Root (/dev/vda1) --%

Trạng thái Dịch vụ VPS

rclone-koofr.service

FUSE Mount tại /mnt/koofr (5GB Cache Mode, RC enabled)

Active

rclone-ebook-serve.service

HTTP Ebook Server (Port 8092)

Active

Logrotate Config

/etc/logrotate.d/rclone-koofr (Weekly 10MB)

Configured

Live Rclone & Gateway Logs

Đang nạp dữ liệu log...

Cơ chế Xác thực (Authentication)

Tải về Hướng dẫn Tích hợp API (.md)

Tất cả các REST API đều hỗ trợ 3 hình thức truyền Token/API Key:

1. HTTP Header (Khuyên dùng)

X-API-Key: koofr_gateway_secret_api_key_2026

2. Query Parameter

?key=koofr_gateway_secret_api_key_2026

3. Cookie Session

session_token=...

Danh sách REST API Endpoints

GET /api/status

Lấy toàn bộ số liệu giám sát (Koofr 1TB, Cache 5GB, RAM, CPU, Services)

# cURL Example
curl -H "X-API-Key: koofr_gateway_secret_api_key_2026" https://cloud.nthquan.qzz.io/api/status

GET /api/files?path=ebooks

Duyệt danh sách file & thư mục tức thì trong /mnt/koofr

# cURL Example
curl -H "X-API-Key: koofr_gateway_secret_api_key_2026" "https://cloud.nthquan.qzz.io/api/files?path=ebooks"

POST /api/files/upload

Upload 1 hoặc nhiều file trực tiếp (Multipart Stream)

# cURL Example
curl -X POST -H "X-API-Key: koofr_gateway_secret_api_key_2026" \
  -F "path=ebooks" \
  -F "files=@my_book.epub" \
  https://cloud.nthquan.qzz.io/api/files/upload

GET /api/files/download?path=...

Download tốc độ cao qua VPS Edge (Hỗ trợ Resume Range)

# cURL Example
curl -H "X-API-Key: koofr_gateway_secret_api_key_2026" \
"https://cloud.nthquan.qzz.io/api/files/download?path=ebooks/sample.epub" -o sample.epub

DELETE /api/files?path=...

Xóa file hoặc thư mục trên Koofr

# cURL Example
curl -X DELETE -H "X-API-Key: koofr_gateway_secret_api_key_2026" "https://cloud.nthquan.qzz.io/api/files?path=temp_folder"

POST /api/sync/refresh

Kích hoạt Rclone Remote Control làm mới VFS cache tức thì

# cURL Example
curl -X POST -H "X-API-Key: koofr_gateway_secret_api_key_2026" https://cloud.nthquan.qzz.io/api/sync/refresh

WS /ws/telemetry

Kênh WebSocket phát trực tiếp số liệu CPU/RAM/Koofr mỗi 2s

# JS WebSocket Example
const ws = new WebSocket('wss://cloud.nthquan.qzz.io/ws/telemetry');
ws.onmessage = (e) => console.log(JSON.parse(e.data));