新增 S3 相容渠道

適合什麼情境

• 你想連接任何 S3 相容物件儲存，例如 Cloudflare R2、Backblaze B2、MinIO、AWS S3 等。
• 你不想使用 Cloudflare R2 Binding 渠道，或儲存服務不是 Cloudflare R2。

新增前要準備什麼

需要準備	用途
S3 Endpoint	物件儲存服務的 S3 API 位址
Bucket 名稱	檔案存放的 Bucket
Region	儲存區域；Cloudflare R2 通常填 auto
Access Key	S3 存取金鑰
Secret Key	S3 私密金鑰

Cloudflare R2 範例：

Endpoint: https://你的AccountID.r2.cloudflarestorage.com
Bucket: imgbed
Region: auto

欄位說明

欄位	說明	是否必填
渠道名稱	自己取，例如 R2 S3	是
Endpoint	S3 API 位址	是
Bucket 名稱	儲存桶名稱	是
Region	儲存區域，R2 可填 auto	是
Access Key	存取金鑰	是
Secret Key	私密金鑰	是
Path-style access	依服務商需求開關	否
容量限制	是否依容量參與調度	否

以 Cloudflare R2 建立 S3 Token

1. 登入 Cloudflare。
2. 進入 R2 Object Storage。
3. 找到 API Token 入口。


4. 建立帳號 API Token。

5. 複製 Access Key ID 和 Secret Access Key。

回 ImgBed 填寫 S3 設定

1. 打開上傳設定。
2. 新增渠道。
3. 選擇 S3。
4. 填 Endpoint、Bucket、Region、Access Key、Secret Key。
5. 依服務商需求設定 Path-style access。
6. 如果要容量控管，再開啟容量限制並填容量上限。
7. 儲存。

檢查方式

檢查項目	正常狀態
主要欄位已儲存	詳情頁看得到 Endpoint、Bucket、Region 等資訊
測試上傳	上傳圖片後 Bucket 裡會出現檔案
連結可開啟	上傳回傳的圖片連結能正常開啟
容量顯示	若開啟容量限制，卡片會顯示已用容量與上限

容量統計說明

S3 容量統計是依照 ImgBed 本地 D1 檔案紀錄計算，不是即時掃描服務商 Bucket。

儲存 S3 設定後，系統會依目前 D1 紀錄重新計算容量帳本。

常見問題

為什麼上傳失敗？

優先檢查：

1. Endpoint 是否正確。
2. Bucket 是否存在。
3. Region 是否符合服務商要求。
4. Access Key / Secret Key 是否有寫入權限。
5. Path-style access 是否符合該服務商需求。

快速流程

準備 S3 Endpoint、Bucket、Region、Access Key、Secret Key
-> 打開上傳設定
-> 新增 S3 渠道
-> 填 Endpoint / Bucket / Region / Access Key / Secret Key
-> 依服務商需求調整 Path-style access
-> 儲存
-> 上傳測試圖片