在两台 WP Panel 之间搬家

什么时候可以使用网站搬家

网站搬家用于两台 WP Panel 服务器之间复制网站，支持 WordPress 和通用 PHP 网站，也可以一次选择多个网站。入口位于“网站管理”页面右上角。

• 两台服务器必须安装相同版本的 WP Panel。
• 只允许迁移当前处于“启用”状态的网站；暂停或异常网站要先恢复正常。
• 迁移后继续使用原主域名和别名，不支持在搬家过程中改域名。
• 接收服务器存在相同主域名或别名时会拒绝迁移，不会覆盖已有网站。
• 宝塔、手工环境和其他面板不在自动搬家范围内，应使用手工迁移。

搬家前准备

1. 把两台 WP Panel 都升级到相同版本。
2. 确认两台面板可以通过各自的 HTTPS 地址互相访问，系统时间基本一致。
3. 确认接收服务器没有同域名网站，并有足够空间存放临时数据和最终网站。
4. 选择业务低峰期。开始后源网站会显示 503 维护页，直到完成或取消搬家。
5. 提前规划 DNS 或 CDN 切换；面板不会自动修改或等待解析生效。

连接两台面板

1. 在接收服务器打开“网站搬家”，选择“我要接收网站”。
2. 生成一次性配对信息，并在有效期内复制到迁出服务器。
3. 在迁出服务器选择“我要迁出网站”，粘贴配对信息并连接。
4. 选择接收服务器和需要迁移的网站，运行预检。
5. 确认连接、版本、域名和空间检查都通过后，再点击“开始搬家”。

哪些内容会迁移

面板会迁移网站文件、数据库、域名与别名、SSL 证书、PHP 和 Nginx 运行配置、缓存设置、日志策略、监控、到期时间、WordPress 设置，以及可以安全复制的面板计划任务。

CDN 真实 IP 内置组可以一起使用。自定义组在接收服务器不存在时会创建；同名且内容一致时会复用；同名但内容不同时会停止该网站迁移，避免覆盖已有设置。

哪些内容不会迁移

• 网站和数据库的历史备份包。
• 访问日志、错误日志、监控记录和安全事件历史。
• 服务器级远程备份账号、密钥和 S3 凭据。
• 自定义命令类计划任务；页面会显示跳过数量，需要在新服务器手工重建。
• 原服务器上的站点 API Key；接收服务器会生成自己的站点身份和密钥，相关外部集成需要重新连接。

如果迁出服务器启用了全局远程备份，网站的自动备份策略不会直接复制到接收端，需要在新服务器重新配置。历史备份无论哪种情况都不会迁移。

迁移期间会发生什么

源网站会切换到不可缓存的 503 维护页，避免文章、订单、评论或其他数据继续变化。原来的监控、计划任务、更新和备份开关不会被改写，但相关写入任务在搬家期间不会执行。

接收服务器会分批接收和检查文件、恢复数据库、建立网站配置，再进行本机健康检查。文件很多或网络较慢时，维护时间会相应变长。

健康检查通过后，接收网站会立即成为正常启用的网站，并恢复计划任务和监控设置，不会等待 DNS 切换。因此在正式切换前，不要在接收端手工产生订单、文章等新数据。

健康检查能确认什么

WordPress 网站会检查程序能否启动、数据库能否连接、核心表和站点地址是否正常。所有网站还会从接收服务器本机访问首页，检查 Nginx、PHP 和明显的服务器错误。

这不代表公网访问、DNS、CDN、邮件、支付、第三方 API、队列程序或面板外服务一定正常。通用 PHP 网站使用的 Supervisor、Swoole、外部挂载和自建 systemd 服务也不会由网站搬家验证。

查看进度和处理失败

• 任务页面会自动刷新，显示当前步骤、已传输容量和速度；它不会给出不可靠的剩余时间。
• 多个网站分别处理，一个网站失败不会阻止其他网站。
• 出现“可以重试”时，优先使用任务上的重试按钮，不要另外创建同域名网站。
• 迁出端取消未完成任务时，会恢复源网站，并尽量通知接收端清理本次资源。
• 如果另一台服务器离线，远端清理可能无法立即完成。恢复连接后，应到接收服务器检查并删除遗留任务。
• 接收网站已经启用后，即使最后的计划任务同步暂时失败，也会保留网站等待重试，不会自动删除已经上线的站点。

迁移任务是临时工作记录。完成、失败或取消并清理后，任务会从列表消失，不作为长期迁移历史保存。

接收完成后的三个选择

接收服务器完成后，源网站仍保持维护状态，等待管理员逐个决定：

• 搬家完毕：结束任务并保留源站文件和数据库。源站显示“已搬家”，继续保持维护状态。
• 搬家完毕并删除源站：结束任务后进入普通网站删除流程，删除当前服务器上的源站。
• 搬家失败：只恢复当前迁出服务器上的源站，不依赖接收服务器在线，也不会自动删除接收服务器已经生成的网站或资源。

恢复已搬家的源站

选择“搬家完毕”后，如果需要重新启用源站，可在网站列表点击“恢复源站”，或在网站详情选择“解除维护模式，恢复为运行状态”。

恢复只处理当前服务器：切回正常网站配置并把状态改为启用。它不会检查 DNS，也不会访问或删除接收服务器上的网站。恢复后如需再次搬家，可以重新发起新任务。

文件和程序限制

• 指向网站目录外部的软链接、设备文件等特殊文件会被拒绝，避免读取或写入不属于该网站的内容。
• 文件内容和权限会迁移，但文件“最后修改时间”会变成接收端写入时间。依赖文件时间生成版本号或缓存的网站，搬家后应清理或重新生成缓存。
• 网站搬家只负责 WP Panel 管理的站点资源，不会复制面板外自建服务、系统任务或外部存储。

DNS 切换和最终检查

1. 在接收服务器检查前台、后台、SSL、数据库连接、固定链接、媒体和计划任务。
2. 检查邮件、表单、支付、第三方接口和业务关键流程。
3. 自行修改 DNS 或 CDN 回源地址，使域名指向接收服务器。
4. 从手机网络或其他真实用户网络确认访问已经到达新服务器。
5. 确认新站稳定后，再回迁出服务器选择保留、删除或恢复源站。