homebutler
🏠 告訴你伺服器上發生了什麼變化——只告訴你值得知道的。單一Go二進位檔,無需資料庫,監控的機器上無需執行任何程式。內建MCP伺服器。
homebutler 是什麼?
🏠 告訴你伺服器上發生了什麼變化——只告訴你值得知道的。單一Go二進位檔,無需資料庫,監控的機器上無需執行任何程式。內建MCP伺服器。
homebutler 概覽
這是什麼
HomeButler 是一個單一的 Go 二進位檔,它會記住伺服器上次的狀態,並告訴你(或 AI 代理)哪些東西變了。它不需要常駐程式、不需要資料庫,也不需要在被監控的機器上執行任何東西。它提供一個狹窄但結構化的介面來存取伺服器,回傳可讀的摘要與 JSON,而非完整的 SSH 殼層。
主要功能
- 單一 Go 二進位檔,無資料庫,無需在被監控機器上安裝代理(透過 SSH 執行) - 以八種變更類型報告差異:gone、new、replaced、image、state、port、disk、skipped - 內建 MCP 伺服器,供 AI 代理整合 - 透過
backup drill驗證備份:在隔離容器中啟動備份封存,並要求 HTTP 健康檢查 - 醫生檢查:唯讀的預檢,檢查資源壓力、已停止容器、備份衛生等 - 一鍵安裝自架應用(Uptime Kuma、Jellyfin、Pi-hole、Gitea、Portainer 等) - 終端儀表板(watch tui)與網頁儀表板(serve)
使用情境
- 回答伺服器目前正在執行什麼 - 找出哪個容器佔用了特定連接埠 - 偵測某個服務為何在凌晨 3 點重新啟動 - 驗證備份是否真的可以還原 - 讓 AI 助理檢查伺服器,而不需給予完整的 SSH 殼層 - 從中央中樞監控多台機器的變更
快速開始
bash # 一行安裝(自動偵測 OS/架構) curl -fsSL https://raw.githubusercontent.com/Higangssh/homebutler/main/install.sh | sh # 或透過 Homebrew brew install Higangssh/homebutler/homebutler # 或作為容器執行 docker run -d -p 8080:8080 -v ~/.config/homebutler:/config -v ~/.ssh:/root/.ssh:ro ghcr.io/higangssh/homebutler serve --host 0.0.0.0 --token $(openssl rand -hex 16) # 互動式設定 homebutler init # 立即使用 homebutler status homebutler docker list homebutler inventory scan homebutler report homebutler install uptime-kuma homebutler backup drill uptime-kuma homebutler watch tui homebutler serve
授權與價格
授權:MIT。價格:開源(免費)。
內容整理自該專案公開的 README 與儲存庫資訊。