Higangssh/homebutler

해결하는 문제

HomeButler는 홈랩 유지 관리의 "지저분한 중간 지점"을 해결합니다. 서버는 시간이 지남에 따라 드리프트되어 관리하기 어려워집니다. 마지막으로 확인한 이후 서버에서 무엇이 변경되었는지 알 수 없는 문제를 해결하여 서비스가 재시작되는 이유, 포트가 잘못된 프로세스에 점유되었는지, 백업이 실제로 복원 가능한지 식별하는 데 도움을 줍니다.

작동 방식

Go 바이너리로, 상주 데몬이나 데이터베이스 없이 운영 도구 키트로 작동합니다. 서버 상태(컨테이너, 포트, 프로세스)의 스냅샷을 찍어 이전 기준선과 비교합니다. 변경 사항(예: "새로 추가", "사라짐", "교체됨")에 대한 구조화된 버틀러 스타일 보고서를 제공하며, 사전 점검을 위한 "doctor" 명령과 백업이 성공적으로 부팅되고 상태 점검을 통과할 수 있는지 확인하는 "drill" 기능을 포함합니다.

대상 사용자

서버를 모니터링하기 위한 명확하고 구조화된 인터페이스를 원하는 자체 호스팅 사용자와 홈랩 애호가를 위한 것입니다. 또한 모든 진단 및 모니터링 기능에 대해 기계가 읽을 수 있는 JSON 출력을 제공하므로 AI 에이전트나 자동화 스크립트에서 사용하도록 설계되었습니다.

주요 기능

• 변경 감지: 컨테이너 재생성, 이미지 업데이트 또는 포트 소유권 변경과 같은 변경 사항을 자동으로 식별하고 분류합니다.
• 백업 검증: 격리된 컨테이너에서 백업을 부팅하여 기능을 확인하는 drill 명령을 포함합니다.
• 에이전트 친화적: MCP(모델 컨텍스트 프로토콜) 또는 CLI를 통해 AI 에이전트가 사용할 수 있도록 설계되어 전체 SSH 셸 액세스 없이 구조화된 데이터를 제공합니다.
• 데몬 불필요: SSH를 통해 실행되는 독립 실행형 도구로 작동하여 서버 공간을 최소화합니다.
• 충돌 분석: Docker, systemd 및 PM2 서비스를 모니터링하여 로그를 캡처하고 OOM(메모리 부족) 또는 세그멘테이션 오류와 같은 충돌 원인을 분석합니다.