Higangssh/homebutler

这是什么？

核心功能

• 01基于快照的 `report` 命令，只列出自上次运行以来的变化，并支持 JSON 输出
• 02只读的 `doctor` 检查，涵盖资源压力、对外端口和备份状况
• 03监控 Docker、systemd 与 PM2 的重启，保存日志并识别反复重启
• 04`backup drill` 在隔离容器中启动备份并进行 HTTP 健康检查
• 05通过 docker compose 一条命令安装常见自托管应用
• 06内置 MCP 服务、Web 面板和终端面板

适用场景

• 在更新或重启后，检查家庭服务器上到底改变了什么
• 在真正需要之前，验证备份能否成功恢复
• 让 AI 助手查看服务器状态，而无需授予 SSH 完整权限
• 在小型 Linux 或树莓派主机上监控容器重启与崩溃循环

快速上手

1. 1

   使用 Homebrew 安装

   brew install Higangssh/homebutler/homebutler
2. 2

   运行交互式设置以添加服务器

   homebutler init
3. 3

   查看当前服务器状态

   homebutler status
4. 4

   生成健康与变更报告

   homebutler report

使用前须知

• !从源码构建需要 Go 1.25 或更高版本。
• !监控与报告依赖目标机器上可用的 Docker、systemd 或 PM2。

收录于专题

标签

常见问题

homebutler 是什么？

一个 Go 单文件工具，记住服务器上次的状态，只汇报值得关注的变化，内置 MCP 服务。 HomeButler 是面向家庭服务器（homelab）的运维工具，支持 Linux 和 macOS。`report` 命令会保存容器、端口和磁盘等状态的快照，每次运行时与上一次快照对比，只列出真正发生的变化，例如同名容器被重建、端口被其他进程占用，或某次比对无法完成。每条变化都带有固定的类型标签，JSON 输出中同样包含，方便脚本或 AI 代理据此判断。

homebutler 可以免费使用吗？用的什么许可证？

homebutler 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

homebutler 还在维护吗？

活跃维护中。homebutler 最近一次提交是在 2026年11月1日。

homebutler 适合用来做什么？

在更新或重启后，检查家庭服务器上到底改变了什么 在真正需要之前，验证备份能否成功恢复 让 AI 助手查看服务器状态，而无需授予 SSH 完整权限 在小型 Linux 或树莓派主机上监控容器重启与崩溃循环

homebutler 怎么安装和运行？

使用 Homebrew 安装: brew install Higangssh/homebutler/homebutler 运行交互式设置以添加服务器: homebutler init 查看当前服务器状态: homebutler status 生成健康与变更报告: homebutler report

在哪里获取 homebutler？

源代码和安装说明在 GitHub 上：https://github.com/Higangssh/homebutler