其实不用买群晖、威联通,也能搭出带监控、备份、影音、代码仓库的全家桶。
你那台吃灰的旧台式机,只要能跑 Linux,就能被它一键唤醒成「会自己升级、自己修 bug」的家庭数据中心。
不是靠手动敲命令,也不是靠点点点的图形界面——它用的是运维工程师给公司服务器用的那一套逻辑,但降维打到了你家客厅。
替代了哪些付费软件
它不直接对标某一个收费软件,而是绕开了整条付费链路:你本来要花 2000 块买群晖 DS220+,再花 300 块续三年套件会员,还要额外买 Tailscale 订阅、Cloudflare Tunnel 高级功能、Grafana 云监控……
它不卖功能,它卖「省掉所有中间商」的自由。
从功能列表看,它打包了 Gitea(替代 GitLab 私有版)、Jellyfin(替代 Plex Pass)、Paperless(替代 DocuWare 或 Notion AI 文档归档)、Tailscale/WireGuard(替代商业 VPN 网关)、Cloudflare Tunnel(替代付费内网穿透服务)……
价格直接砍到零。
核心功能
- 从一块空硬盘开始,自动装系统、配网络、起 Kubernetes,全程不用你插 U 盘或进 BIOS。官方说这是「bare metal provisioning」,翻译成人话就是:你只管通电,剩下的它全干。具体操作是启用主板的 PXE 启动,连接到项目自带的 DHCP+TFTP 服务,自动下载并安装 Ubuntu 22.04 镜像,连 root 密码和 SSH 公钥都预置好。
- 所有服务——比如电影库、代码托管、文档扫描,都通过 Git 管理配置。改个名字、换台机器、升个版本,全在 GitHub 上点几下就生效,不用登录每台服务器手敲命令。每个服务对应一个 YAML 文件,放在
roles/目录下,比如roles/jellyfin/defaults/main.yml控制画质转码参数,roles/gitea/vars/main.yml设定仓库默认可见性。 - 它会自动给每个服务申请 HTTPS 证书,自动更新 DNS 解析记录,连你家路由器都不用动端口映射。想让家人用手机看 Jellyfin?配好域名,第二天就能打开。证书由内置的 Cert-Manager + Let’s Encrypt 实现,DNS 更新走 Cloudflare API 或本地 Bind9,不需要手动填 IP。
- 支持一键备份整个系统状态,包括容器镜像、数据库、配置文件。万一硬盘坏了,换块新盘重装,三分钟恢复全部服务,连账号密码都不用重设。备份策略定义在
roles/velero/vars/main.yml,可设每天一次快照,保留最近七天,存到本地 NFS 或 S3 兼容存储。 - 自带 Grafana 监控大屏和 Hubble 网络流量图,能看到谁在访问你的 Gitea、哪个容器占了最多内存、Paperless 扫描卡在哪一步。不是摆设,是真能帮你定位问题。Grafana 面板预置了 20+ 个视图,比如「Kubernetes 节点 CPU 使用率」「Jellyfin 并发流数」「Paperless OCR 处理延迟」。
- 所有组件模块化,删掉不想用的(比如 CI/CD 或分布式存储),加回想要的(比如 Home Assistant),只改一行配置就行。不像群晖,卸载一个套件可能牵连五个依赖。开关开关靠
inventory/sample/group_vars/all.yml里的布尔变量,比如enable_homeassistant: false就彻底跳过部署。
怎么开始用
- 去 GitHub 搜索 khuedoan/homelab,点首页绿色按钮「Code → Download ZIP」,解压到一台装好 Ubuntu 22.04 的旧电脑上(必须是 Linux,Windows 或 Mac 不行)。注意:这台电脑得是主控节点,后续所有服务都从它调度,建议至少 8GB 内存。
- 确保这台电脑已装好 Docker 和 Python3,然后按 README 里写的命令运行 ./scripts/install.sh,它会自动检查环境、下载镜像、生成配置模板。脚本还会验证是否启用了 systemd-resolved,避免 DNS 解析失败导致集群初始化中断。
- 编辑 inventory/sample/group_vars/all.yml 这个文件,填上你想要的服务名(比如 jellyfin.myhome.local)、管理员邮箱,保存后运行 make deploy , 等 15 分钟左右,网页就能打开了。部署过程会依次执行:初始化 Ansible 控制节点、拉起 Kubernetes 集群、部署 Cilium 网络插件、加载 Helm Chart、注入 TLS 证书、启动监控栈。
项目信息
khuedoan/homelab
GitHub
Fully automated homelab from empty disk to running services with a single command.
9.7k
Stars
890
Forks
Python
GPL-3.0
你用过类似的免费工具吗?评论区聊聊,我挑几个下期专门写。




