개발자가 Go로 15MB 단일 바이너리 homelab 관리 도구를 개발해 SSH 세션 다중화와 컨테이너 배포 자동화 구현

Context

Homelab 운영자는 여러 서버를 개별 SSH 접속으로 관리했다. 각 서버의 상태 확인, 포트 충돌 여부, 디스크 사용량을 파악하려면 수십 개의 수동 명령어 실행이 필요했다. 백업 체계와 모니터링 부재로 인해 SD 카드 손상 같은 장애 발생 후 며칠 뒤에야 감지하는 상황이 발생했다.

Technical Solution

• Go 단일 바이너리 구축: Linux/macOS (ARM + x86)에 교차 컴파일된 15MB 실행 파일로 Docker와 데이터베이스 없이 동작
• 초단위 앱 설치 자동화: 간단한 명령어로 Docker 실행 여부 확인, 포트 가용성 검증, docker-compose 생성, 이미지 다운로드, 컨테이너 시작을 자동 수행
• MCP 기반 AI 통합: Claude, ChatGPT, Cursor에 연결하여 자연어 명령으로 homelab 제어 가능하게 구현 (선택 사항)
• 내장 웹/TUI 대시보드: go:embed로 바이너리에 번들링해 전체 시스템을 단일 파일로 배포
• 초기화 마법사: 설정 파일 수작성 대신 대화형 init 명령어로 구성

Impact

앱 설치 시간을 30초로 단축했다.

Key Takeaway

단순한 운영 도구를 구현할 때는 프레임워크 의존성을 최소화하고 Go의 net/http 같은 표준 라이브러리만 활용해도 충분하다. 배포 복잡성을 제거하면 사용자 진입장벽을 획기적으로 낮출 수 있다.