从零开始搭建家庭K8s集群：Proxmox VE单机部署完整指南
项目地址: https://gitcode.com/gh_mirrors/smal/smallab-k8s-pve-guide 想在家拥有属于自己的Kubernetes集群吗？本指南将带你一步步在单台服务器上使用Proxmox VE构建功能完善的K8s家庭实验室，无需复杂硬件，适合新手入门实践。
为什么选择Proxmox VE构建K8s集群？
Proxmox VE是一款开源的虚拟化管理平台，结合了KVM虚拟化和LXC容器技术，非常适合家庭实验室环境。它提供直观的Web管理界面，让你轻松创建和管理虚拟机，为K8s集群搭建提供稳定的底层架构。
准备工作：硬件与系统要求
搭建小型K8s集群的最低硬件配置建议：
- 处理器：支持虚拟化技术的多核CPU（至少4核）
- 内存：至少16GB RAM（推荐32GB以上）
- 存储：至少500GB SSD（用于系统和虚拟机存储）
- 网络：稳定的千兆网络环境
第一步：安装Proxmox VE系统
- 从Proxmox官方网站下载最新ISO镜像
- 通过U盘启动服务器，按照安装向导完成基础配置
- 设置网络、存储和管理员密码
安装完成后，通过浏览器访问Proxmox VE的Web管理界面，开始集群构建之旅。
第二步：配置存储环境
Proxmox VE支持多种存储类型，为K8s集群推荐使用LVM存储：
- 在"Disks"菜单中初始化硬盘
- 创建LVM卷组和逻辑卷
- 配置存储池用于虚拟机镜像和容器存储
详细步骤可参考G005 - Host configuration 03 ~ LVM storage.md
第三步：创建基础虚拟机模板
为K8s节点创建标准化的Debian虚拟机模板：
- 点击"Create VM"按钮
- 配置虚拟机基本信息（ID、名称等）
- 设置操作系统（推荐Debian 11/12）
- 配置CPU、内存和磁盘资源
- 安装操作系统并进行基础优化
创建完成后，将该虚拟机转换为模板，便于快速克隆多个K8s节点。
第四步：部署K3s Kubernetes集群
K3s是轻量级的Kubernetes发行版，非常适合家庭实验室：
- 从模板克隆3台虚拟机作为K8s节点（1个控制平面，2个工作节点）
- 在控制平面节点安装K3s服务器
- 配置工作节点加入集群
- 部署网络插件和基础组件
详细部署步骤可参考G025 - K3s cluster setup 08 ~ K3s Kubernetes cluster setup.md
第五步：配置负载均衡与服务暴露
为了让K8s集群中的服务能够被外部访问，需要配置负载均衡：
- 部署MetalLB负载均衡器
- 配置Traefik作为Ingress控制器
- 设置HTTPS证书管理
这些组件可以通过kustomize部署，相关配置文件位于k8sprjs/目录下。
第六步：部署实用服务
完成基础集群搭建后，可以部署一些实用服务丰富你的家庭实验室：
- Nextcloud：私有云存储解决方案
- Gitea：自托管Git服务
- Prometheus + Grafana：监控系统
- Kubernetes Dashboard：集群管理界面
每个服务的详细部署指南可在对应文档中找到，例如G033 - Deploying services 02 ~ Nextcloud
第七步：设置备份与维护策略
确保你的K8s集群稳定运行：
- 配置Proxmox VE的虚拟机备份任务
- 设置Kubernetes资源的定期备份
- 制定系统更新和维护计划
备份配置可参考G039 - Backups 03 ~ Proxmox VE backup job.md
结语：你的家庭K8s实验室
通过本指南，你已经拥有了一个功能完善的K8s家庭实验室。这个平台不仅可以用于学习和测试，还能部署实际应用服务。随着你的技术提升，可以逐步扩展集群规模，尝试更复杂的Kubernetes特性。
开始你的K8s之旅吧！遇到问题时，可以查阅项目中的详细文档或在社区寻求帮助。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
