> 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/vm-field-descriptions.md).

# 虚拟机字段

**名称（必填）** 可搜索字段。仅允许可显示字符；不允许双引号；空格不能作为首尾字符。VM 名称字段在创建后可修改。

**启用 \[复选框]** 默认已选中（启用）。当虚拟机被禁用时，无法开机。

**描述（可选）** 多行字段，允许存储有关虚拟机的附加信息。对于包含大量虚拟机和/或虚拟机周转率较高的系统，描述会非常有帮助。

**操作系统家族 \[下拉框]** 选择将在此虚拟机上安装/运行的操作系统类型。虚拟化标志用于根据客户机操作系统类型进行优化。如果选择了错误的操作系统家族，性能可能会受到不利影响。

* *FreeBSD*
* *Linux*
* *Windows*
* *其他*

**操作系统描述（可选）** 为虚拟机提供进一步的说明区域；用于记录有关客户机操作系统的附加信息（例如：“RC1”、“SP2”、“Dev Edition”、“Enterprise”等）

**快照配置文件 \[下拉框]** 定义单个虚拟机的快照计划。通常此字段留空，因为虚拟机恢复可以很容易地从系统快照中提取。不过，在此处定义快照配置文件可用于执行额外的、更频繁的快照，和/或更长的快照保留期，和/或对虚拟机执行静默快照。选择列表包含系统中 [快照配置文件](/automate-protect-and-extend/zh/bei-fen-yu-dr/snapshot-profiles.md) 所有可用项。

**HA 组** （可选）HA 组值用于定义节点亲和性：

* **亲和组** -（值以“+”开头，例如“+webapp1”）系统会尝试在同一节点上运行具有相同 +HA 组的虚拟机，从而将相关工作负载保留在一起以优化性能。
* **反亲和组** 系统会尝试在不同节点上运行具有相同 HA 组值的虚拟机。这通常用于为应用程序或服务提供高可用性。（值不得以“+”开头。）

**集群 \[下拉框]** 定义用于该虚拟机计算资源的首选集群（在虚拟机开机时）。可选项包括用户有权限访问的所有集群

**故障转移集群（可选）\[下拉框]** 定义在主集群不可用时（在虚拟机开机时）使用的备选集群。可选项包括用户有权限访问的所有集群。

**首选节点（可选）\[下拉框]** 选择虚拟机将首先尝试启动的主机节点。可选项包括所选集群中的所有节点。

**Cloud-init 数据源 \[下拉框]** Cloud-init 集成选项

* *无* - 无 Cloud-init 功能
* *Config Drive V2* （标准 Cloud-init）
* *NoCloud* （标准 Cloud-init，用于无网络连接的配置）

**所有者用户（可选）\[下拉框]** 可将用户分配给指定虚拟机。分配 *所有者用户* 将自动为该用户分配虚拟机的列出/读取权限；如果所分配的用户账户被删除，虚拟机也会自动删除。

**RAM** 分配给虚拟机的 RAM 量。（可选择 GB 或 MB 单位）界面允许分配给虚拟机的内存量高于实际可用内存。但是，如果在发出开机命令时，定义的 RAM 量不可用，则会报错，虚拟机将不会启动。

**核心数** 分配给虚拟机的 CPU 核心数。核心数可以超分配；但是，虚拟机只能使用实际可用的核心。

**CPU 类型 \[下拉框]** 通常建议保留默认设置，因为这会在创建虚拟机时自动选择针对底层物理主机硬件优化的 CPU 类型。也可以选择其他 CPU 类型，以适配旧版操作系统/应用程序，以及允许将系统迁移到使用不同物理主机硬件的故障转移站点。

**启动顺序 \[下拉框]** 定义检查磁盘设备以查找可启动操作系统的顺序。

* *磁盘*
* *磁盘，CD-ROM（默认）*
* *磁盘，CD-ROM，网络*
* *CD-ROM*
* *CD-ROM，磁盘*
* *网络*
* *网络，磁盘*
* *磁盘顺序 ID*

**机器类型 \[下拉框]** 模拟的主板架构。

* *Q35* - AHCI（推荐）
* *PC* - IDE

**允许热插拔（默认选中）** 这允许在不重启虚拟机的情况下添加或移除磁盘和网卡。如果客户机操作系统或模拟硬件不支持，请禁用。

{% hint style="info" %}
**热插拔限制**

热插拔仅适用于 **磁盘和网卡**。对 CPU 核心或 RAM 的更改始终需要重新断电/上电才能生效。参见 [虚拟机热插拔能力](/knowledge-base/zh/tenants/vm-hotplug-capabilities.md) 了解详细信息。
{% endhint %}

**控制台类型 \[下拉框]**

* *VNC* - 提供基本的图形控制台连接；不支持音频或虚拟 USB；足以满足大多数管理用途
* *Spice* - 支持音频直通；支持 USB 直通（注意：音频和 USB 支持需要 Spice 客户端软件。）
* *串行控制台* - 选中后，不会添加显卡，所有虚拟机输出都将发送到串口。可使用终端模拟器（xterm.js）连接到串口。
* *无* - 无法通过 VergeOS 用户界面提供控制台访问。

**启用控制台密码（默认未选中）** 启用后，访问远程控制台选项时需要使用指定的用户名/密码登录。当 *启用控制台密码* 字段被勾选时，会显示用户名和密码字段的提示。

**USB 平板（默认选中）** 选中后，会模拟平板指针而不是鼠标，从而减少开销和网络流量。对于仅命令行的虚拟机，由于没有鼠标，此选项不必要。对于将使用客户端代理的 Spice 虚拟机，此选项也不必要。

**显卡 \[下拉框]**

* *标准 VESA 2.0* （默认）- 推荐用于大多数现代操作系统安装（除非使用高性能视频硬件）。
* *Cirrus Logic* - 与许多安装高度兼容。适用于较旧的操作系统版本。
* *QXL* - 使用 Spice 远程控制台协议时必需
* *兼容 VMWare SVGA-II* - 导入的 VMware 虚拟机可能需要此驱动。
* *VirtIO* - 提供 VGA 直通。这是利用物理节点上更好的视频适配器硬件（例如硬件加速）的最佳选项；通常也是 VDI 解决方案的最佳选择，因为它使用高性能的物理视频适配器。当物理节点采用低性能的基础视频适配器硬件时，不建议使用此选项。

**RTC 基准** 设置虚拟机的时钟基准

* *UTC* - 世界协调时间
* *本地时间* - 基于 VergeOS 系统时区的本地时间

{% hint style="success" %}

* Linux 通常期望使用 UTC 格式时间
* Windows 通常期望使用本地时间；因此，此设置应设为本地时间，或者也可以在 Windows 中进行相应的注册表更改以使用 UTC。以下知识库文章提供了更多信息： [Windows 时间偏移](/knowledge-base/zh/virtual-machines/windows-time-shift.md).
  {% endhint %}

**UEFI（默认未选中）** 所需选择通常取决于虚拟机上使用的客户机操作系统。（选中=UEFI，未选中=BIOS）在现有虚拟机上修改此选项需要对虚拟机进行一次断电/上电。

**串口 \[复选框]** 启用后，将创建一个虚拟串口；仅用于客户机操作系统兼容性（例如：Ubuntu Cloud 镜像需要串口才能安装。）注意：当为 *控制台类型*选择串行控制台时，此选项不会显示，并且会自动创建串口并分配给控制台。

**启动延迟（可选）** （秒）用于控制所属租户/云在启动时虚拟机的启动时机。例如，可以在 Web 服务器上指定延迟，以便在 Web 服务器虚拟机开机之前，先给其数据库服务器启动并完成加载的时间。

**断电时的操作 \[下拉框]** 决定在虚拟机恢复供电时采取的操作。（这可能是在物理断电之后，或在 VergeOS 界面中将所属租户关闭/开启之后。）

* *上次状态* - 仅当虚拟机在断电时处于开机状态时，才会在恢复供电后自动开机。
* *保持关闭* - 恢复供电时不会自动开机（无论断电时其状态如何）
* *开机* - 恢复供电时会自动开机（无论断电时其状态如何）

**禁用电源循环 \[复选框]** 默认情况下，当客户机操作系统发起重启时，系统会执行完整的电源循环（会重新初始化所有虚拟机硬件）。选中此选项后，客户机操作系统发起的重启将仅重置客户机操作系统，而不会进行电源循环/硬件重置。


---

# 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/vm-field-descriptions.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.