零基础也能学会：宝塔面板一键迁移网站全流程
如果你刚买了一台新服务器，想把旧服务器上的网站全部搬到新机上，宝塔面板官方提供的「一键迁移」插件是最省事的方案。
本文会手把手带你走完整个流程，从安装插件到验证成果，所有操作都基于宝塔面板图形界面，不需要写一行代码。
前置准备
在开始宝塔面板一键迁移网站之前，请先确认以下几项：
- 两台服务器都已安装宝塔面板（版本建议 7.9 以上）。旧服务器称为“源端”，新服务器称为“目标端”。
- 两端面板都已绑定宝塔账号（免费即可，用于认证）。
- 源端的网站数据、数据库、FTP 等已确认正常运行，确保迁移内容完整。
- 目标端的运行环境（Nginx、PHP、MySQL）已经安装好，版本最好与源端一致或兼容。
- 两台服务器防火墙允许互通端口：一键迁移默认使用端口
8888，需在宝塔安全中放行。
注意：迁移过程中源端网站可能会短时只读或被锁定，建议选择流量低谷期操作。
分步操作
整个宝塔面板一键迁移网站分为三个大阶段：安装插件 -> 配置目标端 -> 发起迁移。
下面一步步来。
1. 在目标端安装「一键迁移」插件
登录目标端宝塔面板 → 左侧菜单点击「软件商店」→ 搜索“一键迁移” → 点击「安装」。
安装成功后，会在面板顶部的“快捷工具”区域出现该插件图标。
# 无需命令，全程面板操作2. 获取目标端的迁移密钥
点击目标端面板上的「一键迁移」图标 → 进入插件首页 → 点击「设置」标签（或直接看到“生成迁移密钥”按钮）。
- 点击「生成迁移密钥」，系统会弹出一串类似
xxxx:yyyy的字符串。复制并保存好。 - 确认目标端服务器的 IP 地址。
3. 在源端发起迁移
回到旧服务器（源端）面板 → 同样打开「一键迁移」插件 → 选择「迁移网站」标签。
- 目标端 IP：填写新服务器的公网 IP。
- 密钥：粘贴刚才复制的密钥字符串。
- 选择需要迁移的网站：勾选你要搬走的网站（可多选）。
- 迁移选项：默认勾选数据库、配置、文件等，建议保持全选。
点击「开始迁移」，弹窗确认后开始执行。
过程中会显示进度条，迁移时间取决于网站数据量大小。
4. 等待完成
迁移完成后，面板会提示“迁移成功”。
此时登录目标端面板，你应该已经能在“网站”列表中看到刚才迁移过来的网站，数据库也一并创建好了。
避坑指南
- 密钥失效：生成的密钥有效期为 5 分钟，超时需要重新生成。如果粘贴时报错“密钥错误”，请回到目标端重新生成。
- 端口不通：若提示“连接目标服务器失败”，检查目标端宝塔面板的「安全」-「系统防火墙」中是否放行了
8888端口（或其他自定义端口）。 - 域名未解析：迁移后网站虽然配置好了，但域名解析仍指向旧服务器 IP。记得去 DNS 管理中将 A 记录改为新服务器 IP。
- 数据库版本不一致：例如旧服务器是 MySQL 5.6，新服务器是 MySQL 8.0，可能导致导入失败。建议提前统一版本，或使用 PHPMyAdmin 等方式导出导入。
- SSL 证书失效：如果源站有 Let's Encrypt 等自动证书，迁移后需要重新申请，因为证书绑定域名和 IP。
高频问题解答
- 问：一键迁移会覆盖目标端已有的网站吗？
- 答：如果目标端存在相同域名，迁移时不会直接覆盖，但会提示冲突，需要手动处理。建议在全新服务器上使用该功能。
- 问：迁移完成后源端网站还能正常访问吗？
- 答：可以，迁移不会修改源端数据。但为了数据一致性，建议迁移前暂时关闭源站写入操作。
- 问：网站文件很大怎么办？
- 答：一键迁移使用压缩传输，若文件超过 1GB，建议使用宝塔的「文件搬家」或手动
rsync。插件本身支持断点续传（默认开启）。 - 问：迁移后网站打不开怎么办？
- 答：先检查目标端 PHP 版本、伪静态设置、网站根目录是否与源端一致。然后查看网站日志（面板左侧“日志”-“错误日志”）定位原因。
效果验证
确认宝塔面板一键迁移网站已经成功完成，可以按以下步骤验证：
- 本地临时修改 hosts 文件（或直接通过 IP 访问），把网站域名指向新服务器 IP，打开浏览器访问网站。
- 检查首页、文章、产品页面是否正常加载，图片、CSS/JS 是否正确。
- 登录网站后台（如 WordPress、织梦等），查看文章、用户、设置是否完整。
- 查看目标端面板 → 左侧「数据库」→ 找到对应数据库，确认表数量和记录数是否与源端一致。
- 如果使用了 CDN，记得刷新 CDN 缓存或修改源站 IP 为新服务器。
至此，迁移工作全部完成。
你只需要等待 DNS 生效即可正式切换流量。
如果你正在处理宝塔面板一键迁移网站，建议先按本文步骤完整执行，再根据自己的环境做微调；
遇到异常时优先回看避坑和高频问题部分。
