體檢 （doctor）
概覽頁與 wp sss doctor 輸出同一份體檢：配置完整度、匿名讀可達性、簽名配置、上傳地址字首等，末尾附佇列狀態 （待傳 / 失敗 / 後臺任務 / 執行鎖） 。有阻斷項會明確寫出修法。
常用排障入口
- 工具 → 排障 → 掃描：最近一批附件的本地缺失、訪問域名不一致、 http 明文、失敗標記、字首不符。
- 診斷：貼一個裂圖地址，外掛給出判定鏈 （哪個環節改寫了地址、物件是否在桶） 。
- 抽檢遠端：按編號從新到舊抽最新進桶的 10 個附件做 HEAD，確認物件真的在。
- 操作記錄：最近 50 條上傳/失敗/刪除/拉回。
常見問題
前臺圖片 404
- 物件真的在桶裡嗎——用抽檢遠端確認
- 地址是桶域名還是本地？本地說明附件未進桶或已解除標記
- 開了簽名訪問？簽名過期會 403/404，頁面快取要短於簽名有效期
補傳一直失敗
- 看操作記錄裡的失敗原因：金鑰許可權、本地檔案缺失、檔案型別被排除
- 0 位元組的損壞檔案也能上傳 （0.9.1 起），如果仍失敗看具體報錯
- 連續失敗 3 次會退出佇列，修好後用 「重試失敗項」
點 「開始補傳」 立即結束
0.9.0 的一個缺陷會導致待傳佇列被誤清空 （已在 0.9.1 修復） 。確認你執行的是 0.9.1 或更高版本。
刪除遠端時報 「字首不符」
外掛的物件鍵帶字首保護：換了字首後拉回/刪除會拒絕操作舊字首物件，避免寫錯目錄。把外掛字首改回原值，或用廠商控制檯處理。
邊界與已知限制
- 多站點 （Multisite） 暫不支援，不要在網路層啟用。
- COS / OBS / 七牛的超大檔案上傳是單請求 （超時按體積放大）；百兆以上建議用 OSS / S3 相容廠商。
- 桶內物件沒有版本控制時刪除不可恢復——建議在雲控制檯開啟版本控制。