將檔案移入物件儲存。
將 Amazon S3、Google Cloud Storage、任何相容 S3 的儲存服務或您伺服器上資料夾中的檔案移入儲存桶:一次複製全部,或在不停機的情況下逐步移轉。
檔案已存放在其他地方?您可以用兩種方式將它們移入應用程式的儲存桶。兩者都從控制台開始:應用程式 → 儲存空間 → 儲存桶 → 移入檔案。
| 立即複製全部 | 逐步移轉,不停機 | |
|---|---|---|
| 運作方式 | 一次複製所有檔案 | 應用程式第一次讀取某個檔案時才複製 |
| 何時切換應用程式 | 複製完成後 | 立即 |
| 進度 | 找到、已複製、已略過、未複製的檔案;可暫停、繼續、停止 | 持續運作直到您關閉 |
| 舊儲存服務 | Amazon S3、Google Cloud Storage、相容 S3 | Amazon 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。輸入網址時請勿包含儲存桶名稱。
立即複製全部
- 應用程式 → 儲存空間 → 儲存桶 → 移入檔案。
- 選擇立即複製全部、舊儲存服務、其中的儲存桶、區域或 S3 網址,並貼上金鑰。
- 選用:指定資料夾——例如只複製
photos/。 - 已存在的檔案:預設情況下,若儲存桶中已有同名檔案,會保留現有檔案並略過舊儲存服務中的檔案。開啟取代它們即可覆寫。
- 按開始複製並確認。
卡片會以進度列顯示找到、已複製、已略過與未複製的檔案數;顯示記錄會列出已略過或無法複製的檔案名稱。您可以暫停、繼續或停止複製——已複製的檔案會保留。複製完成後,請將應用程式切換到該儲存桶(它已有 S3_* 變數)。
檔案會保留原本的名稱(鍵)。之後再次執行複製,只會複製缺少的檔案(取代它們為關閉時)。
逐步移轉,不停機
適用於應用程式必須持續運作且不斷新增檔案的情況:
- 移入檔案 → 逐步移轉,不停機,選擇舊儲存服務、儲存桶與金鑰 → 開啟逐步移轉。
- 立即將應用程式切換到此儲存桶(使用其
S3_*變數)並部署。 - 當應用程式讀取尚未在儲存桶中的檔案時,會在當下從舊儲存服務複製並提供該檔案。新上傳的檔案會直接存入儲存桶。
- 完成移轉:為尚未被讀取的檔案執行立即複製全部(取代它們保持關閉,以保留較新的檔案),等待完成後再關閉逐步移轉。
在您關閉之前,舊儲存服務必須以相同金鑰保持可用。關閉後,從未被讀取且未被複製的檔案將不再擷取。
從您伺服器上的資料夾
若要從 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-wayrclone 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 可能與舊的不同。 - 逐步移轉開啟期間從儲存桶刪除的檔案,下次被讀取時會再次複製。