Khuedoan Homelab 项目部署前的硬件与网络准备指南

前言

Khuedoan Homelab 是一个基于GitOps实践的家庭实验室项目，它提供了一套完整的自动化部署方案。在正式部署之前，我们需要做好充分的准备工作，包括硬件配置、网络设置和BIOS调整等。本文将详细介绍部署Khuedoan Homelab项目所需的前置条件。

项目许可说明

在使用该项目前，您需要了解并同意以下许可条款：

• 本项目采用GPLv3开源许可证
• 您可以自由使用本项目，但不提供任何担保
• 您必须保留原始版权声明和许可文件
• 任何基于本项目的修改也必须保持开源

硬件需求

初始控制节点

初始控制节点是用于引导集群的机器，只需在部署初期使用，可以是您的笔记本电脑或台式机。

要求：

• 运行Linux操作系统
• 支持Docker运行
• 如果使用macOS或Windows，可以通过桥接网络模式的Linux虚拟机实现

服务器节点

任何现代x86_64架构的计算机都可以作为节点，包括旧PC、笔记本电脑或服务器。

每个节点的最低和推荐配置：

额外功能需求：

• 支持PXE网络启动
• 支持远程唤醒功能，用于远程启动机器

网络配置要求

• 所有服务器必须与初始控制节点位于同一有线网络中
• 您需要有权限修改DNS配置(在路由器或域名注册商处)
• 建议购买专属域名，如果没有域名也有替代方案

BIOS设置指南

每台机器需要进行以下BIOS设置(通常需要手动完成)：

通用设置：

• 启用远程唤醒和网络启动功能
• 使用UEFI模式并禁用CSM(兼容性支持模块)模式
• 禁用安全启动(Secure Boot)

启动顺序选项(选择其中一种)：

1. 仅在没有操作系统时从网络启动：兼容性最好，但需要手动擦除硬盘
2. 通过远程唤醒时优先从网络启动：更方便，但需要BIOS支持

参考BIOS配置示例：

设备设置:
  网络配置:
    PXE IPv4: 启用
    PXE IPv6: 禁用
高级设置:
  CPU配置:
    VT-d: 启用
电源管理:
  自动开机:
    远程唤醒: 自动  # 通过远程唤醒时使用网络启动
安全设置:
  安全启动: 禁用
启动设置:
  CSM: 禁用

必要信息清单

在部署前，请收集以下信息：

• 每台机器的MAC地址
• 操作系统磁盘名称(如/dev/sda)
• 网络接口名称(如eth0)
• 为每台机器规划的静态IP地址

专业建议

1. 对于生产环境，建议至少使用3个节点组成高可用集群
2. 如果使用旧硬件，请确保其支持64位UEFI启动
3. 网络稳定性至关重要，建议使用千兆以太网连接
4. 在正式部署前，建议先在小规模环境中测试所有BIOS设置

通过完成以上准备工作，您就为Khuedoan Homelab项目的顺利部署奠定了坚实基础。后续部署过程将会更加顺利，也能更好地发挥该项目的自动化优势。