Higangssh/homebutler

어떤 프로젝트인가요?

핵심 기능

• 01마지막 실행 이후 달라진 내용만 JSON으로 보여 주는 스냅샷 기반 `report`
• 02리소스 부족, 외부 공개 포트, 백업 상태를 확인하는 읽기 전용 `doctor` 점검
• 03Docker, systemd, PM2 재시작 감지 및 로그 저장과 재시작 반복 알림
• 04격리된 컨테이너에서 백업 아카이브를 부팅하고 HTTP 헬스를 확인하는 `backup drill`
• 05docker compose를 통한 셀프 호스팅 앱 원클릭 설치
• 06MCP 서버, 웹 대시보드, 터미널 대시보드 내장

활용 사례

• 업데이트나 재시작 후 홈 서버에서 무엇이 바뀌었는지 확인
• 필요한 시점이 오기 전에 백업을 실제로 복원할 수 있는지 검증
• SSH 셸 접근 권한을 주지 않고 AI 어시스턴트가 서버 상태를 확인하도록 하기
• 소형 Linux 호스트나 Raspberry Pi에서 컨테이너 재시작 및 크래시 반복 모니터링

빠른 시작

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는 Linux 및 macOS 서버용 홈랩 운영 도구입니다. `report` 명령은 컨테이너, 포트, 디스크 사용량의 스냅샷을 저장한 뒤 실행할 때마다 이전 스냅샷과 비교해 같은 이름으로 다시 생성된 컨테이너, 다른 프로세스가 차지한 포트, 비교할 수 없었던 항목처럼 달라진 내용만 보여 줍니다. 각 변화에는 고정된 종류 식별자가 붙고, JSON 출력에도 포함되므로 스크립트와 에이전트가 이를 기준으로 분기할 수 있습니다.

homebutler은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

homebutler은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

homebutler은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. homebutler의 마지막 커밋은 2026년 11월 1일입니다.

homebutler은(는) 어디에 사용할 수 있나요?

업데이트나 재시작 후 홈 서버에서 무엇이 바뀌었는지 확인 필요한 시점이 오기 전에 백업을 실제로 복원할 수 있는지 검증 SSH 셸 접근 권한을 주지 않고 AI 어시스턴트가 서버 상태를 확인하도록 하기 소형 Linux 호스트나 Raspberry Pi에서 컨테이너 재시작 및 크래시 반복 모니터링

homebutler는 어떻게 설치하나요?

Homebrew로 설치: brew install Higangssh/homebutler/homebutler 대화형 설정을 실행해 서버 추가: homebutler init 현재 서버 상태 확인: homebutler status 상태 및 변경 사항 보고서 생성: homebutler report

homebutler은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Higangssh/homebutler