Homepage로 홈랩 서비스 대시보드 한 화면에 모으기

홈랩 서비스가 3개일 때는 북마크 폴더 하나로 충분해요. 그런데 10개, 20개를 넘어가면 이야기가 달라져요. 어떤 서비스가 어느 포트에 떠 있는지, 지금 정상 작동 중인지조차 기억하기 어려워지거든요. Homepage는 이 흩어진 서비스들을 하나의 화면으로 모아주는 대시보드예요. 그렇다면 이 대시보드 하나로 홈랩 관리가 실제로 얼마나 편해질까요?

Homepage는 정확히 무엇을 해결하는 도구일까?

Homepage는 자체 호스팅한 모든 서비스의 링크와 실시간 상태를 하나의 시작 페이지에 모아 보여주는 대시보드 애플리케이션으로, 브라우저를 열자마자 접속하는 홈 화면 자체를 홈랩의 관제탑으로 바꿔주는 역할을 해요. 단순히 링크 모음집에 그치지 않고, 각 서비스의 API와 연동해서 CPU 사용률이나 다운로드 진행 상황 같은 정보까지 카드 위젯 형태로 실시간 표시할 수 있다는 점이 핵심 차별점이에요. Docker Compose로 홈랩 스택을 구성했다면 도커 소켓만 연결해줘도 실행 중인 컨테이너를 자동으로 탐지해서 서비스 목록에 반영해줘요.

왜 GUI 대신 YAML 설정을 고집할까?

Homepage는 별도의 설정 화면 없이 services.yaml, widgets.yaml 같은 파일을 직접 편집하는 방식을 기본 철학으로 삼고 있어요. 처음에는 번거로워 보이지만 이 방식 덕분에 대시보드 설정 전체를 Git으로 버전 관리할 수 있다는 실질적인 이점이 생겨요. 서비스를 추가하거나 배치를 바꿀 때마다 커밋 이력이 남고, 실수로 설정을 망가뜨려도 이전 커밋으로 즉시 되돌릴 수 있으니까요. 그룹과 카테고리도 YAML 구조 그대로 반영되기 때문에, 미디어 서버·모니터링·네트워크 도구처럼 용도별로 서비스를 깔끔하게 분류해둘 수 있어요.

서비스 상태는 어떻게 실시간으로 보여줄까?

각 서비스마다 API 키를 발급받아 Homepage 설정에 등록하면, 단순한 링크였던 카드가 살아있는 위젯으로 바뀌어요. 예를 들어 Uptime Kuma로 서비스 가동 상태를 모니터링하고 있다면 그 데이터를 Homepage 카드에 그대로 끌어와 업타임 퍼센트를 한눈에 볼 수 있고, Portainer로 관리하는 도커 컨테이너의 리소스 사용량도 별도 창을 열지 않고 대시보드에서 바로 확인할 수 있어요. 이렇게 여러 서비스의 핵심 지표를 한 화면에 모아두면, 문제가 생겼을 때 어느 서비스부터 확인해야 할지 판단하는 시간 자체가 크게 줄어들어요.

모니터링 도구와는 어떻게 역할을 나눠야 할까?

Homepage가 “지금 이 순간의 요약”을 보여주는 데 특화되어 있다면, Grafana와 Prometheus 조합은 시계열 데이터를 장기간 쌓아 추세를 분석하는 데 강점이 있어요. 두 도구는 경쟁 관계가 아니라 서로 다른 시간 축을 담당하는 보완 관계예요. Homepage 대시보드에서 이상 징후를 먼저 포착하고, “지난 한 달간 이 서버의 메모리 사용량이 왜 계속 늘었는지” 같은 깊이 있는 분석이 필요할 때는 Grafana 대시보드로 넘어가는 흐름이 자연스러워요.

외부에 공개할 때 주의할 점은 뭘까?

Homepage 자체에는 로그인 기능이 내장되어 있지 않기 때문에, 이 대시보드를 인터넷에 그대로 노출하면 누구나 홈랩 서비스 목록과 상태를 볼 수 있게 돼버려요. 반드시 리버스 프록시 앞단에 Basic Auth나 별도 SSO 인증 계층을 추가한 뒤에 외부 접속을 허용해야 하고, 가능하다면 VPN을 통해서만 접근하도록 제한하는 편이 훨씬 안전해요. 홈랩 대시보드는 편의를 위한 도구지, 보안 경계를 대신해주는 도구가 아니라는 점을 꼭 기억해야 해요.

서비스가 하나둘 늘어날 때마다 “이거 어디 있었지” 하고 헤매는 시간이 쌓이면, 결국 관리 자체가 귀찮아져서 방치하는 서비스가 생기기 마련이에요. Homepage 같은 대시보드는 그 진입 장벽을 없애서, 홈랩을 계속 손보고 싶은 마음이 들게 만들어주는 작은 장치예요.