WP-CLI 命令手冊

命令列適合批次操作與自動化,不經過頁面快取與閘道器超時。所有命令以 wp sss 開頭。

命令 作用
wp sss status 配置概覽 (不回顯金鑰):廠商、桶、區域、開關狀態
wp sss doctor 體檢:配置、匿名讀、簽名、警告項 + 佇列狀態一行
wp sss probe 連通測試:寫入並刪除一個臨時物件
wp sss set --bucket=... --region=... --access-key-id=... --access-key-secret=... 配置;–from-env 從 env 檔案讀金鑰避免進 shell 歷史
wp sss offload [--limit=N] [--id=ID] [--source=failed] [--dry-run] [--before=ID] 補傳;–source=failed 只重試失敗項
wp sss pull [--limit=N] [--id=ID] [--on-exist=rename|overwrite] [--dry-run] [--before=ID] [--delete-remote --yes] 拉回;刪桶必須 –yes
wp sss url < 附件 ID> 看某個附件當前對外的桶地址
wp sss rewrite [--from=URL --to=URL] [--apply] 地址改寫;預設只預覽
wp sss copy --to-bucket=... [--to-driver/--to-region/--to-endpoint/--to-ak/--to-sk/--to-prefix] [--limit] [--before] [--dry-run] [--update-keys --yes] 桶間/廠商間搬運
wp sss upload < 本地檔案> [--key=物件鍵] 把伺服器上的檔案進桶 (第三方落盤檔案)
wp sss scan / wp sss diagnose <URL> 掃描最近附件狀態 / 診斷單個地址
wp sss delete < 物件鍵> --yes 只刪桶內物件;引數是物件鍵 (不是附件 ID),不會動媒體庫附件。附件的完整物件鍵見媒體庫附件側欄或 wp sss diagnose

env 檔案格式 (--from-env):

WPSSS_OSS_BUCKET=demo
WPSSS_OSS_REGION=oss-cn-hangzhou
WPSSS_OSS_ACCESS_KEY_ID=LTAI...
WPSSS_OSS_ACCESS_KEY_SECRET=...