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=...