> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/zh/xu-ni-ji/live-migrations.md).

# 实时迁移

VergeOS 中的热迁移可让您在不中断服务的情况下，在节点之间移动正在运行的虚拟机，并在存储层之间移动虚拟磁盘。

## 概述

### 虚拟机（VM）迁移

* 在保持服务运行的同时，在节点之间移动单个或多个正在运行的虚拟机
* 自动保留虚拟机状态、内存内容和活动连接
* 可选择自动节点选择，或指定目标节点
* 通过虚拟机仪表板实时监控迁移进度
* 支持单个虚拟机和批量虚拟机迁移

### 虚拟磁盘迁移

* 在虚拟机保持运行的同时，在不同存储层之间移动虚拟磁盘
* 通过自动 vSAN 修复流程无缝传输数据
* 在整个迁移过程中保持数据完整性和可访问性
* 支持通过在层之间移动驱动器来调整存储性能

这些功能是 VergeOS 基础设施管理的核心，可实现：

* 在不停机的情况下进行系统维护
* 资源优化
* 高可用性操作
* 存储性能调优

VergeOS 热迁移会自动管理资源分配、网络连接和存储同步，以确保在节点和存储层之间平稳过渡，同时保持工作负载可用。

{% hint style="info" %}
**VergeOS 会在以下情况自动处理虚拟机热迁移：**

* 系统更新
* 节点维护操作（维护模式）
  {% endhint %}

{% hint style="info" %}
**HA 事件**

在 HA 事件之后，VergeOS 会自动在其他可用节点上启动受影响的虚拟机。
{% endhint %}

## 前提条件

在执行任何热迁移之前，请确保：

* 目标节点上有足够的系统资源可用
* 磁盘迁移有足够的存储空间可用
* 您拥有执行迁移的适当权限
* 集群级别已启用嵌套虚拟化热迁移（如果使用嵌套虚拟机）
* 集群级别已启用 vGPU 热迁移（如果使用 vGPU 设备）

## 热迁移的集群配置

### 嵌套虚拟化热迁移

要为使用嵌套虚拟化运行的虚拟机启用热迁移：

1. 导航到 **集群 > \[集群名称] > 编辑**
2. 找到“允许嵌套虚拟化热迁移”设置
3. 勾选该复选框
4. 单击 **保存** 以应用更改

这允许启用了嵌套虚拟化的虚拟机在保持硬件加速的同时，在节点之间进行热迁移。

### vGPU 热迁移（实验性）

{% hint style="info" %}
**这仅适用于 VergeOS 4.13 或更高版本**
{% endhint %}

要为使用 vGPU 设备的虚拟机启用热迁移：

1. 导航到 **集群 > \[集群名称] > 编辑**
2. 找到“允许 vGPU 热迁移”设置
3. 勾选该复选框
4. 单击 **保存** 以应用更改

{% hint style="warning" %}
**vGPU 迁移注意事项**

* 此功能为实验性
* 如果目标节点上可用的 vGPU 设备不足，在维护期间工作负载可能会暂时关闭
* 确保目标节点具有兼容的 vGPU
  {% endhint %}

## 虚拟机热迁移

{% hint style="info" %}
**无法迁移的虚拟机**

附加了 GPU/PCI 直通、USB 直通和 SR-IOV 网卡的虚拟机无法进行热迁移。
{% endhint %}

### 单个虚拟机迁移

1. 导航到单个 **虚拟机仪表板**
2. 单击 **迁移** 在左侧菜单中
3. 选择您的迁移目标：
   * **自动** （默认）：系统选择最优目标节点
   * **指定节点**：手动选择目标节点
4. 单击 **迁移** 以开始该过程
5. 监控状态字段以查看迁移进度：
   * 完成后，状态将恢复为“运行中”
   * 主机节点字段将更新以显示新位置

### 多个虚拟机迁移

1. 导航到 **机器 > 虚拟机**
2. 选择所需的虚拟机（勾选标记表示已选中）
3. 单击 **迁移** 按钮
4. 选择您的目标选项：
   * **自动**：系统会将虚拟机分配到可用节点上
   * **指定节点**：选择目标节点（可能无法容纳所有虚拟机）
5. 监控每个虚拟机的状态列：
   * 迁移期间显示进度百分比
   * 完成后主机节点字段会更新

## 虚拟磁盘热迁移

### 在存储层之间移动驱动器

{% hint style="info" %}
**这仅适用于 VergeOS 4.13 或更高版本**
{% endhint %}

1. 访问驱动器设置：
   * 导航到虚拟机仪表板
   * 单击 **驱动器** 在左侧菜单中
   * 选择要迁移的驱动器
   * 单击 **编辑** 在左侧菜单中
2. 配置新层：
   * 从下拉菜单中选择所需的存储层
   * 单击 **提交** 以启动迁移
3. 监控迁移：
   * 等待新层上的 vSAN 修复完成
   * 在存储仪表板中查看修复状态
   * 验证驱动器在新层上可访问

{% hint style="warning" %}
**存储性能影响**

在迁移过程中，在层之间移动驱动器可能会暂时影响存储性能。
{% endhint %}

## 故障排除

### 常见问题及解决方案

1. **迁移失败**
   * 验证资源可用性
   * 检查网络连接
   * 查看系统日志
2. **迁移缓慢**
   * 检查网络带宽
   * 验证存储性能
   * 减少并发迁移
3. **迁移卡住**
   * 查看迁移日志
   * 检查资源限制
   * 如果问题持续，请联系支持

### 最佳实践

* 尽可能在低峰时段执行迁移
* 避免同时迁移过多虚拟机
* 在迁移期间监控系统资源
* 保持节点之间的网络路径优化
* 保持存储层有足够的可用空间


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/run-the-platform/zh/xu-ni-ji/live-migrations.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.