新增 WebDAV 儲存渠道

適合什麼情境

• 你有 NAS、雲端硬碟或物件儲存服務提供 WebDAV 端點。
• 你想把上傳圖片存到自己的 WebDAV 目錄。
• 你希望設定與憑證存在 D1 的 upload_channels 表，不長期暴露在前端。

新增前要準備什麼

需要準備	用途
WebDAV Endpoint	服務端 WebDAV 位址，例如 https://nas.example.com/dav
使用者名稱	登入 WebDAV 服務
密碼	登入 WebDAV 服務，建議用應用程式密碼
儲存目錄	檔案存放目錄，預設 imgbed

入口位置

1. 進入系統設定。
2. 打開上傳設定。
3. 點「新增渠道」。
4. 選擇 WebDAV。

欄位說明

欄位	作用	是否必填
渠道名稱	用來辨識這個 WebDAV 渠道，例如 nas 或 koofr	是
Endpoint	完整 WebDAV 位址，包含 https://	是
使用者名稱	WebDAV 登入帳號	是
密碼	WebDAV 登入密碼或應用程式密碼	是
儲存目錄	檔案存放目錄，預設 imgbed	否

如果服務支援應用程式密碼，建議使用應用程式密碼，不要直接使用主帳號密碼。

回 ImgBed 填寫設定

欄位	填寫方式
Endpoint	WebDAV 服務提供的完整網址
使用者名稱	WebDAV 帳號
密碼	WebDAV 密碼或應用程式密碼
儲存目錄	預設 imgbed，也可以改成自己的目錄

大檔案處理方式

WebDAV 渠道目前使用真實工作階段式分段上傳。

小檔案會直接以完整檔案上傳；大於 64 MiB 的檔案會自動切成約 10 MiB 的分段，存到遠端分段目錄。

WebDAV 服務不需要支援 partial update 或 offset 寫入。ImgBed 不會在遠端合併成單一大檔，而是記錄分段清單，讀取時再依序組合回完整內容。

檔案大小	上傳方式	遠端儲存形式
64 MiB 以下	一般上傳	一個完整檔案
大於 64 MiB	分段上傳	分段目錄內多個 chunk 檔

分段目錄只影響遠端儲存結構，不會改變使用者拿到的 /file/... 連結。

新增完成後怎麼檢查

檢查項目	檢查方式
渠道卡片是否出現	儲存後，上傳設定頁應顯示 WebDAV 渠道
詳情是否正確	Endpoint、使用者名稱、儲存目錄等資訊正確
小檔案上傳	上傳測試圖片後，WebDAV 目錄裡看得到檔案
大檔案規則	大於 64 MiB 的檔案會走分段上傳並建立分段目錄
容量查詢	若服務支援容量資訊，查詢會顯示已用與總容量

常見問題

為什麼大檔案會產生分段目錄？

這是目前的大檔案儲存方式。檔案不會在遠端合併成單一大檔，而是由 ImgBed 記錄分段清單，存取時再讀取分段組合。

上傳失敗先檢查什麼？

先檢查 Endpoint、帳號、密碼和儲存目錄，再確認 WebDAV 服務允許建立目錄、寫入檔案和讀取檔案。

容量查詢失敗代表不能上傳嗎？

不一定。有些 WebDAV 服務不支援或限制容量資訊。只要小檔案上傳正常，通常仍可使用。

快速流程

準備 WebDAV Endpoint、帳號和密碼
-> 打開上傳設定
-> 新增渠道
-> 選 WebDAV
-> 填 Endpoint / 帳號 / 密碼
-> 儲存目錄預設 imgbed
-> 儲存
-> 查詢容量
-> 上傳測試圖片