homelab-ops

Homelab-Ops 是一套有完整文档的参考架构，用于在 Proxmox VE 8 下的单台 Intel i5 迷你主机（16GB RAM、256GB NVMe、1TB SATA）上运行自托管 Kubernetes 平台，并在 Oracle Cloud Infrastructure 和 Google Cloud Platform 中配备支撑性云资源。 README 中描述的关键能力： - 网络：Cloudflare Zero Trust Anycast 隧道（cloudflared）提供仅出站的 QUIC 入口，避免在 CGNAT 后进行端口转发；Traefik 负责集群内路由。Tailscale 临时网状网络用于管理访问和 CI runner。 - GitOps 交付：Flux CD v2 配合 Kustomize 从 Git 协调平台层和应用层，并按依赖顺序执行（平台先于应用）。Mozilla SOPS 配合 Age 在 Git 中加密密钥，并在集群内解密。 - 存储与数据：双层存储将 NVMe 用于操作系统、K3s 状态和 PostgreSQL，与用于文档和媒体的 1TB SATA 磁盘分离。CloudNativePG operator 管理 PostgreSQL 生命周期、故障转移和 WAL 归档。 - 韧性：一台独立的 OCI VM 运行 Uptime Kuma，用于带外健康检查；Terraform state 存储在 OCI 对象存储中并启用远程锁定；每晚进行加密的 Restic 备份，遵循 3-2-1 规则。 - 应用组合：cloudflared、CloudNativePG、Homepage、Prometheus/Grafana、kwatch、MkDocs 文档、n8n、一个 PDF 生成器微服务、Paperless-ngx、BookOrbit、Audiobookshelf、Miniflux、Linkding 以及 Ryot/wger。 - 文档：16 份 ADR、七份执行阶段手册，以及涵盖 Proxmox 设置与恢复、Terraform 模块化、密钥注入、K3s 优化和 WAN 调试的工程指南。 该仓库主要是一个基础设施即代码与文档项目（Terraform、Ansible、Kubernetes manifests），而不是打包应用。它适合平台工程师和 homelab 运维人员，作为在受限硬件上实践 GitOps、零信任入口和混合云韧性的完整示例。