Chuyển tới nội dung chính
Cập nhật lần cuối:

Rclone

Rclone là công cụ dòng lệnh mã nguồn mở, đa nền tảng (Windows/macOS/Linux), hỗ trợ hơn 70 dịch vụ lưu trữ đám mây bao gồm bất kỳ S3-compatible storage nào. Rclone đặc biệt mạnh về đồng bộ hóa, sao lưu, mount bucket như ổ đĩa local và truyền dữ liệu giữa các cloud provider.

Cài đặt Rclone

Linux / macOS

curl https://rclone.org/install.sh | sudo bash

Hoặc dùng package manager:

# macOS (Homebrew)
brew install rclone

# Ubuntu / Debian
sudo apt install rclone

# CentOS / RHEL
sudo yum install rclone

Windows

Tải file .exe từ https://rclone.org/downloads/, giải nén và thêm vào PATH, hoặc chạy trực tiếp từ thư mục đã giải nén.

Kiểm tra cài đặt:

rclone version

Cấu hình kết nối LANIT Cloud

Có hai cách cấu hình: dùng lệnh tương tác hoặc chỉnh sửa file cấu hình trực tiếp.

Trước tiên, lấy Access Key IDSecret Access Key từ LANIT Cloud Portal (xem Access Key):

Trang quản lý Access Key trên LANIT Cloud Portal

Cách 1: Cấu hình tương tác

rclone config

Làm theo các bước:

  1. Nhập n để tạo remote mới
  2. Name: đặt tên, ví dụ lanit
  3. Storage: nhập s3 (hoặc số tương ứng với Amazon S3)
  4. Provider: chọn Other (hoặc nhập số tương ứng)
  5. env_auth: false
  6. access_key_id: nhập Access Key ID từ LANIT Cloud Portal
  7. secret_access_key: nhập Secret Access Key
  8. region: để trống hoặc nhập hn
  9. endpoint: nhập s3.lanit.com.vn
  10. location_constraint: để trống
  11. acl: để trống hoặc private
  12. Xác nhận và lưu

Cách 2: Chỉnh sửa file cấu hình trực tiếp

Mở file cấu hình Rclone (thường tại ~/.config/rclone/rclone.conf trên Linux/macOS, hoặc %APPDATA%\rclone\rclone.conf trên Windows):

[lanit]
type = s3
provider = Other
access_key_id = YOUR_ACCESS_KEY_ID
secret_access_key = YOUR_SECRET_ACCESS_KEY
endpoint = s3.lanit.com.vn
region = hn
acl = private

Thay YOUR_ACCESS_KEY_IDYOUR_SECRET_ACCESS_KEY bằng thông tin thực của bạn.

Kiểm tra kết nối:

rclone lsd lanit:

Lệnh này liệt kê tất cả bucket trong tài khoản. Nếu thành công, danh sách bucket hiện ra.

Các lệnh thường dùng

Liệt kê bucket và object

# Liệt kê tất cả bucket
rclone lsd lanit:

# Liệt kê object trong bucket
rclone ls lanit:ten-bucket

# Liệt kê dạng cây thư mục
rclone tree lanit:ten-bucket

# Liệt kê object trong thư mục cụ thể
rclone ls lanit:ten-bucket/images/

Sao chép file

# Upload file lên bucket
rclone copy /duong/dan/local/file.zip lanit:ten-bucket/backup/

# Download file về máy
rclone copy lanit:ten-bucket/backup/file.zip /duong/dan/local/

# Upload toàn bộ thư mục
rclone copy /duong/dan/local/folder/ lanit:ten-bucket/folder/

# Hiển thị tiến trình
rclone copy --progress /local/folder/ lanit:ten-bucket/

Đồng bộ hóa (Sync)

Lệnh sync xóa file ở đích không còn tồn tại ở nguồn. Luôn kiểm tra với --dry-run trước.

# Xem trước (dry run) — không thực sự thay đổi gì
rclone sync --dry-run /local/backup/ lanit:ten-bucket/backup/

# Đồng bộ local → bucket
rclone sync /local/backup/ lanit:ten-bucket/backup/

# Đồng bộ bucket → local
rclone sync lanit:ten-bucket/backup/ /local/backup/

# Đồng bộ giữa hai bucket/remote
rclone sync lanit:bucket-nguon/ lanit:bucket-dich/

Chuyển dữ liệu giữa các cloud (Migration)

# Chuyển từ AWS S3 sang LANIT Cloud
rclone sync aws:bucket-aws/ lanit:bucket-lanit/ --progress

# Chuyển từ Google Drive sang LANIT Cloud
rclone sync gdrive:folder/ lanit:ten-bucket/ --progress

Xóa object

# Xóa một file
rclone deletefile lanit:ten-bucket/file.txt

# Xóa toàn bộ nội dung thư mục (giữ thư mục)
rclone delete lanit:ten-bucket/old-backups/

# Dọn dẹp bucket (xóa file "rác" từ multipart upload thất bại)
rclone cleanup lanit:ten-bucket

Mount bucket như ổ đĩa

Trên Linux/macOS (cần cài fuse):

# Tạo điểm mount
mkdir -p /mnt/lanit-storage

# Mount bucket
rclone mount lanit:ten-bucket /mnt/lanit-storage --daemon

# Unmount
fusermount -u /mnt/lanit-storage # Linux
umount /mnt/lanit-storage # macOS

Sau khi mount, bạn có thể thao tác với bucket như ổ đĩa thông thường qua file manager hoặc terminal.

Tăng tốc độ truyền dữ liệu

# Tăng số luồng song song
rclone copy --transfers 16 /local/folder/ lanit:ten-bucket/

# Chia file lớn thành nhiều phần (multipart)
rclone copy --s3-upload-concurrency 8 large-file.iso lanit:ten-bucket/

# Giới hạn băng thông (tránh chiếm toàn bộ đường truyền)
rclone copy --bwlimit 50M /local/ lanit:ten-bucket/

Tự động hóa với Cron (Linux/macOS)

Ví dụ backup mỗi ngày lúc 2:00 sáng:

crontab -e

Thêm dòng:

0 2 * * * /usr/bin/rclone sync /data/important/ lanit:my-bucket/backup/ --log-file=/var/log/rclone-backup.log

Xử lý sự cố

Lỗi AccessDenied:

  • Kiểm tra Access Key ID và Secret Access Key đúng chưa
  • Kiểm tra Bucket Policy có cho phép hành động đó không

Lỗi NoSuchBucket:

  • Kiểm tra tên bucket chính xác (phân biệt hoa/thường)
  • Đảm bảo endpoint đúng: s3.lanit.com.vn

Lỗi SignatureDoesNotMatch:

  • Kiểm tra đồng hồ máy chủ — sai lệch giờ quá 5 phút sẽ gây lỗi chữ ký
  • Chạy sudo ntpdate pool.ntp.org để đồng bộ thời gian