> 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/knowledge-base/zh/virtual-machines/importing-a-physicalvirtual-machine-into-vergeio.md).

# 将物理机和单个虚拟机导入 VergeOS

该 **VergeOS 克隆实用程序（VergeOS-clone.iso）** 可用于将外部物理机或虚拟机导入 VergeOS，作为虚拟机使用。该过程针对 PtoV（物理到虚拟）和非 VMware 的 VtoV（虚拟到虚拟）迁移进行了优化，使用高效的块传输。

{% hint style="info" %}
**对于 VMware 环境，请使用 VMware 连接器而不是 VergeOS 克隆实用程序。**
{% endhint %}

## 前提条件

### VergeOS 系统（目标端）

* 源虚拟机可访问的网络 URL。
* 具有创建 VM 权限的 VergeOS 凭据。
* 用于 VM 磁盘的可用 vSAN 存储空间充足。

{% hint style="info" %}
**VergeOS vSAN 全局重复数据删除通过处理零块来减少空间需求。**
{% endhint %}

* 足够的 RAM/CPU 用于运行导入的 VM。

### 源机器（物理机或虚拟机）

* 可访问 VergeOS 系统的网络连接。
* 用于 VergeOS 克隆 ISO 的 USB/CD-ROM。
* 至少 1 GB RAM，用于启动并运行 ISO。

## 选择同步方式

* **HTTPS 上传：** 默认方法，只需最少配置。
* **vSAN 直连同步：** 针对局域网连接进行了优化（需要额外的网络设置，不建议用于 WAN）。

{% hint style="info" %}
**vSAN 直连同步仅允许到主机系统，不能直接到租户。**
{% endhint %}

## 获取 VergeOS 克隆实用程序

1. 选择 **导入/导出** > **仪表板** 从顶部菜单中。
2. 点击 **下载克隆 ISO** 从左侧菜单中下载该文件的最新版本。
3. 会显示一个弹出消息，指示下载进度。传输完成后，该消息会短暂显示“下载完成”，随后弹窗消失。
4. 在本地机器上找到 ISO 文件（例如：下载文件夹）

{% hint style="info" %}
**您可以使用** [**创建可启动安装介质**](/plan-and-deploy/implementation-guide/install-media.md) **指南，替换为克隆 ISO。**
{% endhint %}

## 使用 VergeOS 克隆实用程序

1. 使用 VergeOS Clone ISO 启动源机器。
2. 选择 **启动克隆实用程序**.
3. 选择 **NIC** 以连接到 VergeOS 系统。
4. 选择 **DHCP** 或者配置 **静态 IP**.

如果使用静态 IP：

* 使用方向键在字段之间移动。
* 按 <kbd>Enter</kbd> 以编辑字段并配置 IP、子网、网关和 DNS。

5. 输入 **VergeOS 系统 URL** 以及 **凭据**.

{% hint style="warning" %}
**确保该用户具有创建 VM 的权限。**
{% endhint %}

6. 确认 **VergeOS 连接** 并继续。

## 克隆实用程序配置

1. 输入 **name** 用于在 VergeOS 上创建 VM。
2. 选择 **磁盘** 将被克隆。
3. 调整任何 **高级设置**:
   * **发送线程：** 默认值 = 4。可针对高延迟或高速连接进行调整。
   * **MAC 地址：** 选择是克隆现有 MAC 地址还是生成新的。

{% hint style="info" %}
**将线程设置得过高可能会降低性能。**
{% endhint %}

4. 通过选择以下项开始克隆过程： **开始克隆**.

## 恢复克隆

如果克隆导入失败或中断，请再次使用 VergeOS Clone ISO 启动源机器，并通过选择之前使用的 VM 名称来继续。

## 直连 vSAN 网络配置

该 **直连 vSAN** 传输方式可用于在本地网络上更快地克隆。不建议用于 WAN 连接。

{% hint style="warning" %}
**直连 vSAN 只能用于传输到根系统（不能直接到租户）。**
{% endhint %}

### 网络规则设置

必须创建三条网络规则：

### 核心网络规则 - 14201 PAT 规则

1. **名称：** vSAN PAT
2. **操作：** 转换
3. **协议：** TCP
4. **方向：** 入站
5. **源：** 任意 / 无（默认）
6. **目标类型：** 自定义\
   **自定义过滤器：** ui\
   **目标端口：** 14201
7. **目标类型：** IP/自定义\
   **目标 IP：** ui

{% hint style="info" %}
**UI 是 VergeOS 关键字，必须以小写输入。**
{% endhint %}

### 核心网络 SNAT 规则

1. **名称：** 用于克隆实用程序的 vSAN SNAT
2. **操作：** 转换
3. **协议：** TCP
4. **方向：** 出站
5. **源：** 任意 / 无（默认）
6. **目标类型：** 我的网络地址\
   **目标端口：** 14201
7. **目标类型：** 我的路由器 IP

### 外部网络规则 - 14201 PAT 规则

1. **名称：** vsan PAT
2. **操作：** 转换
3. **协议：** TCP
4. **方向：** 入站
5. **源：** 传入克隆传输的源 IP/IP 范围
6. **目标类型：** 我的路由器 IP\
   **目标端口：** 14201
7. **目标类型：** IP/自定义\
   **目标 IP：** ui

创建完规则后，点击 **应用规则** 以完成配置。

## 常见问题故障排除

### DHCP 失败

如果找不到 DHCP：

* 验证是否有可用的 DHCP 服务。
* 确保通过所选 NIC 可获得网络连接。

### 登录失败

* 检查用户名、密码和 URL 格式（不要包含“https\://”）。
* 如果使用静态地址，请验证静态 IP 设置和 DNS 配置。

### OpenSSL 错误

这些错误表示网络问题。请检查 MTU 不匹配或其他网络问题。

### 权限被拒绝

确保 VergeOS 用户具有创建 VM 所需的权限。

{% hint style="info" %}
**如果最初的克隆因权限问题失败，您可以恢复该过程，或者删除 VM 并重新开始克隆。**
{% endhint %}

***

{% hint style="info" %}
**文档信息**

* 最后更新：2024-08-29
* vergeOS 版本：4.12.6
  {% endhint %}


---

# 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/knowledge-base/zh/virtual-machines/importing-a-physicalvirtual-machine-into-vergeio.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.
