宝塔面板一键迁移数据
更换服务器（如从其他服务商迁入速维云，或更换节点）时，使用宝塔面板官方的迁移功能，可以在两台服务器之间直接传输网站、数据库与计划任务，无需手动打包搬运。宝塔官方提供两种迁移方式：
| 一键迁移 API 版 | 整机迁移 | |
|---|---|---|
| 功能入口 | 软件商店安装「宝塔一键迁移API版本」插件 | 面板【设置】→【整机迁移】 |
| 迁移内容 | 自选网站、数据库、计划任务 | 面板全部数据（可选范围，默认全部） |
| 目标机要求 | 已安装宝塔面板 6.9.8 及以上 | 全新 Linux 机器，无需预先安装面板 |
| 适用场景 | 只迁移部分站点 | 整站完整搬家 |
注意
迁移前请确认：目标机器上的已有数据会被覆盖，请使用全新机器或确认其上无重要数据；源机与目标机都以 root 身份操作；关闭宝塔防篡改等写入保护类功能，否则可能导致迁移失败。
前置准备
- 方式一要求两台服务器均已安装宝塔面板（方式二的目标机无需安装），尚未安装的参考宝塔面板安装教程。
- 在两台服务器的安全组中放行宝塔面板端口（默认 8888 或自定义端口）与 SSH 端口，参考安全组与系统防火墙入门。
- 确认磁盘空间充足。迁移通过压缩打包传输，源机与目标机都要预留足够空间：
df -Th # 查看磁盘空间
df -i # 查看 inode 是否充足方式一：一键迁移 API 版
适合只迁移部分网站、数据库或计划任务的场景。
源服务器安装迁移插件：登录源服务器宝塔面板，进入【软件商店】，搜索并安装宝塔一键迁移API版本。
目标服务器开启 API 接口：登录目标服务器面板，进入【设置】→【常用设置】，打开API接口开关。
配置接口密钥与 IP 白名单：单击API接口配置，复制接口密钥，并在 IP 白名单中填写源服务器的公网 IP（每行一个），保存。
提示
白名单中不添加源服务器 IP 会导致连接失败。若目标机之后重新生成过密钥，需在源机插件中同步更新。
源服务器填写目标机信息：打开源机上的迁移插件，按官方要求填写：
配置项 填写要求 面板地址 完整协议 + 目标 IP + 面板端口，如 http://123.45.67.89:8888，不可省略协议与端口API 密钥 上一步从目标机复制的接口密钥 IP 白名单 无需填写（已在前置步骤中于目标机配置） 
环境检测：单击下一步，插件会自动检测目标机的面板版本与依赖组件。若提示环境不完整，先在目标机安装缺失组件，再继续。
选择迁移内容：勾选需要迁移的网站（含站点配置与文件）、数据库（含数据与账号权限）与计划任务。
执行迁移：单击一键迁移，任务转入后台传输，可关闭插件窗口，不影响进度。
验证迁移结果：完成后登录目标机面板，逐项确认网站文件与配置、数据库实例与数据、计划任务是否与源机一致。
注意
传输期间请勿修改目标机的面板端口、重置 API 密钥，也不要删除或修改目标机上的同名站点与数据库；保持两台机器网络稳定，避免大流量任务占用带宽。
方式二：整机迁移
适合整站完整搬家到一台全新机器。在旧服务器的面板上操作，新机会自动安装面板并接收数据。
登录旧服务器宝塔面板，进入【设置】→【整机迁移】。
填写目标机器的 IP、SSH 端口与账号信息，选择密码认证或私钥认证。
提示
部分系统镜像默认账户不是 root，请使用 root 账号或先切换到 root 权限，面板安装依赖 root 权限。
选择要迁移的数据范围，默认迁移全部数据。
查看预计所需空间，确认目标机磁盘充足后继续。
单击开始迁移并等待完成。完成后页面会显示新机器的面板登录信息；旧机器上的数据不会被删除。
提示
【迁移记录】中可查看详细日志与新的面板登录信息，迁移失败时也可据此定位原因。整机迁移支持在不同 Linux 发行版之间进行，不支持迁移到 Windows 服务器。
迁移完成后
- 检查站点：逐个打开网站确认正常，重点检查伪静态规则、SSL 证书与数据库连接配置；若两台机器的 MySQL、PHP 等版本不一致，需按目标机版本调整程序兼容性。
- 切换解析：将域名解析指向新服务器 IP。建议在业务低峰期操作，并提前调小解析记录的 TTL 值以便快速生效，参考域名解析配置教程。
- 保留观察期：切换后旧服务器建议保留数天，确认业务稳定、无回退需要后，再在控制台退订或释放。
常见问题
提示目标面板连接失败
按顺序排查：
- 本地 ping 目标机 IP，确认网络连通（不通时优先检查安全组与防火墙）。
- 核对面板地址的协议、IP、端口是否完整正确，http 与 https 不要混淆。
- 确认使用的是目标机当前最新的 API 密钥。
- 确认目标机面板版本不低于 6.9.8，版本过低先升级面板。
- 确认目标机白名单中已添加源机 IP，注意区分公网 IP 与内网 IP。
- 以上均正常时，在软件商店对迁移插件执行【修复】后重试。
迁移过程中传输失败
进入迁移插件的【迁移日志】查看具体失败原因，常见为磁盘空间不足、网络中断，或目标机面板在传输期间被改动。
迁移后站点打开是默认页
目标机已存在同名站点目录或数据库，迁移数据未能覆盖。删除目标机上的同名站点及其数据库、配置文件后，重新执行迁移。
整机迁移后忘记面板登录信息
在旧机面板【设置】→【整机迁移】→【迁移记录】中可查看新机器的面板登录信息。