宝塔面板一键迁移网站，这六个步骤帮你轻松搬站（零基础版）
前置准备
使用宝塔面板的“一键迁移”功能前，需要确保以下条件满足，否则迁移过程中可能报错：
- 源服务器和目标服务器：两台服务器都必须安装宝塔面板，且版本尽量一致（建议都升级到最新版）。
- 同一账号登录：在宝塔面板后台使用同一账号（即官网注册的手机号或邮箱）登录，否则无法获取迁移插件。
- 插件准备：在宝塔面板左侧菜单点击
软件商店，搜索“宝塔一键迁移”，在两台服务器上都安装该插件（免费）。 - 防火墙放行端口：源服务器需要放行 8888 端口（默认迁移通信端口），可在宝塔安全面板中添加放行规则。
- 磁盘空间：目标服务器剩余磁盘空间必须大于源网站全部数据大小，建议留出 2GB 以上余量。
- 站点环境：目标服务器已经安装了与源网站相同的 Web 服务器（Nginx / Apache）和 PHP 版本，数据库版本保持一致可减少兼容性问题。
分步操作
以下操作均在宝塔面板后台完成，不需要任何命令行，复制粘贴即可。
第一步：在源服务器生成迁移密钥
- 登录源服务器宝塔面板，左侧点击
软件商店→已安装，找到“宝塔一键迁移”插件，点击设置。 - 选择“我是迁移源”（即要搬走数据的服务器），点击 生成密钥。
- 复制显示的一串密钥（例如
qianyi_xxxxxxxxxxxx），并记录下源服务器的公网 IP 地址。
密钥有效期为 30 分钟，如果超时需要重新生成。
第二步：在目标服务器添加迁移任务
- 登录目标服务器宝塔面板，同样打开“宝塔一键迁移”插件，选择“我是迁移目标”。
- 填写源服务器的 公网 IP 地址 和刚才复制的 密钥，点击 验证连接。
- 如果连接成功，会列出源服务器上所有站点。勾选你要迁移的网站（可以多选），然后点击 开始迁移。
第三步：等待数据同步
- 系统会自动打包网站文件（默认压缩为
.tar.gz）、导出数据库 SQL，通过 HTTP 传输到目标服务器并解压。 - 迁移进度条会显示百分比，不要关闭浏览器页面或刷新，直到显示“迁移完成”。
- 如果网站文件较大（超过 1GB），迁移时间可能较长，建议在业务低峰期操作。
第四步：检查目标服务器的站点配置
迁移完成后，宝塔插件会自动创建同名站点并绑定域名。
你可以在目标宝塔面板的 网站 列表中看到新增的站点。
- 域名解析：如果还未修改 DNS，请先不要删除源服务器上的网站，确保旧域名指向目标服务器 IP。
- PHP 版本：进入站点设置 →
PHP 版本，检查是否与源服务器一致，若不一致请手动切换。
避坑指南
🚫 常见错误：连接失败
- 检查源服务器防火墙是否开了 8888 端口（宝塔安全 → 添加端口规则）。
- 密钥是否过期（重新生成）。
- 源服务器面板是否开启了“禁止海外访问”或 IP 白名单限制。
🚫 迁移后网站打开报 500 错误
- 大概率是 PHP 版本或扩展模块不一致。在目标站点设置中，点击“PHP 版本”切换为与源站相同的版本。
- 如果使用了伪静态规则，在目标站点设置 →
伪静态重新选择或粘贴源站规则。
🚫 数据库连接失败
- 迁移工具会保留数据库名、用户名和密码，但如果目标服务器已有同名数据库，可能会被覆盖。建议迁移前清空目标服务上不需要的旧数据库。
- 检查
wp-config.php（WordPress）或.env（Laravel）中的数据库配置是否正确。
🚫 证书未迁移
- 一键迁移不包含 SSL 证书文件。请在目标服务器站点设置 →
SSL中重新申请 Let‘s Encrypt 证书或上传原有证书。
高频问题解答
Q1：迁移过程中网站还能正常访问吗？
迁移操作是读取源服务器文件并复制到目标服务器，不会修改源服务器数据，因此源网站正常运行不受影响。
Q2：迁移后源服务器上的数据可以删除吗？
建议等域名解析完全生效（TTL 时间过后）且目标站点无异常时再清理源服务器数据，通常等待 24-48 小时。
Q3：一次可以迁移多个网站吗？
可以。在目标服务器端勾选多个站点即可，插件会逐个迁移。注意磁盘空间要足够。
Q4：迁移后网站内容是否完整？
插件会完整打包网站文件（包括上传目录、主题、插件）和数据库，内容一般不会丢失。但自定义的定时任务、守护进程、SSL 证书、伪静态规则等需要手动迁移。
Q5：如果迁移到一半失败了怎么办？
在目标服务器上删除已创建的站点和数据库，重新执行整个迁移流程。源服务器数据不受影响。
效果验证
- 修改本地 hosts 文件：临时将域名指向目标服务器 IP，在浏览器中访问网站，确认页面正常加载，数据库查询正常（如登录后台、查看文章）。
- 检查关键页面：访问首页、文章页、商品详情页、后台管理页，确保无 404、500 错误。
- 功能测试：提交一个表单、发送一封测试邮件（如果有）、清空缓存后刷新。
- 确认日志无错误：在目标宝塔面板
网站→ 对应站点 →日志中查看最近访问日志和错误日志。
如果一切正常，再去域名解析处将 A 记录修改为目标服务器 IP，等待生效后即可彻底完成网站搬家。
