> 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/learn-the-platform/zh/mo-kuai-3-an-zhuang/01-pre-installation.md).

# 安装前检查清单

成功部署 VergeOS 远在插入第一只 USB 闪存盘之前就已开始。本页涵盖你必须核实的每一项前提条件——从 BIOS 设置和磁盘控制器模式，到交换机配置和启动介质准备——以便安装当天顺利进行、毫无意外。

```mermaid
graph LR
    A["硬件<br/>就绪"] --> B["BIOS 与<br/>固件"]
    B --> C["启动介质<br/>制作"]
    C --> D["网络<br/>准备"]
    D --> E["文档<br/>& 规划"]
    E --> F["可开始<br/>安装"]

    style F fill:#e8f5e9,stroke:#2e7d32
```

## 硬件就绪

在安排安装之前，请确认所有物理硬件都已上架、布线，并满足 VergeOS 的要求。

### CPU 要求

* **64 位处理器** 并支持硬件辅助虚拟化（Intel VT-x 或 AMD-V）
* BIOS 中启用所有处理器核心
* 启用超线程（建议用于提高工作负载密度）

### 内存要求

* **每个节点的系统保留：** **16 GB 操作系统 + 每 1 TB 原始 vSAN 存储再预留 1 GB** （例如，具有 4 TB 原始存储的节点，至少总共预留 20 GB）
* 在系统保留之外，还要为工作负载预留 RAM

### 磁盘控制器配置

磁盘控制器是最常见的安装问题来源之一。VergeOS 需要直接访问每一块单独的驱动器——它不支持硬件 RAID 阵列。

| 控制器类型            | 要求                                     |
| ---------------- | -------------------------------------- |
| **HBA（主机总线适配器）** | 首选——将驱动器直接传递给操作系统                      |
| **RAID 控制器**     | 必须设置为 **JBOD / IT 模式** （直通）——无 RAID 阵列 |
| **NVMe 驱动器**     | 如果所有驱动器都是 NVMe，请确认控制器支持从 NVMe 启动       |

{% hint style="warning" %}
**常见陷阱**

如果驱动器配置在 RAID 阵列中（即使是 RAID 0），VergeOS 安装程序也只会看到一块虚拟磁盘，而不是单独的驱动器。这会妨碍正确的 vSAN 分层分配。务必在安装日前确认 JBOD 模式。
{% endhint %}

### 远程管理（IPMI）

* 每个节点上的 IPMI / iDRAC / iLO 端口均已打补丁、配置并测试
* 已安装最新的 IPMI 固件（建议）
* 已验证远程控制台功能——这对于在安装期间排查许可或启动问题至关重要

### 电源

* 已连接并配置冗余电源（生产环境建议）
* 为所有节点和网络交换机提供 UPS 保护

## BIOS 配置

安装开始前，每个节点都必须一致地配置 BIOS。各节点 BIOS 设置不一致是导致安装延误的常见原因。

| 设置          | 必需值                  | 备注                            |
| ----------- | -------------------- | ----------------------------- |
| **启动模式**    | UEFI（首选）或 Legacy/双模式 | **如果所有驱动器都是 NVMe，则必须使用 UEFI** |
| **硬件虚拟化**   | 已启用（VT-x / AMD-V）    | VergeHV 虚拟机监控器运行所必需           |
| **超线程**     | 已启用                  | 建议用于提高工作负载密度                  |
| **所有处理器核心** | 已启用                  | 不要为了“省电”而禁用核心                 |
| **安全启动**    | **已禁用**              | VergeOS 实施其自身的启动完整性验证         |
| **系统时钟**    | 设置正确（所有节点之间相差应在几秒内）  | 安装后，节点 1 为整个系统负责 NTP          |

### 为什么必须禁用安全启动

VergeOS 不使用传统的 UEFI 安全启动。相反，VergeOS 实施其 **自身的启动完整性验证** 以防止被篡改的镜像启动。此方法在不受 UEFI 安全启动限制的情况下提供实用的防篡改保护（UEFI 安全启动要求操作系统使用在固件中注册的密钥签名——这一过程由少数证书颁发机构控制）。

关键区别：

* **UEFI 安全启动** 在固件层工作，并会完全阻止未签名的操作系统
* **VergeOS 启动完整性** 在启动过程中验证 VergeOS 镜像；如果镜像被修改或篡改，则会拒绝完成启动

对生产环境而言，这提供了等效的实际安全性。任何修改 VergeOS 系统文件的尝试都会被检测到并阻止启动。物理安全控制应与软件层面的完整性验证相辅相成。

### 硬件老化测试

在安装前，完成硬件老化测试以识别早期故障：

* 确认 BIOS 中可见所有驱动器
* 确认所有网卡都已检测到并显示预期的 MAC 地址
* 如有可用，运行厂商诊断工具（Dell BIST、HPE Insight Diagnostics 等）
* 确认 MAC 地址与你的文档一致

## 启动介质制作

VergeOS 安装包以单个 ISO 镜像形式提供，其中包含完整系统的所有软件包（虚拟机监控器、存储、网络和管理）。每个待安装节点都需要一个可启动 USB 盘。

{% hint style="info" %}
请联系 VergeOS 支持或你的客户团队获取 ISO 下载链接。该 ISO 不公开提供。
{% endhint %}

### Windows——Rufus

1. 下载并启动 [Rufus](https://rufus.ie/en/)
2. 插入一个 USB 盘（其内容将被覆盖）
3. 在以下位置选择你的 USB 设备： **设备**
4. 单击 **选择** 并选择 VergeOS ISO
5. 单击 **开始**
6. **在提示时，选择 DD 模式** ——这至关重要

{% hint style="warning" %}
**DD 模式是必需的**

Rufus 默认使用 ISO 模式，但你 **必须选择 DD 模式** 用于 VergeOS。选择 ISO 模式将导致 **无法启动的 USB 盘**。这是最常见的启动介质错误。
{% endhint %}

### macOS——BalenaEtcher

1. 下载并安装 [BalenaEtcher](https://www.balena.io/etcher/)
2. 插入一个 USB 盘（其内容将被覆盖）
3. 单击 **从文件刷写** 并选择 VergeOS ISO
4. 选择目标 USB 磁盘（请确认你选对了驱动器）
5. 单击 **开始刷写！** 以开始此过程

### Linux——USB 镜像写入器

1. 在文件浏览器中找到已下载的 ISO 文件
2. 右键单击该 ISO 并选择 **制作可启动 USB 盘** （或使用 `dd` 从命令行）
3. 选择 USB 盘作为目标
4. 认证并写入镜像

### 测试启动介质

务必在安装日前测试你的启动介质：

* 从 USB 启动一台测试节点（或一台生产节点）
* 确认 VergeOS 安装程序已加载到内存并进入安装菜单
* 你可以安全地取消安装程序，而不会对系统做出任何更改

## 网络准备

网络配置是最复杂的安装前任务。VergeOS 需要两种不同的网络类型，并且必须在安装开始前配置物理交换机。

### 网络架构概览

```mermaid
graph TB
    subgraph switches["物理交换机基础设施"]
        SW1["交换机 A"]
        SW2["交换机 B"]
    end

    subgraph node1["节点 1"]
        N1C1["网卡 1<br/>核心 Fabric 1"]
        N1C2["网卡 2<br/>核心 Fabric 2"]
        N1E["网卡 3+4<br/>外部（绑定）"]
    end

    subgraph node2["节点 2"]
        N2C1["网卡 1<br/>核心 Fabric 1"]
        N2C2["网卡 2<br/>核心 Fabric 2"]
        N2E["网卡 3+4<br/>外部（绑定）"]
    end

    N1C1 --> SW1
    N1C2 --> SW2
    N1E --> SW1
    N1E --> SW2

    N2C1 --> SW1
    N2C2 --> SW2
    N2E --> SW1
    N2E --> SW2

    style switches fill:#f0f4ff,stroke:#336
```

### 核心 Fabric 网络

核心 Fabric 是一张私有的高速网络，承载 vSAN 存储流量、集群协调和虚拟机迁移。它是 VergeOS 系统的骨干。

**核心 Fabric 的交换机端口要求：**

| 设置       | 值                                       | 原因                |
| -------- | --------------------------------------- | ----------------- |
| **端口模式** | 接入口（未打标签，单 VLAN）                        | 每个核心网络一个 VLAN     |
| **VLAN** | 专用、隔离的 VLAN（例如 Core1 为 900，Core2 为 901） | 必须与所有其他流量隔离       |
| **MTU**  | **9216** （巨型帧）                          | 为提高存储效率并减少租户开销所必需 |
| **生成树**  | 在核心端口上禁用                                | 专用点对点核心链路不需要      |
| **速率**   | 10 Gbps 或更高                             | 生产环境的最低建议         |

{% hint style="warning" %}
**关键：不要绑定核心 Fabric 网卡**

端口绑定（LAG/LACP）必须 **不** 用于核心 Fabric 网络。VergeOS 通过在不同交换机上使用两套独立的核心 Fabric 网络（Core1 和 Core2）来构建冗余。绑定会干扰这种内置冗余模型。
{% endhint %}

**每台核心交换机必须使用专用 VLAN** ——例如，Core Fabric 1 使用 VLAN 900，Core Fabric 2 使用 VLAN 901。这些 VLAN 必须与外部流量完全隔离。

### 外部网络

外部网络将虚拟机和工作负载连接到用户、互联网以及现有基础设施。

**外部网络的交换机端口要求：**

| 设置       | 值                  | 原因             |
| -------- | ------------------ | -------------- |
| **端口模式** | Trunk（多个 VLAN）     | 支持管理和工作负载 VLAN |
| **VLAN** | 按需提供管理 + 工作负载 VLAN | 只中继所需的 VLAN    |
| **MTU**  | 1500（标准）           | 除非工作负载需要巨型帧    |
| **绑定**   | LACP 或主备（可选）       | 建议用于冗余         |

### 网卡识别

安装前，将每块物理网卡映射到其预定角色：

* **最低要求：** 每个节点 2 块网卡——1 块核心 Fabric + 1 块外部（强烈建议再配一块核心 Fabric 网卡，但不是必需）
* **建议：** 每个节点 4 块或更多网卡（2 块核心 + 2 块外部用于绑定）
* 记录每块网卡的 MAC 地址和物理端口位置
* 确认 SFP 模块同时受网卡和交换机支持

### IP 地址规划

安装前分配并记录以下内容：

* **UI/管理 IP 地址** （静态，CIDR 格式——例如， `10.0.0.2/24`)
* **默认网关** IP 地址（测试其是否可达/可 ping 通）
* **DNS 服务器** 地址（至少一个，建议两个）
* **核心 Fabric VLAN** （两个专用 VLAN，已记录）
* **外部网络 VLAN** （管理 + 任何工作负载 VLAN）

## 文档要求

安装前进行充分文档记录可避免延误并简化故障排除。请准备以下内容：

### A-B 线缆映射

记录每个节点上的哪块网卡连接到哪台交换机和端口。为每根线缆两端都贴标签。

### 机柜布置图

记录机柜中每个节点、交换机和 PDU 的物理位置。

### 网络设计图

第 2 层（VLAN 分配、中继/接入口）和第 3 层（IP 子网、网关、路由）图示。

### IP 分配表

将所有 IP 地址、CIDR 掩码、网关、DNS 服务器和 VLAN ID 汇总在一份参考文档中。

## 规划决策

安装前必须做出若干决策，因为之后不易更改：

### 加密（不可逆）

VergeOS 支持 **AES-256 静态加密** 用于 vSAN。此决策在安装期间作出，并且 **安装后无法更改** ——从加密切换到未加密（或相反）都需要完全重新安装。

如果启用加密：

* 准备一个加密密钥密码短语（8--64 个字符）
* 准备一个 **每个控制器节点一个 USB 盘** （N+1 系统中的节点 1--2；N+2 系统中的节点 1--3）用于存储加密密钥（强烈推荐）。其他（横向扩展）节点不需要密钥盘。操作员也可以在控制器节点的启动提示符处输入密码短语。
* 将密码短语安全地存储在你的密码管理系统中

### RAM 保留偏好

在安装规划期间，在两种方法之间做出选择：

| 方法              | 权衡                              |
| --------------- | ------------------------------- |
| **更多可用内存**      | 为工作负载分配更多 RAM，接受略微降低的 HA 故障切换能力 |
| **更严格的 N+1 HA** | 为故障切换场景保留更多 RAM，减少可用工作负载内存      |

此设置可在安装后配置，但应提前规划，以满足你的 SLA 要求。

### 安装时间表

* **预计时间：** 4--8 小时，取决于节点数量和配置复杂度
* 与相关方安排维护窗口
* 确保在整个窗口期间都能使用 IPMI/远程访问，并有现场人员待命
* 准备好 VergeOS 支持联系信息

## 安装前最终检查（提前 24 小时）

在计划安装前 24 小时内，执行以下最终验证：

* [ ] 所有硬件已物理安装、已通电并通过老化测试
* [ ] 所有网络线缆已连接并通过“拉拽测试”
* [ ] 交换机配置已完成、已测试并已保存（`write mem`)
* [ ] 所有节点的 IPMI 均可访问
* [ ] 所需 IP 地址可用且不与现有基础设施冲突
* [ ] 已在核心 Fabric 交换机端口上验证巨型帧（MTU 9216+）
* [ ] 启动介质已测试并就绪
* [ ] 每个节点的 BIOS 中都可见所有驱动器
* [ ] 每个节点的 BIOS 中都可见所有网卡
* [ ] MAC 地址已与文档核对确认
* [ ] 所有节点 BIOS 中的日期/时间正确
* [ ] 所有节点均已启用虚拟化设置
* [ ] 管理网络上没有冲突的 DHCP 服务器（如果使用 DHCP）

## 摘要

| 类别       | 关键项目                                                     |
| -------- | -------------------------------------------------------- |
| **硬件**   | 64 位 CPU，支持 VT-x/AMD-V，16 GB+ RAM，HBA 或 JBOD 模式，IPMI 已配置 |
| **BIOS** | UEFI（全 NVMe 必需），已启用虚拟化，已禁用安全启动，时钟已同步                     |
| **启动介质** | 来自 VergeOS 支持的 ISO、Rufus（DD 模式）或 BalenaEtcher，并已在安装日前测试  |
| **网络**   | 核心 Fabric：专用 VLAN、MTU 9216、无绑定。外部：中继端口、可选 LACP 绑定        |
| **文档**   | 线缆映射、机柜布置图、网络图、IP 分配表                                    |
| **决策**   | 加密（是/否，不可逆）、RAM 保留偏好、安装时间表                               |

## 下一步

在所有前提条件都已验证并掌握文档后，你就可以继续进行控制器安装： [**控制器安装 →**](/learn-the-platform/zh/mo-kuai-3-an-zhuang/02-controller-installation.md)


---

# 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/learn-the-platform/zh/mo-kuai-3-an-zhuang/01-pre-installation.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.