整机迁移

整机迁移功能适用于已使用宝塔面板的用户，将当前服务器的数据完整迁移至一台全新的服务器。迁移过程通过在新机器上安装面板、压缩并传输备份数据的方式完成。

注意： 迁移期间，若启用了写入保护类安全功能（如防篡改等），需提前关闭，否则可能导致迁移失败。

测试机器环境

• 操作系统：Debian 12
• 面板版本：11.6.0

功能介绍

进入面板【设置】→【整机迁移】，即可看到迁移界面：

迁移支持两种身份验证方式：密码验证和私钥验证。

迁移操作

1. 准备一台全新的目标机器，本次测试使用 Debian 12 操作系统。

2. 选择需要迁移的数据范围（默认迁移全部数据）。

   

3. 注意查看预计所需空间，确认目标机器磁盘空间充足后再继续。

   

   

4. 等待迁移完成。

   

5. 迁移成功后，页面将显示新机器的面板登录信息。

   

6. 可在【迁移记录】中查看详细日志；若迁移失败，也可通过迁移记录查看错误信息。

   

7. 若迁移后忘记面板登录信息，可在迁移记录中查看。

   

注意事项

1. 目标机器必须是全新机器：若目标机器已有数据，迁移过程中将被覆盖，请谨慎操作。

2. 仅支持 Linux 平台间迁移：目前不支持从 Linux 迁移到 Windows。

3. 确保磁盘空间充足：迁移通过压缩并传输的方式进行，源机器和目标机器均需预留足够空间。

   可通过以下命令检查磁盘状态：

   df -Th   # 查看磁盘空间
   df -i    # 查看 inode 是否充足

4. 必须使用 root 用户：部分云服务商默认提供的账户名称不是 root，需先将账户切换为 root 权限，因为宝塔面板的安装需要 root 用户权限。