立即開始

將檔案移入物件儲存。

將 Amazon S3、Google Cloud Storage、任何相容 S3 的儲存服務或您伺服器上資料夾中的檔案移入儲存桶:一次複製全部,或在不停機的情況下逐步移轉。

2 分鐘閱讀

檔案已存放在其他地方?您可以用兩種方式將它們移入應用程式的儲存桶。兩者都從控制台開始:應用程式 → 儲存空間 → 儲存桶 → 移入檔案。

立即複製全部逐步移轉,不停機
運作方式一次複製所有檔案應用程式第一次讀取某個檔案時才複製
何時切換應用程式複製完成後立即
進度找到、已複製、已略過、未複製的檔案;可暫停、繼續、停止持續運作直到您關閉
舊儲存服務Amazon S3、Google Cloud Storage、相容 S3Amazon S3、Google Cloud Storage

複製在我們這端執行——您的電腦不需要保持開機。完成時(或在結束前中止時),您會收到電子郵件與 Telegram 訊息。

帳戶擁有者與應用程式的管理員可以移轉檔案(請參閱團隊存取權限),也可以透過 API、CLI 與 MCP 進行。

開始之前:只能讀取的金鑰

請在舊儲存服務中為這次移轉另外建立一組金鑰,僅能列出並讀取該儲存桶。切勿貼上您的主要金鑰。金鑰僅用於這次移轉;我們不會保存,也不會再次顯示。移轉完成後,請在舊服務商刪除該金鑰。

Amazon S3

在 IAM 中建立一位使用者(或具存取金鑰的角色),並套用此原則——將 my-old-bucket 換成您的儲存桶:

{
  "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/*"]
    }
  ]
}

接著為其建立存取金鑰。在控制台中,您需要存取金鑰 ID、私密存取金鑰、儲存桶名稱及其區域(例如 eu-central-1;顯示在 S3 主控台中儲存桶旁)。

Google Cloud Storage

建立具該儲存桶讀取權限的服務帳戶,並下載其 JSON 金鑰:

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 用於讀取檔案;Storage Legacy Bucket Reader 讓複製作業能讀取儲存桶本身。在控制台中貼上 key.json 的完整內容。完成後請從您的電腦刪除金鑰檔案。

其他相容 S3 的儲存服務

任何提供 S3 API 的儲存服務都適用相同方式:建立只能列出並讀取該儲存桶的金鑰(大多數服務商稱為「唯讀」或「受限」金鑰),並找出儲存桶所在區域的 S3 網址——例如 https://s3.eu-central-003.backblazeb2.com。輸入網址時請勿包含儲存桶名稱。

立即複製全部

  1. 應用程式 → 儲存空間 → 儲存桶 → 移入檔案。
  2. 選擇立即複製全部、舊儲存服務、其中的儲存桶、區域或 S3 網址,並貼上金鑰。
  3. 選用:指定資料夾——例如只複製 photos/。
  4. 已存在的檔案:預設情況下,若儲存桶中已有同名檔案,會保留現有檔案並略過舊儲存服務中的檔案。開啟取代它們即可覆寫。
  5. 按開始複製並確認。

卡片會以進度列顯示找到、已複製、已略過與未複製的檔案數;顯示記錄會列出已略過或無法複製的檔案名稱。您可以暫停、繼續或停止複製——已複製的檔案會保留。複製完成後,請將應用程式切換到該儲存桶(它已有 S3_* 變數)。

檔案會保留原本的名稱(鍵)。之後再次執行複製,只會複製缺少的檔案(取代它們為關閉時)。

逐步移轉,不停機

適用於應用程式必須持續運作且不斷新增檔案的情況:

  1. 移入檔案 → 逐步移轉,不停機,選擇舊儲存服務、儲存桶與金鑰 → 開啟逐步移轉。
  2. 立即將應用程式切換到此儲存桶(使用其 S3_* 變數)並部署。
  3. 當應用程式讀取尚未在儲存桶中的檔案時,會在當下從舊儲存服務複製並提供該檔案。新上傳的檔案會直接存入儲存桶。
  4. 完成移轉:為尚未被讀取的檔案執行立即複製全部(取代它們保持關閉,以保留較新的檔案),等待完成後再關閉逐步移轉。

在您關閉之前,舊儲存服務必須以相同金鑰保持可用。關閉後,從未被讀取且未被複製的檔案將不再擷取。

從您伺服器上的資料夾

若要從 VPS 或其他伺服器移轉檔案(例如 Laravel 網站的 storage/app/public),請使用 rclone 搭配儲存桶自己的金鑰。金鑰可在應用程式的變數分頁找到:S3_ENDPOINT、S3_BUCKET、S3_KEY 與 S3_SECRET(第二個儲存桶的變數前面會加上其名稱:MEDIA_S3_KEY……)。

# 安裝 rclone(Linux)
curl https://rclone.org/install.sh | sudo bash
 
# 以環境變數提供儲存桶的金鑰——不會寫入設定檔
export RCLONE_CONFIG_RIVERVO_TYPE=s3
export RCLONE_CONFIG_RIVERVO_PROVIDER=Other
export RCLONE_CONFIG_RIVERVO_REGION=auto
export RCLONE_CONFIG_RIVERVO_ENDPOINT='S3_ENDPOINT 的值'
export RCLONE_CONFIG_RIVERVO_ACCESS_KEY_ID='S3_KEY 的值'
export RCLONE_CONFIG_RIVERVO_SECRET_ACCESS_KEY='S3_SECRET 的值'
 
# 將資料夾複製到儲存桶(S3_BUCKET 的值),並保留資料夾結構
rclone copy /var/www/shop/storage/app/public rivervo:BUCKET/public --progress --transfers 16
 
# 檢查每個檔案都已送達
rclone check /var/www/shop/storage/app/public rivervo:BUCKET/public --one-way

rclone copy 絕不會刪除儲存桶中的任何內容,並會略過已存在且未變更的檔案,因此中斷後可以再次執行。進行長時間複製時,請在伺服器上的 tmux 或 screen 中執行——即使 SSH 連線中斷,複製也會繼續。

費用

移轉本身不收費。儲存桶中的檔案依一般物件儲存價格計費,從您的餘額扣除:

  • 儲存:每月每 GB US$0.025——50 GB 每月約 US$1.25;
  • 寫入:每百萬次 US$6.00——每個複製的檔案約為一次寫入,因此 100,000 個檔案約 US$0.60(非常大的檔案會分段上傳,計為數次寫入);
  • 逐步移轉期間的讀取為一般讀取(每百萬次 US$0.50)。

大多數雲端儲存服務商會對流出的資料收費(egress)。移轉大量資料前,請先查看舊服務商的價目表。

移轉檔案需要正數餘額,與新增儲存桶相同。免費試用期間無法使用,也無法移入唯讀的儲存桶(超過大小上限,或超出餘額可支付的範圍)——控制台會說明原因,並在有幫助時提供儲值選項。若複製進行中儲存桶變為唯讀,複製會暫停,待可再次寫入時自動繼續。

限制

  • 每個儲存桶同時只能進行一個複製與一個逐步移轉。
  • 大於 1 TB 的檔案會在複製時略過。
  • 屬於需先還原才能讀取的封存類別的檔案(S3 Glacier Flexible Retrieval、Glacier Deep Archive)會被略過;請先還原這些檔案。
  • 只有您自己的中繼資料(x-amz-meta-*)會隨檔案移轉;檔案的 ETag 可能與舊的不同。
  • 逐步移轉開啟期間從儲存桶刪除的檔案,下次被讀取時會再次複製。

還有問題嗎?

和我們對談——AI 會立即回覆,需要時由工程師加入,全天候服務。

聯絡客服