Bắt đầu

Chuyển tệp vào object storage.

Đưa tệp từ Amazon S3, Google Cloud Storage, bất kỳ kho lưu trữ tương thích S3 nào hoặc một thư mục trên máy chủ của bạn vào bucket: sao chép tất cả một lần, hoặc chuyển dần mà không gián đoạn.

7 PHÚT ĐỌC

Bạn đang lưu tệp ở nơi khác? Hãy chuyển chúng vào bucket của ứng dụng theo một trong hai cách. Cả hai đều bắt đầu từ bảng điều khiển: ứng dụng → Lưu trữ → bucket → Chuyển tệp vào.

Sao chép tất cả ngayChuyển dần, không gián đoạn
Điều gì xảy ramọi tệp được sao chép trong một lầntệp được sao chép vào lần đầu ứng dụng đọc nó
Khi nào chuyển ứng dụng sangsau khi sao chép xongngay lập tức
Tiến trìnhsố tệp tìm thấy, đã sao chép, bỏ qua, không sao chép được; tạm dừng, tiếp tục, dừnghoạt động cho đến khi bạn tắt
Kho lưu trữ cũAmazon S3, Google Cloud Storage, tương thích S3Amazon S3, Google Cloud Storage

Việc sao chép chạy ở phía chúng tôi — máy tính của bạn không cần bật. Khi hoàn tất (hoặc nếu dừng trước khi xong), bạn nhận được email và tin nhắn Telegram.

Chủ tài khoản và Quản trị viên của ứng dụng có thể chuyển tệp (xem Quyền truy cập của nhóm), và cũng có thể thực hiện qua API, CLI và MCP.

Trước khi bắt đầu: khóa chỉ có quyền đọc

Tạo một khóa riêng cho lần chuyển này trong kho lưu trữ cũ, chỉ có quyền liệt kê và đọc đúng một bucket. Không bao giờ dán khóa chính của bạn. Khóa chỉ được dùng cho lần chuyển này; chúng tôi không lưu lại và nó không bao giờ được hiển thị lại. Hãy xóa khóa tại nhà cung cấp cũ khi đã chuyển xong.

Amazon S3

Trong IAM, tạo một người dùng (hoặc role có access key) với policy sau — thay my-old-bucket bằng bucket của bạn:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:List*", "s3:Get*"],
      "Resource": ["arn:aws:s3:::my-old-bucket", "arn:aws:s3:::my-old-bucket/*"]
    }
  ]
}

Sau đó tạo access key cho người dùng này. Trong bảng điều khiển, bạn cần access key ID, secret access key, tên bucket và region của nó (ví dụ eu-central-1; được hiển thị cạnh bucket trong S3 console).

Google Cloud Storage

Tạo service account có quyền đọc bucket và tải khóa JSON của nó:

gcloud iam service-accounts create rivervo-move --display-name="Move files to Rivervo"
gcloud storage buckets add-iam-policy-binding gs://my-old-bucket \
  --member="serviceAccount:rivervo-move@MY-PROJECT.iam.gserviceaccount.com" --role="roles/storage.objectViewer"
gcloud storage buckets add-iam-policy-binding gs://my-old-bucket \
  --member="serviceAccount:rivervo-move@MY-PROJECT.iam.gserviceaccount.com" --role="roles/storage.legacyBucketReader"
gcloud iam service-accounts keys create key.json \
  --iam-account="rivervo-move@MY-PROJECT.iam.gserviceaccount.com"

Storage Object Viewer đọc các tệp; Storage Legacy Bucket Reader cho phép quá trình sao chép đọc chính bucket. Trong bảng điều khiển, dán toàn bộ nội dung của key.json. Sau đó hãy xóa tệp khóa khỏi máy tính.

Kho lưu trữ tương thích S3 khác

Mọi kho lưu trữ có S3 API đều hoạt động tương tự: tạo khóa chỉ có quyền liệt kê và đọc bucket (phần lớn nhà cung cấp gọi là khóa «read-only» hoặc «restricted»), và tìm địa chỉ S3 của region chứa bucket — ví dụ https://s3.eu-central-003.backblazeb2.com. Nhập địa chỉ không kèm tên bucket.

Sao chép tất cả ngay

  1. Ứng dụng → Lưu trữ → bucket → Chuyển tệp vào.
  2. Chọn Sao chép tất cả ngay, kho lưu trữ cũ, bucket ở đó, region hoặc địa chỉ S3, và dán khóa.
  3. Tùy chọn: một thư mục — ví dụ chỉ sao chép photos/.
  4. Tệp đã có ở đây: mặc định, nếu bucket đã có tệp cùng tên thì tệp đó được giữ lại và tệp từ kho lưu trữ cũ bị bỏ qua. Bật Thay thế để ghi đè.
  5. Bắt đầu sao chép và xác nhận.

Thẻ hiển thị số tệp được tìm thấy, đã sao chép, bị bỏ qua và không sao chép được, kèm thanh tiến trình; Xem log liệt kê các tệp bị bỏ qua hoặc không sao chép được. Bạn có thể Tạm dừng, Tiếp tục hoặc Dừng sao chép — các tệp đã sao chép vẫn được giữ. Khi sao chép xong, hãy chuyển ứng dụng sang bucket (ứng dụng đã có các biến S3_*).

Tệp giữ nguyên tên (key). Chạy lại việc sao chép sau này chỉ sao chép những tệp còn thiếu (khi Thay thế đang tắt).

Chuyển dần, không gián đoạn

Hữu ích khi ứng dụng phải hoạt động liên tục và tệp mới được thêm thường xuyên:

  1. Chuyển tệp vào → Chuyển dần, không gián đoạn, kho lưu trữ cũ, bucket và khóa → Bật chuyển dần.
  2. Chuyển ứng dụng sang bucket này ngay (các biến S3_* của nó) và deploy.
  3. Khi ứng dụng đọc một tệp chưa có trong bucket, tệp đó được sao chép từ kho lưu trữ cũ ngay lúc đó và trả về. Tệp tải lên mới được lưu thẳng vào bucket.
  4. Để hoàn tất: chạy Sao chép tất cả ngay cho những tệp chưa ai đọc (với Thay thế tắt, để giữ các tệp mới hơn), chờ cho đến khi xong, sau đó Tắt chuyển dần.

Cho đến khi bạn tắt, kho lưu trữ cũ phải luôn khả dụng với cùng khóa. Các tệp chưa từng được đọc và chưa được sao chép sẽ không được lấy về nữa sau khi tắt.

Từ một thư mục trên máy chủ của bạn

Để chuyển tệp từ VPS hoặc bất kỳ máy chủ nào khác (ví dụ storage/app/public của website Laravel), hãy dùng rclone với khóa riêng của bucket. Bạn tìm thấy chúng trong tab Biến của ứng dụng: S3_ENDPOINT, S3_BUCKET, S3_KEY và S3_SECRET (bucket thứ hai có tên của nó ở đầu: MEDIA_S3_KEY …).

# Cài rclone (Linux)
curl https://rclone.org/install.sh | sudo bash
 
# Khóa của bucket dưới dạng biến môi trường — chúng không bị ghi vào tệp cấu hình
export RCLONE_CONFIG_RIVERVO_TYPE=s3
export RCLONE_CONFIG_RIVERVO_PROVIDER=Other
export RCLONE_CONFIG_RIVERVO_REGION=auto
export RCLONE_CONFIG_RIVERVO_ENDPOINT='giá trị của S3_ENDPOINT'
export RCLONE_CONFIG_RIVERVO_ACCESS_KEY_ID='giá trị của S3_KEY'
export RCLONE_CONFIG_RIVERVO_SECRET_ACCESS_KEY='giá trị của S3_SECRET'
 
# Sao chép thư mục vào bucket (giá trị của S3_BUCKET), giữ nguyên cấu trúc thư mục
rclone copy /var/www/shop/storage/app/public rivervo:BUCKET/public --progress --transfers 16
 
# Kiểm tra mọi tệp đã được chuyển đến
rclone check /var/www/shop/storage/app/public rivervo:BUCKET/public --one-way

rclone copy không bao giờ xóa gì trong bucket và bỏ qua các tệp đã có mà không thay đổi, nên bạn có thể chạy lại sau khi bị gián đoạn. Với lần sao chép dài, hãy chạy trong tmux hoặc screen trên máy chủ — khi đó quá trình vẫn tiếp tục nếu kết nối SSH bị ngắt.

Chi phí

Bản thân việc chuyển không mất phí. Tệp trong bucket được tính theo giá object storage thông thường, trừ từ số dư của bạn:

  • lưu trữ: 0,025 US$ mỗi GB mỗi tháng — 50 GB tốn khoảng 1,25 US$ mỗi tháng;
  • lượt ghi: 6 US$ mỗi triệu — mỗi tệp được sao chép tương đương khoảng một lượt ghi, nên 100.000 tệp tốn khoảng 0,60 US$ (tệp rất lớn được tải lên theo từng phần và tính vài lượt ghi);
  • lượt đọc trong khi chuyển dần là lượt đọc thông thường (0,50 US$ mỗi triệu).

Phần lớn nhà cung cấp lưu trữ đám mây tính phí dữ liệu đi ra (egress). Hãy xem bảng giá của nhà cung cấp cũ trước khi chuyển nhiều dữ liệu.

Việc chuyển tệp cần số dư dương, giống như khi thêm bucket. Tính năng này không khả dụng trong thời gian dùng thử miễn phí và không thể chuyển vào bucket ở chế độ chỉ đọc (vượt giới hạn dung lượng, hoặc vượt mức số dư chi trả được) — bảng điều khiển cho biết lý do và gợi ý nạp tiền khi điều đó giúp ích. Nếu bucket chuyển sang chỉ đọc trong lúc đang sao chép, quá trình sao chép sẽ tạm dừng và tự tiếp tục khi có thể ghi trở lại.

Giới hạn

  • Mỗi bucket chỉ có một lần sao chép và một lần chuyển dần tại một thời điểm.
  • Tệp lớn hơn 1 TB bị bỏ qua khi sao chép.
  • Tệp thuộc lớp lưu trữ archive cần khôi phục trước khi đọc (S3 Glacier Flexible Retrieval, Glacier Deep Archive) sẽ bị bỏ qua; hãy khôi phục chúng trước.
  • Chỉ metadata riêng của bạn (x-amz-meta-*) được chuyển cùng tệp; ETag của tệp có thể khác với ETag cũ.
  • Tệp bị xóa khỏi bucket trong khi chuyển dần đang bật sẽ được sao chép lại ở lần đọc tiếp theo.

Vẫn còn vướng mắc?

Chat với chúng tôi — AI trả lời ngay và kỹ sư tham gia khi cần, bất kể giờ nào trong ngày.

Liên hệ hỗ trợ