> 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/can-kao-jia-gou/homelab.md).

# VergeOS 家庭实验室参考架构

## 概述

VergeOS 是家庭实验室爱好者的理想解决方案，提供了一个强大而灵活的虚拟化平台。本参考架构涵盖三种适用于各种家庭实验室部署的配置：单节点 VM 主机、双节点集群，以及带多层存储的生产级家庭实验室集群。

### 硬件建议

家庭实验室用户在 VergeOS 硬件方面有多种选择。许多人会选择上一代企业级服务器（例如 Dell、HP、Supermicro），因为它们可靠且可扩展。

像 Intel NUC 或类似迷你 PC 这样的紧凑型设备也是很受欢迎的选择，尤其是那些提供双 2.5GbE 网络、NVMe 插槽和 2.5 英寸 SSD 托架的设备。

**关键注意事项：**

* **RAID 配置：** VergeOS 需要直接访问磁盘，因此如果使用 RAID 控制器，请确保它支持 JBOD/IT 模式，或者改用 HBA。
* **IPMI 要求：** 虽然 VergeOS 建议使用 IPMI，但家庭实验室部署通常可以不使用。不过，某些 NVIDIA GPU 或 GPU 直通方案可能会禁用控制台访问，因此 IPMI 对管理这些配置会很有帮助。

***

## 场景

### 1. 单节点 VM 主机

这是一个适合测试环境的直接配置，单节点 VM 主机适用于探索 VergeOS 功能、试验虚拟机以及开发新 recipe 的用户。

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

VergeOS 的 vSAN 配置为 N+1，提供冗余。这种设置会将可用存储减少到原始容量的 50%，因此应相应规划存储需求。
{% endhint %}

**网络配置：**

由于此设置不涉及其他 VergeOS 节点，因此请将核心通信和外部通信都使用同一个网络，以简化配置。

**使用场景：**

* 托管测试 VM
* 测试 VergeOS recipe 和配置
* 通用家庭实验室实验

***

### 2. 双节点集群

此配置通过引入第二台服务器增加了冗余，确保在重启和升级期间服务持续运行。

{% hint style="warning" %}
**网络要求**

每台服务器需要两个网络接口，核心网络速度至少应为 2.5Gbps，以获得最佳性能。虽然 1Gbps 也可行，但可能会限制 vSAN 性能。
{% endhint %}

**使用场景：**

* 运行高可用性的 VM 环境
* 在集群环境中进行开发和测试
* 增强的存储和网络冗余

***

### 3. 家庭生产集群

这是一个适合高级家庭实验室用户的生产级双节点集群，此配置不仅通过多层存储增强了存储能力，还支持强大的网络管理、NAS 部署以及面向家庭和家庭实验室环境的 GPU 支持。

此设置使 VergeOS 能够作为强大的中央枢纽，管理网络流量、NAS 服务、GPU 资源，并在整个网络中提供安全、流畅的访问。

**存储层级：**

* **层级 1（NVMe）：** 用于需要高 I/O 性能的 VM 工作负载的高速存储。
* **层级 3（SSD）：** 用于 NAS、需求较高的数据或共享 VM 存储的中速存储。
* **层级 5（HDD）：** 用于 NAS 和备份服务器 VM 的大容量存储。

**网络和 VLAN 配置：**

将 VergeOS 作为实验室和家庭 LAN 的主路由器和网络管理器。此设置需要一台支持 VLAN 的交换机，您可以将 ISP 网络分配到某个 VLAN（例如 VLAN 50），并根据需要将 LAN 配置为默认 VLAN 或其他附加 VLAN。

* **外部 WAN：** 连接到 ISP，并被分配为一个 VLAN。
* **外部（LAN）：** 作为家庭实验室和个人网络，使家庭网络中的设备能够访问 VergeOS 环境中的资源。

{% hint style="success" %}
**安装说明**

在安装期间，请使用您的 **LAN** 网络作为初始外部网络。安装完成后，再添加 WAN 网络以实现互联网连接。有关详细说明，请参阅 [关于创建外部网络的知识库文章](https://docs.verge.io/knowledge-base/create-external-network/).
{% endhint %}

**NAS 服务：**

为了为您的家庭环境设置一个稳健的 NAS，VergeOS 提供了内置 NAS 服务，非常适合管理具有高容量和冗余的共享存储。

有关配置和部署 NAS 服务的分步说明，请参阅 [NAS 服务产品指南](/run-the-platform/zh/nas/nas-service.md)。其他配置选项和故障排除步骤见 [知识库](https://docs.verge.io/knowledge-base/category/nas/#troubleshooting-nas-cifs-shares).

**GPU 支持：**

对于需要增强图形能力的用户，VergeOS 支持 GPU 直通和 NVIDIA vGPU。这些选项允许虚拟机使用专用或共享 GPU 资源：

* **GPU 直通：** 为 VM 提供直接的 GPU 连接，适用于高性能应用。请参阅 [PCI 直通产品指南](/run-the-platform/zh/xi-tong-guan-li/generic-pci-passthrough.md).
* **NVIDIA vGPU：** 允许多个 VM 共享访问 GPU，从而高效利用 GPU 资源以处理较低强度的任务。请参阅 [NVIDIA vGPU 产品指南](/run-the-platform/zh/xi-tong-guan-li/nvidia-vgpu-configuration.md).

**使用场景：**

* 托管多层 VM 环境
* **冗余的大容量 NAS 设置** 用于集中、可靠的文件存储
* 作为家庭网络路由器和防火墙，为所有已连接设备提供安全性和集中管理
* 使用专用 GPU 资源的高性能 VM 应用，或使用共享 vGPU 进行可扩展图形处理

***

## 有用链接

* [VM 配方](/automate-protect-and-extend/automation/vm-recipes.md)
* [系统快照](/automate-protect-and-extend/backup-and-dr/system-snapshots.md)
* [vSAN 首选层级](/run-the-platform/zh/cun-chu/preferred-tiers.md)
* [VPN](/run-the-platform/zh/vpn/vpn-overview.md)
* [网络概览](/run-the-platform/zh/wang-luo/network-overview.md)
* [许可](/run-the-platform/zh/xi-tong-guan-li/licensing-and-updates.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/plan-and-deploy/zh/can-kao-jia-gou/homelab.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.
