Atom Homepage 소개: 모든 것을 위한 셀프 호스팅 대시보드

발행: 1개월 전 (2025년 12월 13일 오후 07:23 GMT+9)

8 분 소요

Source: Dev.to

해결하고 싶었던 문제

많은 개발자와 셀프‑호스팅 사용자들처럼, 나는 Docker 컨테이너, 웹 앱, Sonarr, Radarr, Pi‑hole 같은 내부 도구 등 수십 개의 서비스를 서로 다른 포트와 서브도메인에 흩어져서 운영하고 있었다. URL을 기억하고, 서비스가 정상인지 확인하며, 시스템 리소스를 모니터링하려면 여러 브라우저 탭과 터미널을 오가야 했다.

나는 깔끔하고 빠르며 실제로 유용한 무언가가 필요했다. 단순한 북마크 관리자를 넘어, 내 홈랩을 위한 진정한 커맨드 센터가 필요했다.

Atom이 다른 점은?

🎯 실제로 동작하는 스마트 검색

검색창은 단순히 앱을 필터링하는 것이 아니라 컨텍스트를 이해한다. 타이핑을 시작하면 즉시 애플리케이션과 북마크를 필터링한다. 일치하는 항목이 없으면 자동으로 웹 검색(Google, DuckDuckGo, Bing 중 선택)으로 전환한다.

어디서든 / 를 눌러 검색으로 바로 이동한다. 정말 빠르다.

📊 실시간 서비스 모니터링

모든 서비스 카드에 실시간 가동 상태가 시각적인 ping/HTTP 지표로 표시된다.
시스템 모니터 위젯은 CPU, 메모리, 디스크, 네트워크 통계를 3초마다 자동 새로고침한다.

무언가 다운되면 즉시 알 수 있다.

🐳 완전한 Docker 제어

Docker를 사용하고 있다면(누가 안 쓰겠어?), Atom은 컨테이너 관리를 완벽하게 제공한다:

Docker Management

실시간 통계가 표시되는 컨테이너 대시보드
한 번 클릭으로 컨테이너 시작 / 정지 / 재시작
브라우저에서 직접 터미널 열기
자동 스크롤이 지원되는 실시간 로그 스트리밍
포트 매핑 및 리소스 사용량을 한눈에 확인
홈페이지에 표시되는 컨테이너 수 위젯

대시보드나 SSH 접속 없이 모든 작업을 수행한다.

🔌 사전 구축된 통합

Atom은 인기 있는 셀프‑호스팅 앱을 위한 템플릿을 제공한다:

Sonarr / Radarr – 미디어 관리 통계
Pi‑hole – DNS 및 광고 차단 메트릭
Glances – 고급 시스템 모니터링
Tautulli – Plex 시청 통계
Generic JSON API – 무엇이든 연결 가능

API 문서를 뒤적일 필요 없이 프리셋을 선택하고 API 키만 입력하면 된다.

⚡ 유연한 모든 것

세 가지 레이아웃 모드가 다양한 사용 사례에 최적화되어 있다:

6‑컬럼 그리드 – 최대 밀도
4‑컬럼 그리드 – 큰 카드용
리스트 뷰 – 컴팩트 정리

키보드 단축키(1, 2, 3)로 전환 가능. 다크/라이트 테마. 위젯 시스템 커스터마이징. 당신만의 대시보드, 당신만의 방식.

기술 스택

Next.js 15 + 서버‑사이드 렌더링
React UI
SQLite 데이터 영속성
Docker 손쉬운 배포
bcrypt 보안 인증

전체 스택은 최소 하드웨어에서도 효율적으로 동작하도록 설계되었다—Raspberry Pi나 홈랩 서버에 최적이다.

보안 우선

처음부터 인증이 내장되어 있다:

bcrypt를 이용한 안전한 비밀번호 해싱
HTTP‑only 쿠키
세션 관리
보호된 API 엔드포인트
CORS 및 XSS 방지 헤더

대시보드는 개인적이고 안전하게 유지된다.

키보드 중심 워크플로우

파워 유저라면 키보드 단축키가 마음에 들 것이다:

/ – 검색으로 이동
? – 모든 단축키 보기
s – 설정 열기
1, 2, 3 – 레이아웃 전환
Esc – 모달 닫기

마우스는 줄이고 생산성은 높인다.

시작하기

Docker만 있으면 배포는 매우 간단하다:

docker run -d \
  --name atom \
  -p 3000:3000 \
  -v atom-data:/app/data \
  -v /var/run/docker.sock:/var/run/docker.sock \
  sudheerbhuvana25/atom-homepage:latest

첫 실행 시 온보딩 과정을 안내하고 바로 사용할 수 있다. 복잡한 설정 파일이나 YAML 지옥이 없다.

데이터 이식성

데이터는 내 손에 있다:

설정을 JSON 형태로 내보내기/가져오기
데이터베이스 백업 다운로드
클라우드 락‑인 없음
모든 것이 로컬에서 실행

실제 사용 사례

모니터링 서비스: 15개 이상의 Docker 컨테이너(Plex, Nextcloud, Home Assistant 등)
시스템 모니터링: Raspberry Pi 4 홈랩
위젯: Pi‑hole 통계, Sonarr/Radarr 대기열, 날씨, 시스템 리소스
레이아웃: 한눈에 보기 좋은 6‑컬럼 그리드

네트워크에 연결된 어떤 기기에서도 한 화면에 모든 정보를 확인할 수 있다.

앞으로의 계획

Atom은 현재 활발히 개발 중이며, 다음과 같은 흥미로운 기능이 예정되어 있다:

앱 드래그‑앤‑드롭 재배열
더 많은 사전 구축 통합 프리셋
고급 Docker 관리(Compose 지원)
RSS 피드 위젯
캘린더 통합
모바일 최적 레이아웃

직접 사용해 보기

프로젝트는 오픈소스이며 바로 배포할 수 있다:

GitHub:
Docker Hub:

피드백, 기능 요청, 기여를 언제든 환영한다. 홈랩을 운영하거나 여러 서비스를 관리한다면 Atom을 한번 써보고 의견을 알려줘!

유용하다면 레포지토리에 ⭐를 눌러 주고, 이슈나 PR을 자유롭게 열어 주세요. 최고의 셀프‑호스팅 대시보드를 함께 만들어 가자! 🚀