Cloudflare R2 上傳器

前端直傳檔案到 Cloudflare R2 儲存桶，不受官方300MB限制

R2 配置

1貼上 S3 API 地址

從 R2 儲存桶 → 設定 → S3 API 複製完整地址

2填寫 API Tokens

Access Key ID

Secret Access Key

上傳路徑（可選）

安全提示：配置儲存在 sessionStorage 中，關閉頁面後自動清除。

3CORS 配置

在 R2 儲存桶 → 設定 → CORS 策略中新增以下配置：

[{
  "AllowedOrigins": ["*"],
  "AllowedMethods": ["GET","PUT","POST","DELETE","HEAD"],
  "AllowedHeaders": ["*"],
  "ExposeHeaders": ["ETag"]
}]

⚠️ 必須包含 ExposeHeaders: ["ETag"]，否則分片上傳會失敗

點擊或拖放檔案到這裡

直接上傳到 R2，不經過伺服器

支援大檔案上傳（自動分片），建議單檔案不超過 5GB

(0 個檔案)

暫無檔案

配置 R2 參數後點擊「重新整理」查看檔案列表

強大而安全的 R2 檔案上傳解決方案

檔案直接從瀏覽器上傳到 R2，不經過伺服器中轉，速度更快、更安全

使用分片上傳技術，支援上傳超過官方 300MB 限制的大檔案，最大支援 5GB

顯示真實的上傳進度，支援同時上傳多個檔案，大檔案自動分片並行上傳

支援自訂上傳路徑、產生臨時存取連結或永久公開連結

瀏覽儲存桶檔案列表、刪除檔案、複製檔案連結，一站式管理

配置資訊僅儲存在瀏覽器工作階段中，關閉頁面自動清除，保護您的金鑰安全

關於 R2 Uploader 的常見疑問解答

為什麼可以突破 Cloudflare R2 官方 300MB 的上傳限制？

Cloudflare R2 官方控制台的 300MB 限制是 Web 介面的限制。本工具使用 S3 相容 API 進行分片上傳（Multipart Upload），將大檔案分割成多個小塊並行上傳，最後合併成完整檔案。這是 S3 標準支援的功能，理論上支援最大 5TB 的單檔案上傳。

我的 API 金鑰安全嗎？

您的 API 金鑰僅儲存在瀏覽器的 sessionStorage 中，關閉瀏覽器分頁後自動清除。金鑰不會上傳到任何伺服器，所有操作都在您的瀏覽器中完成，直接與 Cloudflare R2 通訊。建議建立僅具有必要權限的 API Token，並在使用後及時刪除。

上傳失敗顯示 CORS 錯誤怎麼辦？

需要在 R2 儲存桶設定中配置 CORS 策略。點擊第3步「查看範例」按鈕，按照指引配置 CORS。特別注意需要新增 ExposeHeaders: ["ETag"]，否則分片上傳會失敗。

如何取得檔案的公開存取連結？

有兩種方式：1) 臨時連結：點擊檔案列表中的複製按鈕，產生帶簽名的預簽名 URL，最長有效期 7 天；2) 永久連結：在 R2 控制台開啟儲存桶的公開存取，取得公開 URL 後填入彈窗中即可產生永久有效的公開連結。

上傳速度很慢或經常逾時怎麼辦？

上傳速度主要取決於您的網路頻寬和到 Cloudflare 節點的延遲。建議：檢查網路連線是否穩定；避免同時進行其他大流量操作；如果使用 VPN，嘗試切換節點或關閉 VPN；大檔案會自動分片並行上傳，逾時時間會根據檔案大小自動延長。

支援哪些檔案類型？有大小限制嗎？

支援所有檔案類型，沒有格式限制。單檔案大小建議不超過 5GB（S3 分片上傳的實際限制是 5TB，但瀏覽器記憶體可能成為瓶頸）。可以同時上傳多個檔案，系統會自動排隊處理。