Uptime Kuma: 내 서버에서 운영하는 가동 시간 모니터링
사이트와 서비스를 1분마다 확인하고 응답이 멈추는 즉시 알려 주는 셀프 호스팅 모니터링 도구입니다.
Uptime Kuma 소개
Uptime Kuma는 개발자 Louis Lam이 시작한 오픈소스 모니터링 도구로, 현재 GitHub에서 가장 많은 스타를 받은 셀프 호스팅 프로젝트 중 하나입니다. HTTP(S) 웹사이트, 페이지 내 키워드, TCP 포트, ping, DNS 레코드, 데이터베이스 등이 응답하는지 확인합니다.
점검에 실패하면 Telegram, Discord, Slack, 이메일, 웹훅 등 지원되는 수십 개 채널 중 하나로 알림을 보냅니다. 응답 시간도 기록하고, TLS 인증서 만료 전에 경고하며, 고객용 공개 상태 페이지도 만들 수 있습니다.
가볍고 무료이며 몇 분이면 설정할 수 있는 깔끔한 인터페이스 덕분에 직접 호스팅하는 경우가 많습니다. 핵심은 별도 서버에서 실행하는 것입니다. 사이트와 같은 머신에 있는 모니터링 도구는 그 머신이 다운되었을 때 알려 줄 수 없기 때문입니다.
주요 활용 사례
사이트 다운 알림
웹사이트와 API를 1분마다 확인하고 응답이 멈추는 즉시 Telegram이나 이메일로 알림을 받으세요.
인증서 만료 경고
고객에게 듣기 전에, HTTPS 인증서가 만료되기 며칠 전에 미리 알림을 받으세요.
공개 상태 페이지
직접 관리하는 페이지에서 서비스의 현재 상태를 고객에게 보여 주세요.
주문 후
서버를 처음 시작하면 Uptime Kuma가 설치되고 방화벽에서 3001번 포트가 열리므로 http://서버-주소:3001/에서 접속할 수 있습니다. 처음 접속할 때 관리자 계정을 만들게 되므로 서버가 준비되는 즉시 주소에 접속하세요. 그다음 첫 모니터를 추가하고 알림 채널을 연결하세요.
어디에서 실행해야 하나요
Uptime Kuma는 실행되는 위치에서 점검합니다. 모니터링하는 서비스와 같은 서버에 있으면 함께 다운되어 경고를 보낼 수 없으므로, 모니터링 대상과 다른 서버에서 실행하세요.
Uptime Kuma에 내 도메인과 HTTPS 연결하기
기본 상태의 Uptime Kuma는 서버 IP 주소에서 일반 HTTP로 응답합니다. status.example.com 같은 이름과 인증서를 사용하려면 DNS에서 해당 이름의 A 레코드를 서버의 IPv4 주소로 지정한 다음, 앞단에 Caddy를 두세요. Caddy는 무료 Let's Encrypt 인증서를 자동으로 발급하고 갱신합니다. 아래 명령은 애플리케이션 서버에서 사용하는 Ubuntu 24.04 기준입니다.
패널에서 서버 방화벽의 TCP 80, 443 포트를 여세요. Caddy가 Let's Encrypt 인증서를 발급받고 사이트를 제공하는 데 필요합니다.
apt install -y caddy
cat > /etc/caddy/Caddyfile <<'EOF'
status.example.com {
reverse_proxy 127.0.0.1:3001
}
EOF
systemctl reload caddy도메인을 연결하면 Uptime Kuma의 상태 페이지를 고객과 공유할 수 있습니다. 상태 페이지를 만들고 표시할 모니터를 선택한 뒤 https://status.example.com/status/your-page 주소를 알려 주세요. 상태 페이지 설정에서 도메인을 해당 페이지에 직접 연결할 수도 있습니다.
도메인이 작동하면 3001번 포트를 직접 열어 둘 필요가 없습니다. /opt/uptime-kuma/compose.yml에서 "3001:…"을 "127.0.0.1:3001:…"으로 바꾸고 docker compose up -d를 실행한 뒤 방화벽에서 3001번 포트를 제거하세요. 이후 Uptime Kuma는 HTTPS로만 접속할 수 있습니다.
Uptime Kuma 업데이트
/opt/uptime-kuma/compose.yml의 이미지는 정확한 버전으로 고정되어 있어 docker compose pull만 실행하면 같은 버전을 다시 받습니다. 업데이트하려면 image: 줄의 버전을 원하는 버전으로 바꾸고(먼저 릴리스 노트를 확인하세요) 이미지를 받은 뒤 컨테이너를 다시 만드세요. 데이터는 Docker 볼륨에 있으므로 그대로 유지됩니다.
cd /opt/uptime-kuma
nano compose.yml # the new version in the image: line
docker compose pull
docker compose up -dUptime Kuma 백업
패널에서 서버 전체의 매일 백업을 켤 수 있으며(요금제 가격의 +20%, 최근 7개 사본 보관), 그중 어느 사본에서든 서버를 복원할 수 있습니다. 그래도 앱 데이터를 파일로 따로 복사해 두는 것이 좋습니다. 다른 서버로 옮기거나 나머지를 모두 되돌리지 않고 복원할 수 있기 때문입니다.
모니터, 알림 설정, 점검 기록은 uptime-kuma_uptime_kuma 볼륨(/app/data)에 있습니다. 데이터베이스 파일이 일관된 상태로 복사되도록 잠시 앱을 중지하세요.
cd /opt/uptime-kuma && docker compose stop
docker run --rm -v uptime-kuma_uptime_kuma:/data -v /root:/backup alpine \
tar czf /backup/uptime-kuma-$(date +%F).tgz -C /data .
docker compose start진행 방식
- 서버 주문 페이지에서 Uptime Kuma을(를) 고르고, 메모리가 충분한 요금제를 선택하세요.
- 앱은 서버의 첫 시작 때 설치되며, 보통 몇 분이면 끝납니다.
- 패널에서 서버를 열면 주소와 로그인 정보가 있습니다.