> 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/xi-tong-guan-li/cluster-settings.md).

# 集群设置

VergeOS 所有集群配置设置的参考，包括 CPU 类型、RAM 分配、安全缓解、计算资源策略、交换和节点温度监控。

该 *集群设置* 表单可让您配置与性能、安全、分配、温度监控和交换分区相关的关键参数。虽然大多数默认设置适用于大多数环境，但建议在创建新集群时以及之后定期审查这些设置，以确保其符合您组织的策略和运营要求。

{% hint style="success" %}
**大多数集群设置更改都需要重启集群中的每个节点。当需要重启时，集群仪表板顶部会显示一条消息。选择 *****需要重启***** 选项（位于集群仪表板顶部的重启/重新启动消息中，或左侧菜单选项中）来管理集群节点的重启。重启节点时务必遵循正确的** [**维护模式流程**](/run-the-platform/zh/yun-wei/maintenance-mode.md) **，以避免工作负载中断。**
{% endhint %}

## 访问集群设置

* 从顶部菜单中，导航到 **基础架构** > **集群** > **双击所需的集群**
* 点击 **编辑** 在左侧菜单中。

## 集群

此部分定义集群的基本属性。

1. **已启用：** 默认情况下，集群将处于启用状态。通常没有理由禁用它；不过，在某些情况下这样做可能会很有用，例如在进行完整的集群重新配置期间。
2. **名称：** 集群通常在安装时命名，但之后也可以正常重命名。
3. **描述：** 可选文本区域，用于提供集群用途或特征的简要说明。
4. **默认 CPU 类型：** 定义此集群所指定虚拟机的默认/推荐 CPU 类型。该设置会在集群安装期间根据检测到的 CPU 硬件自动选择。在初始配置期间，请检查该设置以验证是否检测到了正确的 CPU 类型。

{% hint style="success" %}
**为了让虚拟机能够迁移/故障切换到使用较低级别 CPU 芯片的其他集群， *****默认 CPU 类型***** 可以更改为较低级别类型，以便虚拟机能够顺利迁移到较旧的芯片硬件。**
{% endhint %}

{% hint style="warning" %}
**集群中的所有节点都应使用相同的 CPU 硬件；同一集群中混用不同 CPU 类型可能导致性能和工作负载迁移问题。**
{% endhint %}

5. **每节点存储缓冲区（默认 2 GB）：** 为每个节点额外分配的 RAM 数量，用于 vSAN 性能缓存。

{% hint style="info" %}
**注意事项**

* 当存在可用 RAM，且除系统和虚拟工作负载需求之外还有余量时，请考虑增大此设置
* 增加 *每节点存储缓冲区* 可以显著提升读/写性能
* 一般而言，在正常运行期间，目标是 RAM 利用率不超过 80%
  {% endhint %}

### 集群安全/性能

此子部分允许您为集群中的所有节点启用/禁用各种与性能和安全相关的功能及缓解措施。

1. **为存储分配 Hugepages（默认启用）：** 在大多数情况下，强烈建议启用 hugepages，因为它可提升工作负载的内存存储性能。一般不建议禁用此设置，除非在少数特殊场景下，例如仅运行非常小的虚拟机或对 hugepage 支持有限的旧版客户机操作系统。
2. **禁用 CPU 安全缓解措施：** 如果选择此项，将禁用集群的内核级 CPU 安全缓解措施。

{% hint style="warning" %}
**重要：虽然禁用 CPU 安全缓解措施可以提升性能，但这也存在风险。只有在您完全信任此集群中运行的所有客户机，并且能够确认这些工作负载没有外部漏洞（例如空气隔离系统）时，才应选择此选项。**
{% endhint %}

3. **禁用推测性存储旁路：** 如果选择此项，将在运行时禁用推测性存储旁路（SSB）。禁用 SSB 可能导致轻微到中等程度的性能下降，具体取决于系统工作负载。
4. **禁用 SMT：** 如果选择此项，将在运行时禁用同时多线程（SMT）。

{% hint style="info" %}

* 禁用 SMT 会显著影响性能，因为它会禁用超线程
* 虽然现代软件和微代码更新通常已缓解了与 SMT 相关的许多漏洞，但某些高度敏感的环境仍可能选择将其禁用，即使这会带来性能代价
* 禁用 SMT 的推荐方式是在 BIOS 中进行。该设置的准确名称可能因制造商而异；如不确定，请查阅您的硬件文档
  {% endhint %}

5. **禁用 CPU 睡眠状态：** 如果选择此项，VergeOS 将自动禁用低级睡眠状态。这可以消除因短暂空闲突发而产生的不必要睡眠状态切换，否则这会在对能效带来很小收益的情况下显著降低性能。

{% hint style="info" %}

* 在新部署的系统上，禁用 CPU 睡眠状态尤其有益，因为工作负载会逐步增加。在这些情况下，空闲节点必须随着需求增加快速响应
* 选择此选项可能会导致更高的温度和功耗，具体取决于系统工作负载
  {% endhint %}

6. **启用拆分锁检测：** 检测工作负载中的拆分锁事件并将其报告到系统日志中。启用此选项可能会对触发拆分锁的虚拟机产生性能影响。
7. **能效策略（默认=*****性能*****):** 该策略设置用于指导处理器内部逻辑，在性能与能效之间取得平衡。通常最好保持默认值，让系统在运行时动态优化性能。也提供其他能效/性能选项，以支持消费级系统、家庭实验室或概念验证（POC）部署等非企业环境。
8. **CPU 调频调节器（默认=*****性能*****):** 根据系统负载进行内核级动态 CPU 频率调整的策略。通常最好保持默认值，让系统在运行时动态优化性能。也提供其他能效/性能选项，以支持消费级系统、家庭实验室或概念验证（POC）部署等非企业环境。

### 系统日志过滤器

1. **系统日志过滤器（默认 `*:3,ipmievd:5,rasdaemon,!ntpd,!postfix`):** 以逗号分隔的 rsyslog 语法过滤器列表，用于确定在用户界面中显示哪些日志条目。匹配这些过滤器的条目会显示；其余条目会从 UI 视图中排除。此语法支持 facility 和 priority 过滤器，以及按程序进行的包含或排除。

{% hint style="success" %}
**未过滤的日志仍可通过 *****节点诊断***** （导航到 *****节点***** > 双击所需节点 > 选择 *****诊断***** 从左侧菜单。**
{% endhint %}

## 计算

此部分为集群配置计算资源策略。这些设置不适用于仅存储集群。

1. **每台机器最大 RAM：** 指定可分配给单个工作负载（例如虚拟机、租户节点或 NAS 服务）的最大 RAM 量。

{% hint style="success" %}
**注意事项**

* 如果任何正在运行的工作负载（例如 VM）使用的 RAM 超过此限制，在降低该设置后将无法迁移。
* 此限制会影响工作负载启动和迁移（即在新节点上启动）。它不会阻止您创建使用更多 RAM 的工作负载，但只会在超出限制时阻止其启动。
* 一般规则是，选择仍能满足您预计最大工作负载需求的最低 RAM 值。为单个工作负载分配较少的 RAM 将最大限度提升迁移、故障切换和工作负载可移植性的灵活性，并加快故障切换时间。
* **在将此限制设置得接近节点物理 RAM 容量时要谨慎**。如果您将此限制设置为与节点总 RAM 相同（例如 128GB），然后创建一个使用全部内存的 VM，那么该 VM 将无法启动或迁移，因为：
  * VergeOS 会为系统操作和 vSAN 功能保留 RAM
  * 在维护或故障切换期间，工作负载必须迁移到其他可用节点
  * 消耗几乎全部可用 RAM 的 VM 无法成功迁移到其他节点
* **推荐做法：** 将此限制设置为最小节点物理 RAM 的不超过 70-80%，以确保在维护或故障切换场景下 VM 始终可以迁移。
  {% endhint %}

2. **每台机器最大核心数：** 指定可分配给单个工作负载（例如虚拟机、租户节点或 NAS 服务）的最大 CPU 核心数

{% hint style="success" %}
**注意事项**

* 如果任何正在运行的工作负载（例如 VM）使用的核心数超过此限制，在降低该设置后将无法迁移。
* 在几乎所有情况下，此值 **不应超过** 以下可用核心数： **单个 CPU 插槽**.
* **此值绝不应超过单个节点中的物理核心总数**
  {% endhint %}

3. **目标最大 RAM 百分比（默认 80）：** 指定集群节点在正常情况下应使用的物理 RAM 最大百分比。此阈值有助于防止新工作负载过度分配。不过，在故障切换或工作负载迁移等特殊情况下，为维持服务连续性，该值可能会被超过。

{% hint style="info" %}
**示例： *****目标最大 RAM 百分比***

* 集群节点有 **252GB 可用物理 RAM** （256GB，扣除 BIOS/显卡开销后为 252GB）
* ***目标最大 RAM 百分比*** 设置为默认值 **80**
* 252G \* 80% = **约 200G** 在正常情况下可使用
* **系统/vSAN RAM 开销 16G** （注意：vSAN 开销会因集群存储量而异）
* **可供新工作负载使用：** 184GB（可用量减去开销），保持在 80% 的使用目标内
* **在故障切换或迁移期间：** 工作负载 RAM 使用量 **可能会暂时超过 184GB** 以支持迁移后的工作负载
  {% endhint %}

4. **用于机器的保留 RAM 百分比：** 定义一部分（百分比）的交换空间，专门用于在物理 RAM 耗尽时模拟额外的工作负载 RAM。该虚拟 RAM 可配置为 RAM 超额分配的备用方案。

{% hint style="warning" %}
**RAM 超额分配注意事项**

* 使用此保留 RAM 功能通常仅作为 RAM 超额分配的备用方案
* 避免在工作负载内存利用率高或关键工作负载的集群上进行超额分配
* 考虑通过减少 RAM 分配来调整 VM 规模，前提是其使用量始终较低
* 如果过多的 VM 同时要求其全部内存分配，工作负载性能可能会下降，因为虚拟 RAM 的速度比物理 RAM 慢几个数量级（毫秒对纳秒）
  {% endhint %}

5. **嵌套虚拟化：** 允许在另一台虚拟机中使用来自主机的硬件加速运行虚拟机。

{% hint style="info" %}
**嵌套虚拟化可能涉及安全影响以及公平排队/计量方面的问题。**
{% endhint %}

6. *允许嵌套虚拟化在线迁移：*\* 允许启用了嵌套虚拟化的虚拟机进行在线迁移。
7. *允许 VGPU 在线迁移：*\* 允许带有 vGPU 设备的虚拟机进行在线迁移（实验性）。虽然测试中尚未完全验证，但当主机和客户机都使用最新的 NVIDIA 驱动程序时，vGPU 工作负载的在线迁移通常表现稳定可靠。

{% hint style="info" %}
**如果可用的 vGPU 设备不足，工作负载在维护期间可能会暂时关闭电源。**
{% endhint %}

{% hint style="success" %}
\***在线迁移**

虚拟机设置： *迁移方式* 允许为每个 VM 定义迁移行为（例如，需要手动关机、尝试在线迁移）
{% endhint %}

### 启用嵌套虚拟化

嵌套虚拟化需要两个设置；必须在集群级别和 VM 级别同时启用：

1. **集群级别：** 启用 **嵌套虚拟化** 上方列表中的该设置。如果集群仪表板顶部出现重启消息，请使用正确的 [维护模式流程](/run-the-platform/zh/yun-wei/maintenance-mode.md).
2. **VM 级别：** 在 VM 仪表板中，点击 **编辑** 并启用 **嵌套虚拟化** 在 VM 设置中。

启用这两个设置后，请重启 VM。CPU 功能会在 VM 启动时应用。

{% hint style="info" %}
该 **允许嵌套虚拟化在线迁移** 该设置是单独的。它只控制启用了嵌套虚拟化的 VM 是否可以在节点之间进行在线迁移；运行嵌套虚拟化并不需要此项。
{% endhint %}

{% hint style="success" %}
**Hyper-V 使用场景**

在 Windows 客户机中运行 Hyper-V 是启用嵌套虚拟化的常见原因。当未在两个级别都启用嵌套虚拟化时，Hyper-V 角色可能会导致客户机在 Windows 标志出现后不久进入启动循环。如果重启后 Hyper-V 角色仍然失败，请将 VM 完全关闭后再重新启动。将 Hyper-V 作为嵌套客户机运行适用于实验室和测试场景；这不是经过生产认证的配置。
{% endhint %}

## 存储（交换设置）

{% hint style="warning" %}
**交换设置在集群安装期间指定。交换设置更改只会应用于新格式化的磁盘。**
{% endhint %}

1. **用于交换的层级：** 用于交换空间的存储层级。当值为 0 时，交换被禁用
2. **每个驱动器的交换：** 每个驱动器分配的交换空间量

## 节点温度

此部分允许您定义 VergeOS 对集群节点上较高 CPU 热读数相关的告警行为设置。及时在接近 CPU 最高温度之前发出通知，可让您采取措施避免宕机和对物理设备造成损害；让 CPU 硬件达到其最高温度限制可能会导致 CPU 自动关闭自身或导致硬锁，并可能造成硬件损坏。

1. **最高核心温度（摄氏度）** 设定用于 VergeOS 温度监控的峰值温度（与下一设置结合使用： *最高核心温度警告阈值 %*).

   * ***从硬件查询***** （默认）** - 从 CPU 检索硬件定义的最高温度

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>非服务器硬件和某些旧式服务器可能不支持此查询；在这种情况下，可以选择 </strong><em><strong>自定义</strong></em><strong> 设置来建立一个温度上限，以此作为 VergeOS 警告的依据。</strong></p></div>

   * ***自定义*** - 允许手动定义特定的峰值温度。请参阅您的硬件文档以确认 CPU 的最高温度。
   * ***禁用*** - 当您不希望在 VergeOS 中监控温度时可使用此选项（例如您不负责监控硬件，像裸金属提供商，或者 VergeOS 运行在虚拟环境中）
2. **最高核心温度警告阈值 %** 设置相对于上述最高核心温度的百分比边界，以触发警告状态。警告状态会导致节点状态变为黄色，并在系统日志中创建一条警告记录。通常建议阈值至少为 10% 或更高，以便在应对热问题时留出采取适当措施的时间。

{% hint style="info" %}
**示例**

如果 *最高核心温度（摄氏度）* 设置为 80 度，并且 *最高核心温度警告阈值 %* 设置为 10，当 CPU 硬件报告 72 度时将触发警告状态。
{% endhint %}

3. **临界核心温度（摄氏度）：** 定义在 VergeOS 中触发错误状态的温度。当报告的硬件温度达到该温度时，节点状态将变为红色，并且系统日志中会出现一条错误记录。

   * ***从硬件查询*****&#x20;（默认）** - 从 CPU 检索硬件定义的临界温度

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>非服务器硬件和某些旧式服务器可能不支持此查询；在这种情况下，可以选择 </strong><em><strong>自定义</strong></em><strong> 设置来建立一个温度上限，以此作为 VergeOS 警告的依据。</strong></p></div>

   * ***自定义*** - 允许手动定义临界温度。请参阅您的硬件文档以确认 CPU 的最高温度。
   * ***禁用*** - 当您不希望在 VergeOS 中监控温度时可使用此选项（例如您不负责监控硬件，像裸金属提供商，或者 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/xi-tong-guan-li/cluster-settings.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.