Eden：一套以 GitOps 管理的 Kubernetes 家庭实验室

项目用途

Eden 是 mortennordbye/homelab 的个人家庭实验室基础设施项目，目标不是提供一个面向大众的一键式服务，而是记录如何在家中实验基础设施模式、运行自托管服务，并把配置公开纳入版本控制。项目以 Kubernetes 为运行平台，使用 Talos Linux、Argo CD 和 Terraform 组成主要管理链路。

从 README 描述看，Terraform 负责在 Proxmox 上构建 Talos 虚拟机；此后，配置通过 Git 进入环境，Argo CD 持续协调 k8s/talos/ 下的内容。仓库还使用 ApplicationSets 按目录生成 Argo CD Application，因此新增工作负载的组织方式是增加目录，而不是手工维护一份集中清单。

已知功能与组件

项目覆盖的不只是应用清单，还包括架构、集群、网络、存储、身份、交付、备份、数据、可观测性和密钥管理文档。README 表示，文档源位于 docs/，每次推送到 main 后构建文档站，这对希望追踪“配置如何落地”的读者比较有价值。

其技术栈包含 Cilium 网络、通过 Gateway API 使用的 Traefik、cert-manager、Cloudflare 方向的 external-dns，以及 Falco、Authentik 和 External Secrets Operator。可观测性部分列出 Prometheus、Alertmanager、Grafana、Loki、Tempo 与 metrics-server；弹性方面使用 KEDA HTTP add-on，让部分空闲应用缩到零，并在请求到达时唤醒。README 还列出 Proxmox CSI、NFS CSI 和 PostgreSQL 等存储与数据组件。

项目也包含博客、作品集、媒体栈及其他应用目录。官方 release 说明显示，原 Portfolio V1 静态站点已经退役，改由 Next.js 重写版本取代；旧快照保留用于回滚。这意味着读者应把仓库视为持续演进的参考环境，而不是稳定的软件发行包。

适合谁

它适合已经了解 Linux、虚拟化、容器和 Kubernetes 基本概念，并希望研究 GitOps、集群交付、基础设施即代码或家庭环境可观测性的工程师。对想学习如何把平台组件、应用、文档和 CI 流程放进同一仓库的人，也有较强参考价值。

如果你的目标只是快速运行一个媒体服务或单个自托管应用，Eden 可能过于复杂。它把 Proxmox、Talos、Kubernetes、Terraform、Argo CD、网络入口、证书、DNS、密钥和监控放在一条链路中，学习和维护成本显然高于单机容器方案；来源没有给出最低硬件配置或完整的通用安装步骤，采用前不能据此推断可直接复刻。

采用前的限制与部署考虑

首先要评估现有硬件、虚拟化平台和网络条件，因为项目明确围绕 Proxmox 与 Talos 虚拟机设计。其次，GitOps 会把代码仓库变成运行环境的重要控制面：目录结构、凭据获取、CI 推送、Argo CD 协调和回滚流程都需要理解。External Secrets Operator 的运行时取密方式减少了将凭据提交到仓库的需要，但具体密钥服务、权限边界和故障处理仍需按自身环境验证。

README 列出的安全扫描和运行时检测说明了项目的防护思路，但不能等同于对任何部署的安全保证。来源也未确认所有组件的版本、升级策略、资源需求或恢复目标。建议在采用前逐项阅读官方文档与仓库文档，先在隔离环境验证网络、存储、证书、DNS、备份和集群恢复流程，再决定哪些模式值得迁移。仓库元数据显示项目未归档，许可证为 Apache License 2.0；但具体文件的适用范围仍应由使用者核对。

资料来源

• GitHub repository metadata
• Project README
• Official release
• Official project page

资料核对日期：2026-09-28