Mac 上傳 Cloudflare R2：將檔案存入自己的儲存貯體

更新日期: 2026-10-29

Mac 上傳 Cloudflare R2：設定方式

若要在 Mac 上傳 Cloudflare R2，請先建立或選擇自己的 Cloudflare R2 儲存貯體，取得其憑證，並在 Yuzu Drag 的 Upload 設定中輸入連線資訊。接著拖曳檔案，開啟 Actions，再將檔案拖放到 UPLOAD。Upload 需要網路連線，並會將檔案傳送到你自己的 S3 相容儲存貯體。Yuzu 不提供託管儲存空間。

快捷鍵說明： 以下步驟使用預設快捷鍵。持續拖移檔案時，短按並放開 ⌘ 可開啟 Tools，再按一次可開啟 Actions；⇧ 則開啟 Convert。若已在 Yuzu 更改快捷鍵，請使用自己設定的按鍵。

上傳成功不會自動讓物件公開。請另外決定哪些人應該能取得檔案，以及是否需要公開網址。

先從服務供應商的瀏覽器介面開始

macOS 的 Finder 未內建 R2 儲存貯體連線功能。如果只是偶爾上傳，可使用 Safari 或其他瀏覽器開啟 Cloudflare 儀表板，選取目標儲存貯體，再透過其上傳介面操作。這樣就不必安裝桌面用戶端，也不必向用戶端提供儲存服務憑證。

上傳後，請在儀表板中檢查物件。確認其名稱、目的地儲存貯體及預期的存取權限。若要進行一次性的管理作業或變更儲存貯體政策，在服務供應商的儀表板中操作會更清楚，因為這些政策不在檔案拖曳工具的職責範圍內。

當儲存貯體已設定完成，而你想避免反覆開啟儀表板時，就適合使用桌面上傳工具。也請確保儀表板仍可使用，方便檢查物件、存取規則、憑證與帳戶用量。

準備自己的儲存貯體與憑證

設定 Yuzu 前，請先從服務供應商帳戶取得端點、儲存貯體名稱、存取金鑰 ID 與私密存取金鑰。Cloudflare R2 的區域值為 auto。請使用供應商為你的帳戶提供的實際端點，不要複製他人的範例端點。

只授予憑證在指定儲存貯體與工作流程中所需的權限。不要將憑證放在文件、螢幕截圖、Shell 歷史記錄或分享的訊息中。Yuzu 會將私密金鑰儲存在「鑰匙圈」，但你仍有責任保護憑證，並在需要時透過服務供應商帳戶撤銷憑證。

選擇一個體積小、不含敏感資訊的測試檔案。第一次測試應確認物件會存入哪個儲存貯體與路徑，而不是在檢查設定前，就先傳送整個工作資料夾。

在 Yuzu Drag 中設定 Upload

從下載頁面安裝應用程式。開啟 Upload 設定，填入表單中顯示的欄位：

Endpoint：你的 S3 相容服務端點。
Bucket：你擁有或獲授權使用的現有儲存貯體。
Access Key ID：對應的憑證識別碼。
Secret：私密存取金鑰，儲存設定時會存入「鑰匙圈」。
Region：Cloudflare R2 請填入 auto。
Path prefix：透過這組設定上傳物件時使用的前綴，可不填。
Public URL：用於產生連結的公開網址基底，可不填。

使用 Test connection 檢查尚未儲存的設定。連線測試會檢查儲存貯體，但不會儲存你編輯的值。若要保留這些值，請另外點按 Save。連線檢查成功有助於確認連線狀態，但不代表已完成完整的上傳與下載測試。

Public URL 欄位為選填。若想取得可用的公開連結，請填入確實能提供已上傳物件的網址基底。輸入網址不會變更儲存貯體的存取政策，也不會為它建立公開網域。

上傳並檢查結果

在 Finder 中開始拖曳測試檔案。
按一下 ⌘ 開啟 Tools，再按一次 ⌘ 開啟 Actions。若同時選取不同類型的項目，某些組合會直接開啟 Actions。
將檔案拖放到 UPLOAD 扇形區塊。
等待作業結果。
在服務供應商儀表板中檢查已上傳的物件。
將複製的結果貼到私人筆記中，確認內容是網址還是物件索引鍵。

輪盤也可用 ⇧ 開啟 Convert；這個群組與上傳功能分開。UPLOAD 是一項 Action，只接受檔案，不接受資料夾。

設定公開網址基底後，Yuzu 會在上傳完成後複製連結。若未設定，則會複製物件索引鍵。批次上傳時，複製的各筆結果會以換行分隔。在貼到訊息中之前，請先檢查內容：物件索引鍵不是可直接提供給收件者下載的連結。

上傳會建立遠端物件，本機來源檔案則會留在原處。若遠端已有物件使用預定的名稱，Yuzu 會嘗試使用帶有編號的名稱，而非刻意覆寫該物件。請確認最終的物件索引鍵，不要假設原始檔名會原封不動地沿用。

公開存取、費用與失敗處理

只有在檔案適合公開存取時，才分享公開連結。測試連結時，不要依賴儀表板中已通過驗證的登入狀態。如果物件應維持私密，就讓它保持私密，並使用組織核准的存取方式，而不是單純為了方便就填入公開網址基底。

儲存、資料擷取與服務供應商的限制，都以你自己的帳戶為準。Yuzu 不是備份服務，也不是儲存貯體政策編輯器，更不保證連結會一直可用。請在服務供應商儀表板中管理物件的刪除與保留。

如果批次上傳只有部分成功，請先檢查作業結果，再重試整批選取項目。即使後續項目上傳失敗，或你取消了其餘項目，已完成上傳的物件仍可能保留在儲存貯體中。重試可能會建立更多帶有編號的物件，因此請核對儲存貯體內容與原本打算傳送的檔案，確認兩者一致。

遇到連線錯誤時，請先重新檢查端點、儲存貯體、區域與憑證權限範圍，再變更其他無關設定。動作工具總覽與指南索引可協助你區分上傳與本機檔案整理。

常見問題

Yuzu 會提供儲存貯體嗎？

不會。Upload 會使用你提供的憑證，連線至你自己的 S3 相容儲存貯體。儲存費用由你在服務供應商的帳戶承擔，存取政策也由該帳戶管理。

為什麼複製的是物件索引鍵，而不是連結？

若未設定公開網址基底，Yuzu 會複製物件索引鍵。索引鍵本身不是公開下載網址。