> 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/plan-and-deploy/zh/shi-shi-zhi-nan/installation-guide.md).

# 安装指南

## 介绍

VergeOS 安装是一个单一的 [可启动的 ISO 镜像](/plan-and-deploy/zh/shi-shi-zhi-nan/install-media.md) 其中包含完整系统所需的全部软件包。

本文档提供安装 VergeOS 系统的一般说明。对于生产系统，请使用数据中心级硬件，并遵循位于以下位置的参考架构： [实施指南](/plan-and-deploy/zh/shi-shi-zhi-nan/intro.md).

### 安装流程

```mermaid
graph LR
    A["预安装<br>- 建立网络信息<br>- 验证 BIOS 设置"] --> B["安装主<br>控制器节点"]
    B --> C["安装次<br>控制器节点"]
    C --> D["按需安装额外<br>节点<br>横向扩展计算，<br>FTE"]
    D --> E["验证您的系统"]
    E --> F["后续步骤<br>安装后检查清单"]
```

## 安装前步骤

在继续安装之前，请确保已查阅以下文档：

* [安装前检查清单](/plan-and-deploy/zh/shi-shi-zhi-nan/pre-installation.md)
* [可启动介质](/plan-and-deploy/zh/shi-shi-zhi-nan/install-media.md)

***

## 安装主控制器节点

{% hint style="warning" %}
**VergeOS 作为完整操作系统安装在每个节点上。所选驱动器将被格式化，这些驱动器上的现有数据将丢失。**
{% endhint %}

1. 使用安装 ISO 启动第一个节点。完整安装程序将加载到内存中，屏幕上会显示加载进度。加载时间会因所使用的安装介质而异。
2. 选择 **安装（标准）** （默认）。这是默认选择；安装将自动继续标准安装。只有在与 VergeIO 支持密切配合时，才应选择非标准安装选项。
3. 选择 **控制器** （默认选择）。系统中的前两个节点将是控制器节点。
4. 选择 **是** 以表明这是一个 **新安装**.
5. 选择 **时区和 NTP 服务器设置**.

   <div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p><strong>时区选择通常基于服务器的地理位置，但也可以根据管理员偏好进行配置。默认情况下，Windows 虚拟机将继承系统时区；若要将 Windows 虚拟机配置为 UTC 时间，需要修改注册表。</strong></p></div>
6. 选择合适的 **日期/时间**.

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>正确的日期/时间对 vSAN 运行非常重要。请确保在安装期间日期设置正确，并且时间与准确时间尽可能接近，以避免潜在问题。</strong></p></div>
7. 输入一个 **系统名称**。这将用于在仪表板、来自此系统的警报/报告以及站点同步中标识您的系统。此名称可在安装后于系统设置中更改。
8. 输入 **管理员用户凭据**。密码至少必须为 8 个字符。这些凭据可在安装后更改，不过，在首次登录系统时需要提供用户名/密码。
9. 输入 **管理员电子邮件地址**。此地址用于管理员账户密码重置，以及接收发送给管理员用户的订阅警报/报告。安装期间必须输入管理员电子邮件地址，安装后也可在 UI 中配置。

### 配置物理网络

**以下步骤用于为该节点定义各个物理网络。**

10. 将显示所有检测到的 NIC 列表。 **选择一个 NIC（或多个 NIC，用于端口绑定）**，以配置相应的物理网络。

    <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Core Fabric 网络不应使用端口绑定（LAG），因为这会干扰基于多个物理 Core Fabric 网络的内置冗余。</strong></p></div>
11. **指定物理网络设置：**

    <div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p><strong>键盘提示：[Tab] 不会在字段之间移动，而是在操作项（完成/编辑/取消）之间切换。[Enter] 切换编辑模式。编辑模式关闭时，输入字段会以蓝色高亮，您可以使用上/下箭头键在字段之间移动。编辑模式开启时，您可以使用光标修改字段。</strong></p></div>

* **名称** - 此名称将在用户界面中用于标识此网络。请输入一个有助于识别 NIC 所连接位置的名称，例如交换机主机名或组织命名约定。此名称可在安装后更改。
* **描述** （可选）- 可在此输入文本以提供任何附加管理信息。
* **MTU** - MTU 设置必须始终为物理交换硬件支持的值。对于 Core Fabric 网络，MTU 应足够大，以支持将提供的租户级别；默认值为 9192。

  <div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p><strong>在配置外部网络 MTU 时：大多数以太网网络的互联网标准 MTU 为 1500。VPN 连接的标准为 1400 字节（会因服务而异）。</strong></p></div>
* **核心网络：** -如果核心网络将位于此处，则值需要为“yes”。否则，请将值改为空白或“no”。
* **VLAN** - 始终优先使用 PVID 端口（无则填 0 或留空），但也可以在此输入正确的 VLAN ID 来设置 VLAN 标记。

12. **重复以上步骤，配置所有物理网络** 直到每个 NIC 都已分配。如果有未插入的 NIC，也应在安装期间在此处进行配置；可以将其命名为“unplugged”或“unused”。

    <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>当您完成所有物理网络配置后，可以选择 [完成]。</strong></p></div>
13. 选择一个 **将提供 UI/LAN/WAN 访问的物理外部网络**.
14. 输入合适的 **外部/UI 网络的 VLAN ID**。尽可能使用 PVID 端口（0 或留空）；否则请输入相应的 VLAN ID。
15. 指定一个 **网络地址** 用于外部/UI 网络：

    * **静态：** 以 CIDR 格式输入地址（例如 10.0.0.2/24）。系统还会提示您输入默认网关和 DNS 服务器地址。

    **-或-**

    * **DHCP：** 留空或输入“dhcp”可使网络从外部 DHCP 获取地址。使用 DHCP 会将网络限制为单个 IP 地址；这通常仅适用于测试/评估系统或仅存储系统。如果选择 DHCP，系统还会提示您输入此 DHCP 客户端使用的名称/域。
16. 配置 **加密设置**。（可选，静态加密）。

* 如果选择加密，系统将提示您输入 **AES256 加密密钥口令**。口令长度必须介于 8 到 64 个字符之间。
* 您也可以选择 **将生成的加密密钥写入 USB 驱动器/专用设备**。在对该选项选择“是”之前，您必须确保 USB 驱动器/专用存储设备已插入。在下一屏中， **在按下 < 确定 > 之前确认已选择目标设备。**

  <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>加密选择在安装后不可逆；从加密改为未加密或反之都需要重新安装系统。</strong></p></div>

17. **选择将用于 vSAN 的驱动器**。所有检测到的驱动器都会显示，并且默认已选中。 **取消选择任何应排除的驱动器。请确保取消选择任何可移动设备，或将用于存储可选加密密钥的驱动器。** 系统将为每个驱动器显示自动选择的层级。层级分配可在后续对话框中修改。

    {% hint style="warning" %} **已选择的驱动器会显示星号；在按下 < 确定 > 之前，请确保您想取消选择的驱动器在最左侧没有星号。**

    {% endhint %}
18. **手动设置驱动器层级分配（可选）**:

选择 **< 是 >** 和 **\[Enter]** 以查看所有驱动器并可选择更改任何层级分配。手动选择层级分配完成后，选择“完成”并按 \[Enter]。

19. 配置 **用于超分配/故障切换的 RAM（Swap）** （可选）：

在规划 swap 时需要考虑多个因素，包括：存储可用性、系统用途、磁盘类型等。有关更多信息，请咨询 VergeIO 实施团队。安装后，可在 UI 中为新驱动器和重新格式化的驱动器配置 swap。

* 选择存储 **层级** 用于 swap。

  <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>选择 Swap 层级</strong></p><ul><li>通常不优先使用 0 级驱动器；如有可能，请选择下一最快的驱动器层级。</li><li>不要为 swap 选择 HDD 驱动器，除非该节点只包含此类存储。</li></ul></div>
* 输入要建立的 swap 容量 **每个驱动器（单位 MB）**；例如，如果所选层级中有 8 个驱动器，输入 2048 可获得 16,384MB（16GB）的 swap。

  <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><ul><li>通常，每个节点配置的 swap 不应超过 16GB。</li><li>过大的 swap 可能会降低性能。</li></ul></div>
* 系统将显示一条消息，其中包含 swap 总量/驱动器数量。请审阅该信息，选择 < 是 > 确认，或选择 < 否 > 重新配置。

20. 选择 **用于引导格式化的驱动器**。只有当有驱动器未被选择纳入 vSAN 时才会出现此提示。较旧的硬件（例如旧式机箱、BOSS 卡）可能需要您指定用于引导格式化的驱动器。在大多数情况下，您可以按 \[Enter] 继续安装，而无需选择引导驱动器。
21. **UEFI 分区** - 某些 UEFI 系统不会自动检测 EFI 分区。如果提示注册 UEFI 启动选项，建议选择“yes”。

当安装选项最终确定后，vSAN 将被初始化并安装软件包。每个所选驱动器将一次格式化一个（大容量驱动器可能需要几分钟才能格式化），然后添加到 vSAN。

22. 安装完成时会有提示。 **移除安装介质并按 \[Enter] 重新启动。**

### 重启后

23. 当 vSAN 成功挂载且系统启动后，用户菜单将显示。按 **\[Enter]** 以选择 **用户界面** 并输入管理员登录凭据。您的新系统的主仪表板将显示。状态指示器应全部为绿色。

***

## 安装次控制器节点

{% hint style="info" %}
**在安装次控制器节点之前，必须先完全安装并启动主控制器节点。**
{% endhint %}

1. **启动** 使用安装 ISO 启动第二个节点。
2. 选择 **标准安装** （默认）。这是默认选择；安装过程将自动继续使用此选择。只有在与 VergeIO 支持密切配合时，才应选择非标准安装选项。
3. 选择 **控制器** （默认选择）。
4. 选择 **否** 以表明这不是一个新系统。（您将连接到上面已创建的系统。）

{% hint style="warning" %}
**如果您在此处不选择“否”，安装程序将创建一个新的独立系统，而不是加入已安装的主节点控制器。**
{% endhint %}

5. 系统将提示您输入 **所连接系统的管理员（root）密码。** 输入 **管理员凭据** 这些凭据是在主控制器节点安装期间创建的。
6. 选择 **是** 以尝试 **自动检测网络** 配置。推荐这样做，因为它会尝试检测现有网络并相应地自动配置新节点，从而避免手动网络配置错误。网络检测可能需要几分钟。
7. 应检测到两个核心网络。每个网络成功检测后， **确认** 显示的信息，并按 \[Enter] 继续。
8. 选择 **加密设置**；这些设置必须与在主控制器安装期间输入的设置一致。
9. 选择 **将用于 vSAN 的驱动器** 和 **（可选）更改驱动器层级分配**；这些选择应与主控制器节点安装时所做的驱动器/层级配置一致。
10. 安装程序完成时会有提示。移除安装介质并按 \[Enter] 重新启动。

{% hint style="info" %}
**N+2 vSAN 冗余（3 个控制器节点）**

两个控制器节点提供默认的 **N+1** 冗余配置，它会保留每个数据块的两份副本，非常适合大多数环境。

**N+2** 也支持配置，在整个系统中保留每个数据块的三份副本。

N+2 需要 **3 个控制器节点** 已安装。有关冗余级别、要求和用例的更多详细信息，请参见 [了解 vSAN 冗余级别](/run-the-platform/zh/cun-chu/vsan-redundancy-levels.md).

在安装完全部三个控制器节点后， **需要重启全部 3 个节点** 以激活 N+2 冗余级别。

{% hint style="warning" %}
在现有系统上更改冗余级别涉及完整的数据重新平衡过程，这可能需要 **较长的停机时间**，尤其是在存储大量数据的系统上。此更改应仅在与 **Verge.io 支持**.
{% endhint %}
{% endhint %}

### 重启后（次控制器）

11. 等待系统加载并显示用户菜单。选择 **用户界面**，并输入管理员登录凭据。
12. 在继续安装后续节点之前，请确认状态指示器为绿色。

## 安装额外节点（按需）

可根据需要安装额外节点。这些节点可以是：

* [**横向扩展**](/plan-and-deploy/zh/shi-shi-zhi-nan/scale-out-nodes.md)
* [**仅计算**](/plan-and-deploy/zh/shi-shi-zhi-nan/compute-nodes.md)
* [**仅存储**](/plan-and-deploy/zh/shi-shi-zhi-nan/storage-nodes.md)

## 安装后步骤

当节点安装完成后，请参见 [**安装后**](/plan-and-deploy/zh/shi-shi-zhi-nan/post-installation.md) 以了解后续步骤。

***

## 故障排除与支持

如果安装过程中出现问题：

* 按 `Esc` 取消并进入命令提示符
* 输入 `yb-install` 以继续，或 `yb-install --restart` 重新开始。


---

# 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/plan-and-deploy/zh/shi-shi-zhi-nan/installation-guide.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.