L实例之间的数据迁移
操作场景
如果您需要将L实例已部署的业务迁移到同一账号下的另外一台L实例上，您可以参考本文档操作。L实例间的数据迁移分为以下两种场景：
- 同区域迁移：在同一区域内，将一台L实例上的业务迁移到另一台L实例。适用于实例规格变更、业务重组等场景。
- 跨区域迁移：将一个区域的L实例业务迁移到另一个区域的L实例。适用于异地灾备、业务就近接入等场景。
本文将介绍如何将源实例中已部署的业务迁移至目标实例上，其中源实例以Linux可视化宝塔面板应用镜像为例，目标实例以Docker可视化Portainer应用镜像为例。
- 源实例和目标实例可以是任意支持创建镜像和切换镜像的L实例。
- 部分应用镜像（如OpenClaw、Dify、Hermes应用镜像），L实例控制台提供了可视化的“应用详情”、“模板应用”等配置界面。迁移后，目标实例的磁盘上会包含源镜像的应用详情和模板数据（为迁移时的快照数据），但由于目标实例的产品元数据与源镜像不匹配，目标实例将无法使用L实例提供的“应用详情”界面管理应用，也无法再新增模板。
| 迁移类型 | 源实例 | 目标实例 | 关键操作 |
| 同区域迁移 | Linux可视化宝塔面板L实例 | 同区域的其他L实例（如Docker可视化Portainer） | 创建源实例的私有镜像 → 目标实例切换镜像 |
| 跨区域迁移 | Linux可视化宝塔面板L实例 | 目标区域的其他L实例（如Docker可视化Portainer） | 创建源实例的私有镜像 → 复制镜像至目标区域 → 目标实例切换镜像 |
约束与限制
- 本文的迁移示例中，仅支持切换系统盘镜像的方式。
- 目标实例的系统盘容量必须大于或等于私有镜像要求的最小系统盘容量。如果目标实例系统盘容量不足，需先升级实例规格后再执行切换。
- 目标实例的启动方式（BIOS/UEFI）必须与私有镜像的启动方式一致，否则切换将失败。
- Dify应用镜像不支持切换镜像操作，不能作为目标实例。
前提条件
操作步骤
请根据实际迁移需求，选择同区域或者跨区域的数据迁移。
- 在源实例上创建私有镜像
- 登录Flexus应用服务器L实例控制台。
- 单击源实例资源卡片的
按钮，单击“创建私有镜像”。 - 在创建私有镜像页面的“镜像类型和来源”中参考下表配置。
表1 镜像类型和来源 参数
示例
说明
区域
华北-北京四
Flexus L实例与所创建的镜像属于同一个区域。
创建方式
创建私有镜像
请保持默认配置“创建私有镜像”。
镜像类型
系统盘镜像
创建系统盘私有镜像，镜像中将包含宝塔面板应用及其系统盘上的业务数据。请务必选择"系统盘镜像"类型，否则该镜像将无法用于后续切换镜像操作。
选择镜像源
hcss_ecs_xxxx
选择待创建镜像的Flexus L实例的云主机，系统将自动为您配置，请保持默认配置。
- 在“配置信息”中，按需参考下表配置。
表2 配置信息 参数
示例
说明
加密
未加密
镜像的加密属性，不可更改。
- 使用未加密的云主机创建的私有镜像为未加密的私有镜像。
- 使用加密的云主机创建的私有镜像为加密的私有镜像。
名称
bt_test
设置一个便于您识别的镜像名称。
- 名称的长度范围为1～128个字符。
- 名称的首尾字母不能为空格。
- 名称可以包含以下字符：
- 大写字母
- 小写字母
- 数字
- 特殊字符包含短横线（-）、点（.）、下划线（_）、空格和中文。
企业项目
default
从下拉列表中选择所在的企业项目。该参数针对企业用户使用，只有开通了企业项目的客户，或者权限为企业主账号的客户才可见。如需使用该功能，请联系您的客户经理申请开通。
企业项目是一种云资源管理方式，企业项目管理服务提供统一的云资源按项目管理，以及项目内的资源管理、成员管理。
标签
-
可选参数，为镜像设置标签键和标签值，便于识别和管理。
描述
-
可选参数，对镜像进行描述。
更多关于创建私有镜像的详细操作指引，请参见创建Flexus L实例的私有镜像。
- 阅读并勾选协议，单击“下一步”根据界面提示完成操作。
创建镜像后，您可以在镜像服务私有镜像列表查看镜像创建的进度，当镜像状态为“正常”时，表示镜像创建完毕。
创建系统盘镜像的耗时取决于系统盘数据量大小。请在创建期间不要对源实例执行重启或关机操作。
- 在目标实例上切换镜像
- 登录Flexus应用服务器L实例控制台。
- 在需要切换镜像的目标L实例（如Docker可视化Portainer实例）的资源卡片上，单击
按钮，单击“切换镜像”。 - 进入切换镜像页面，在镜像选择区域，切换至"私有镜像"页签。
- 在下拉列表中选择已创建的宝塔面板私有镜像。
如果私有镜像在下拉列表中显示为灰色不可选，请将鼠标悬停在镜像名称上查看提示信息。具体原因和解决方法请参见常见问题。
- 确认镜像费用信息，阅读并勾选同意相关协议。
- 单击"立即切换"按钮。在弹窗中，输入"YES"确认切换。
- 系统将跳转到支付页面（如产生费用），完成支付后切换操作开始执行。切换过程中实例将自动关机并重启，请确保无正在进行的业务操作。
- 切换完成后，实例将自动开机。当实例状态为"运行中"且镜像信息为宝塔面板私有镜像时，表示切换镜像成功。
- 验证迁移结果 登录宝塔面板，检查已创建的网站、数据库等数据是否存在且可正常访问。
- 如果您的宝塔镜像是旧版（2026年8月11日之前购买），请使用地址http://目标实例的公网IP:8888，访问宝塔面板。
- 如果您的宝塔镜像是新版，请远程登录目标实例，执行如下命令获取宝塔面板的访问地址。
bt default
- 切换镜像后，目标实例的原有登录密码将失效，请重置密码后再登录实例。
- 部分应用镜像（如OpenClaw、Dify、Hermes应用镜像），L实例控制台提供了可视化的“应用详情”、“模板应用”等配置界面。迁移后，目标实例的磁盘上会包含源镜像的应用详情和模板数据（为迁移时的快照数据），但由于目标实例的产品元数据与源镜像不匹配，目标实例将无法使用L实例提供的“应用详情”界面管理应用，也无法再新增模板。
- 在源实例上创建私有镜像
- 登录Flexus应用服务器L实例控制台。
- 单击源实例资源卡片的按钮，单击“创建私有镜像”。
- 在创建私有镜像页面的“镜像类型和来源”中参考下表配置。
表3 镜像类型和来源 参数
示例
说明
区域
华北-北京四
Flexus L实例与所创建的镜像属于同一个区域。
创建方式
创建私有镜像
请保持默认配置“创建私有镜像”。
镜像类型
系统盘镜像
创建系统盘私有镜像，镜像中将包含宝塔面板应用及其系统盘上的业务数据。请务必选择"系统盘镜像"类型，否则该镜像将无法用于后续切换镜像操作。
选择镜像源
hcss_ecs_xxxx
选择待创建镜像的Flexus L实例的云主机，系统将自动为您配置，请保持默认配置。
- 在“配置信息”中，按需参考下表配置。
表4 配置信息 参数
示例
说明
加密
未加密
镜像的加密属性，不可更改。
- 使用未加密的云主机创建的私有镜像为未加密的私有镜像。
- 使用加密的云主机创建的私有镜像为加密的私有镜像。
名称
bt_test
设置一个便于您识别的镜像名称。
- 名称的长度范围为1～128个字符。
- 名称的首尾字母不能为空格。
- 名称可以包含以下字符：
- 大写字母
- 小写字母
- 数字
- 特殊字符包含短横线（-）、点（.）、下划线（_）、空格和中文。
企业项目
default
从下拉列表中选择所在的企业项目。该参数针对企业用户使用，只有开通了企业项目的客户，或者权限为企业主账号的客户才可见。如需使用该功能，请联系您的客户经理申请开通。
企业项目是一种云资源管理方式，企业项目管理服务提供统一的云资源按项目管理，以及项目内的资源管理、成员管理。
标签
-
可选参数，为镜像设置标签键和标签值，便于识别和管理。
描述
-
可选参数，对镜像进行描述。
更多关于创建私有镜像的详细操作指引，请参见创建Flexus L实例的私有镜像。
- 阅读并勾选协议，单击“下一步”根据界面提示完成操作。
创建镜像后，您可以在镜像服务私有镜像列表查看镜像创建的进度，当镜像状态为“正常”时，表示镜像创建完毕。
创建系统盘镜像的耗时取决于系统盘数据量大小。请在创建期间不要对源实例执行重启或关机操作。
- 复制镜像到目标区域
将上一步创建的私有镜像从源区域复制到目标区域，使目标区域的L实例可以使用该镜像。跨区域复制镜像支持的区域及操作约束详情请参见跨区域复制镜像。
- 登录IMS控制台。
- 在私有镜像列表中，在需要复制的镜像所在行，单击操作列下的“更多 > 复制”。
- 在“复制镜像”对话框中，复制类型选择“跨区域复制”，目标区域选择目标L实例所在区域，其余参数请按实际情况填写。
- 单击“确定”，切换到目标区域的私有镜像页面，待镜像状态变为“正常”时，表示复制成功。
跨区域复制镜像的耗时取决于镜像容量和网络带宽，请在业务低峰期执行。
- 在目标实例上切换镜像
- 登录Flexus应用服务器L实例控制台。
- 在需要切换镜像的目标L实例（如Docker可视化Portainer实例）的资源卡片上，单击按钮，单击“切换镜像”。
- 进入切换镜像页面，在镜像选择区域，切换至"私有镜像"页签。
- 在下拉列表中选择已创建的宝塔面板私有镜像。
如果私有镜像在下拉列表中显示为灰色不可选，请将鼠标悬停在镜像名称上查看提示信息。具体原因和解决方法请参见常见问题。
- 确认镜像费用信息，阅读并勾选同意相关协议。
- 单击"立即切换"按钮。在弹窗中，输入"YES"确认切换。
- 系统将跳转到支付页面（如产生费用），完成支付后切换操作开始执行。切换过程中实例将自动关机并重启，请确保无正在进行的业务操作。
- 切换完成后，实例将自动开机。当实例状态为"运行中"且镜像信息为宝塔面板私有镜像时，表示切换镜像成功。
- 验证迁移结果 登录宝塔面板，检查已创建的网站、数据库等数据是否存在且可正常访问。
- 如果您的宝塔镜像是旧版（2026年8月11日之前购买），请使用地址http://目标实例的公网IP:8888，访问宝塔面板。
- 如果您的宝塔镜像是新版，请远程登录目标实例，执行如下命令获取宝塔面板的访问地址。
bt default
- 切换镜像后，目标实例的原有登录密码将失效，请重置密码后再登录实例。
- 部分应用镜像（如OpenClaw、Dify、Hermes应用镜像），L实例控制台提供了可视化的“应用详情”、“模板应用”等配置界面。迁移后，目标实例的磁盘上会包含源镜像的应用详情和模板数据（为迁移时的快照数据），但由于目标实例的产品元数据与源镜像不匹配，目标实例将无法使用L实例提供的“应用详情”界面管理应用，也无法再新增模板。
相关操作
- 切换镜像后，原密码会失效，如需登录云主机，请先设置Flexus L实例的密码。更多详情请参见重置Flexus L实例密码。
- Flexus L实例云主机的登录方式请参见登录方式概述。
- 迁移完成后，宝塔面板使用的公网IP由源实例变更为目标实例，如果源实例的公网IP添加并解析了域名，请在目标实例中重新添加并解析域名。更多信息请参见为Flexus L实例添加并解析域名。
常见问题
为什么Dify实例的操作菜单中没有"切换镜像"选项？
问题现象：
Dify应用镜像L实例的操作菜单中，"切换镜像"选项不可用或不存在。
问题原因：
Dify应用镜像当前不支持切换为其他镜像。因此，Dify实例只能作为数据迁移的源端（支持创建镜像），不能作为目标端（不支持切换镜像）。
解决方法：
请在另一台非Dify镜像的L实例上执行切换镜像操作，将该实例切换为Dify私有镜像。
创建的私有镜像在切换镜像时显示为灰色不可选？
问题现象：
在切换镜像页面的私有镜像下拉列表中，创建的镜像显示为灰色，无法选择。
问题原因及解决方法：
| 提示信息 | 原因 | 解决方法 |
| 不支持选择整机镜像，建议使用主机迁移功能。 | 创建镜像时选择了“整机镜像”"而非“系统盘镜像”。 | 重新创建私有镜像，创建方式选择“系统盘镜像”。 |
| 不支持选择该收费镜像，建议使用主机迁移功能。 | 私有镜像来源于云商店收费镜像。 | 使用非收费镜像作为基础创建私有镜像，或使用主机迁移服务。 |
| 当前Windows私有镜像不是由华为云云商店Windows镜像所创建的，无法选择。建议使用主机迁移功能。 | Windows私有镜像来源不符合要求。 | 使用华为云云商店Windows镜像创建私有镜像。 |
| 该镜像未安装重置密码插件或缺少onekey_resetpasswd特性标签。 | 私有镜像未安装重置密码插件。 | 参考镜像服务文档，为镜像安装重置密码插件后重新使用。 |
| 当前实例的系统盘容量（XGiB）小于该镜像系统盘容量（YGiB），无法切换，请升级实例规格后再切换。 | 目标实例的系统盘容量小于私有镜像要求的最小容量（min_disk）。 | 先升级目标实例的规格（增大系统盘容量），再执行切换镜像。 |
切换镜像失败怎么办？
问题现象：
执行切换镜像操作后，提示“当前实例暂不支持切换镜像，请联系客服人员处理”。
问题原因：
可能原因包括：镜像订阅关系不存在（CBC.6034错误）、启动方式不匹配、实例状态异常等。
解决方法：
1. 检查实例状态是否为“运行中”或“关机”。如果实例处于其他状态（如迁移中），请等待状态恢复后重试。
2. 检查私有镜像的启动方式（BIOS/UEFI）是否与目标实例一致。如不一致，请使用相同启动方式的镜像。
3. 如问题仍然存在，请提交工单。
切换镜像后无法登录实例怎么办？
问题现象：
切换镜像完成后，使用原有密码无法通过SSH登录目标实例。
问题原因：
切换镜像后，原有登录密码将失效，需手动重置密码后方可登录。
解决方法：
为L实例重置密码，请参见重置Flexus L实例密码。
迁移后目标实例能否使用源镜像的"应用详情"和"模板应用"功能？
问题现象：
迁移完成后，目标实例上无法使用"应用详情"功能，也无法新增模板应用。
问题原因：
部分应用镜像（如OpenClaw、Dify、Hermes应用镜像），L实例控制台提供了可视化的“应用详情”、“模板应用”等配置界面。迁移后，目标实例的磁盘上会包含源镜像的应用详情和模板数据（为迁移时的快照数据），但由于目标实例的产品元数据与源镜像不匹配，目标实例将无法使用L实例提供的“应用详情”界面管理应用，也无法再新增模板。
解决方法：
迁移后的应用详情和模板数据为快照数据。如需管理应用详情和模板，请在源实例上进行操作。
