# 宝塔面板整机迁移教程

> 使用宝塔面板（BT Panel）整机迁移功能，将现有服务器的面板、网站、数据库、计划任务与存储数据完整迁移至一台新服务器，适用于云主机替换、换云、升配场景。

原文：[宝塔面板整机迁移教程](https://docs.bt.cn/practical-tutorials/server-migration)

文档范围：宝塔面板及相关产品（当前文档）。生成时间：2026-09-22。

## 整机迁移

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

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

## 测试机器环境

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

## 功能介绍

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

![整机迁移功能入口](https://docs.bt.cn/img/practical-tutorials/server-migration/image-20260326094146370.png)

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

![选择迁移验证方式](https://docs.bt.cn/img/practical-tutorials/server-migration/image-20260326094245360.png)

## 迁移操作

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

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

   ![选择迁移数据范围](https://docs.bt.cn/img/practical-tutorials/server-migration/image-20260326140313406.png)

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

   ![查看预计所需空间](https://docs.bt.cn/img/practical-tutorials/server-migration/image-20260326143857596.png)

   ![填写目标机器信息](https://docs.bt.cn/img/practical-tutorials/server-migration/image-20260326143926405.png)

4. 等待迁移完成。

   ![迁移进行中](https://docs.bt.cn/img/practical-tutorials/server-migration/image-20260326140610347.png)

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

   ![迁移成功，显示登录信息](https://docs.bt.cn/img/practical-tutorials/server-migration/image-20260326144005231.png)

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

   ![查看迁移记录和日志](https://docs.bt.cn/img/practical-tutorials/server-migration/image-20260326144030021.png)

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

   ![从迁移记录中查看面板登录信息](https://docs.bt.cn/img/practical-tutorials/server-migration/image-20260326144101945.png)

## 注意事项

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

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

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

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

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

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