跳至内容

WP-CLI

WP-CLI 参考（Pro）

从 shell 自动执行备份、恢复、导入、安装程序部署、灾难恢复和暂存。与 Multisite Migrate 管理 UI 完全一致 — 除帮助之外的每个命令都需要Pro许可证。

要求

  • WP-CLI installed on the server (or SSH session).
  • Multisite Migrate plugin active; run commands from the WordPress root (wp must load the site).
  • 专业许可证 — every command except help requires Multisite Migrate Pro. Plus and Free licenses cannot use WP-CLI.
  • WordPress capability: manage_options (single site) or manage_network (multisite network tasks).

开始使用

wp multisite-migrate help
wp multisite-migrate help --topic=restore
wp multisite-migrate backup --help
wp multisite-migrate list

help prints a full command tree, capability notes, and copy-paste examples. Use --topic=backup|restore|import|jobs|installer|recovery|staging|caps to filter sections. Per-command flags are documented with native WP-CLI --help.

命令树

命令目的
backup运行备份作业（本地和可选的云上传）
restore <job-id>使用拓扑选项进行同一服务器恢复或 URL 迁移
import从磁盘、URL 或云注册存档；可选的链式恢复
list列出已完成的备份或恢复作业
status <job-id>作业进度、百分比和元数据
cancel <job-id>取消正在运行的作业
delete <job-id>删除作业记录和本地存档（如果存在）
prefetch <job-id>恢复前下载仅云备份
manifest <job-id>打印存档清单 JSON
migration-preview <job-id>预览迁移的 URL 和表映射
info插件版本、引擎和许可证摘要
healthPHP 扩展、磁盘空间、存储路径
cleanup删除临时导入和工作文件
prune将保留策略应用于旧的本地备份
installer在备份旁边部署安装程序或下载引导 PHP
recovery设置、启动或重置灾难恢复点
list-remote <channel>列出远程备份（gdrive、s3、sftp、dropbox）
staging创建、删除或推送到暂存子网站
help在终端中打印此引用

备份

wp multisite-migrate backup
wp multisite-migrate backup --upload --destination=gdrive
wp multisite-migrate backup --scope=network --profile=full
wp multisite-migrate backup --scope=subsite --profile=db --incremental

Common flags: --upload, --destination=local|gdrive|s3|sftp|ftp|dropbox, --scope=network|subsite, --profile=full|db|files|media|plugins|themes|custom, --incremental, --quiet.

云上传需要配置Plus/Pro云存储 云存储。网络范围可供网络管理员在 Free+ 上使用；子站点管理网络作业仍然遵循席位/能力规则。

恢复

wp multisite-migrate restore 42 --yes
wp multisite-migrate restore 42 --mode=db --no-safety-snapshot
wp multisite-migrate restore 42 --migration --old-url=https://old.example --new-url=https://new.example --yes

拓扑标志与管理界面中的多站点恢复一致：

  • --topology-import=subsite_on_network + --topology-target-url=… — 将子站点备份导入现有网络
  • --topology-import=network_to_subsite + --topology-target-blog-id=… — 将网络备份导入子站点槽位
  • --prefix-policy=keep_source|remap_wp, --blog-domains=<json>, --passphrase=…（用于 .venc）
  • 共享用户合并（两种网络落地模式默认开启）：--user-merge / --no-user-merge, --uid-fields=_customer_user,_other_meta, --reset-imported-passwords, --send-password-reset-email
wp multisite-migrate restore 42 --topology-import=subsite_on_network --topology-target-url=https://network.example/site/ --user-merge --uid-fields=_customer_user --yes

长时间恢复会显示进度条。除非使用 --no-safety-snapshot，否则会运行安全快照。使用 --yes 可跳过覆盖确认。

进口

wp multisite-migrate import /var/backups/site.zip
wp multisite-migrate import --url=https://cdn.example/backup.zip
wp multisite-migrate import --from=gdrive --remote-id=FILE_ID --name=site.zip
wp multisite-migrate import /path/archive.zip --restore --via-worker --yes

Remote URL and cloud channels require Pro (CAP_REMOTE_IMPORT). Chain --restore to start restore immediately; add --via-worker for in-plugin restore instead of installer deploy.

岗位管理

wp multisite-migrate list --type=backup --format=table --limit=50
wp multisite-migrate status 42
wp multisite-migrate cancel 42
wp multisite-migrate delete 42
wp multisite-migrate manifest 42
wp multisite-migrate migration-preview 42

list supports --format=table|json|csv. Subsite admins on multisite see only their scope unless they have network cap.

安装人员及空服务器

wp multisite-migrate installer 42
wp multisite-migrate installer 42 --bridge
wp multisite-migrate installer 下载 --type=php
wp multisite-migrate installer 下载 42 --type=php

部署相同的向导 导入 → 打开安装程序. --bridge uses wp-admin MU-plugin proxy when archives are protected. 下载 writes bootstrap PHP beside your shell (Pro CAP_INSTALLER).

See also 空服务器迁移.

灾难恢复

wp multisite-migrate recovery set --job-id=42
wp multisite-migrate recovery status
wp multisite-migrate recovery launch
wp multisite-migrate recovery reset

火柴 备份→恢复: in-place overwrite from a pinned full backup with WordPress core. Disable site-wide with define('MM_DISALLOW_RECOVERY', true); in wp-config.php.

Staging

wp multisite-migrate staging create --slug=staging --title="Staging"
wp multisite-migrate staging delete --slug=staging
wp multisite-migrate staging push --job-id=42

Requires Pro CAP_STAGING. Same flows as 恢复指南中的 Staging.

维护保养

wp multisite-migrate info
wp multisite-migrate health
wp multisite-migrate cleanup
wp multisite-migrate prune
wp multisite-migrate list-remote gdrive

许可能力

在 Pro 门之后，各个命令可能需要辅助功能（与管理 UI 相同）：

能力CLI 示例
CAP_CLIAll commands except help — Pro only
CAP_CLOUDbackup --upload, prefetch, list-remote
CAP_REMOTE_IMPORTimport --url, import --from=*
CAP_MULTISITE需要多站点功能门的网络范围管理流程（请参阅 CLI 帮助）
CAP_INSTALLERinstaller 下载
CAP_STAGINGstaging *
CAP_NETWORK_SPLITsplit-network, split-status, split-cancel, split-resume, restore --topology-import=extract_site_standalone

对比方案

场景食谱

场景命令
子站点 → 独立迁移wp multisite-migrate restore <id> --migration --old-url=… --new-url=… --yes
分割网络 → 每个站点存档wp multisite-migrate split-network --yes then split-status — see 网络拆分指南
恢复失败的拆分wp multisite-migrate split-resume --yes then split-status
网络存档 → 一个站点独立wp multisite-migrate restore <id> --migration --topology-import=extract_site_standalone --source-blog-id=N --old-url=… --new-url=… --yes then migration-verify
验证剩余的 URLwp multisite-migrate migration-verify --old-url=…
确认搜索替换wp multisite-migrate search-replace --old=… --new=… --yes
子站点→现有网络（合并用户）wp multisite-migrate restore <id> --topology-import=subsite_on_network --topology-target-url=… --user-merge --yes
网络→子站点槽（合并用户）wp multisite-migrate restore <id> --topology-import=network_to_subsite --topology-target-blog-id=… --user-merge --yes
无需用户合并的网络导入wp multisite-migrate restore <id> --topology-import=subsite_on_network --topology-target-url=… --no-user-merge --yes
合并用户+重置密码wp multisite-migrate restore <id> --topology-import=subsite_on_network --topology-target-url=… --user-merge --reset-imported-passwords --send-password-reset-email --yes
导入然后安装程序wp multisite-migrate import /path/backup.zip --restore
导入然后在插件中恢复wp multisite-migrate import /path/backup.zip --restore --via-worker --yes
仅云备份 → 恢复wp multisite-migrate prefetch <id> then wp multisite-migrate restore <id> --yes
部署安装程序（桥接）wp multisite-migrate installer <id> --bridge
灾难恢复点wp multisite-migrate recovery set --job-id=<id> then recovery launch

全球旗帜

  • --quiet — suppress progress messages on long jobs
  • --porcelain — machine-readable progress lines

WP-CLI 常见问题解答

Shell 自动化需要 Pro。使用服务器上的帮助来获取实时命令列表。

WP-CLI 需要哪个许可证？?

亲。 Free 和 Plus 无法运行 Multisite Migrate WP-CLI 命令（查看可用帮助除外）。

我应该在哪里运行 wp 命令？?

WP-CLI 从 WordPress 根加载该网站。Multisite Migrate 插件必须处于活动状态。

我可以通过 CLI 自动执行计划吗？?

在 Pro 上是的 - 备份、恢复、导入、安装程序、恢复和 Staging 命令镜像管理 UI。请参阅上面的食谱部分。

通过 WP-CLI 恢复到网络时如何合并用户？?

使用--topology-import=subsite_on_network 或network_to_subsite。共享用户合并默认开启；根据需要传递 --no-user-merge 来跳过，或传递 --uid-fields 和 --reset-imported-passwords 。请参阅上面的恢复部分和食谱。

如果我只使用 WP-CLI，14 天退款是否适用？?

是的。无论您喜欢管理 UI 还是 WP-CLI，新购买的 Plus 或 Pro 都包含 14 天退款保证。