내 서버와 서비스의 상태를 한눈에 감시하고 알림을 받는 셀프호스팅 도구
웹사이트가 꺼졌는지, 서버가 응답하는지, 도메인 인증서가 만료되지 않았는지를 실시간으로 확인하고 싶을 때 이 도구가 필요합니다. Uptime Kuma는 다양한 프로토콜의 상태를 주기적으로 점검하고, 문제가 생기면 즉시 알림을 보내는 셀프호스팅 모니터링 솔루션입니다. 복잡한 설정 없이 Docker로 빠르게 배포할 수 있어 개인 프로젝트부터 소규모 팀까지 쉽게 도입할 수 있습니다.
감시할 수 있는 대상과 알림 채널
HTTP, TCP, WebSocket, Ping, DNS 레코드, Docker 컨테이너, Steam 게임 서버 등 다양한 대상의 가용성을 점검합니다. HTTP 응답에서 특정 키워드나 JSON 값을 확인하는 기능도 있어 단순 연결 확인을 넘어 서비스의 정상 동작 여부를 검증할 수 있습니다. 점검 주기는 20초 단위로 설정 가능하며, 문제가 감지되면 Telegram, Discord, Slack, 이메일(SMTP) 등 90개 이상의 알림 서비스를 통해 즉시 통보받습니다. 또한 여러 상태 페이지를 생성하고 특정 도메인에 매핑하여 외부에 서비스 상태를 공개할 수도 있습니다.
배포 방법과 시스템 요구 사항
가장 쉬운 배포 방법은 Docker Compose를 사용하는 것입니다. compose.yaml 파일을 다운로드한 뒤 docker compose up -d 명령만 실행하면 포트 3001에서 서비스가 시작됩니다. Docker를 사용하지 않고 직접 설치하려면 Node.js 20.4 이상, Git, 그리고 백그라운드 실행을 위한 pm2가 필요합니다. 지원되는 플랫폼은 Debian, Ubuntu, Fedora, ArchLinux 등 주요 리눅스 배포판과 Windows 10(x64) 이상이며, FreeBSD, OpenBSD, NetBSD, Replit, Heroku는 지원하지 않습니다. NFS와 같은 네트워크 파일 시스템은 지원하지 않으므로 데이터 볼륨은 로컬 디렉터리나 볼륨으로 매핑해야 합니다.
사용 전 확인해야 할 사항
이 도구는 셀프호스팅이므로 서버 관리와 보안 책임은 사용자에게 있습니다. 공식 데모 서버는 10분 후 데이터가 삭제되므로 실제 운영 환경에서는 반드시 자체 서버에 설치해야 합니다. 구글 검색 결과 상단에 뜨는 uptimekuma.co는 공식 웹사이트가 아니므로 주의해야 하며, 설치 가이드는 이 저장소의 위키를 참고하는 것이 안전합니다. 또한 저자는 이메일로 문의하는 기술 지원은 제공하지 않으므로, 문제 해결은 GitHub Issues나 subreddit(r/UptimeKuma)을 통해 진행해야 합니다. 최신 베타 버전이나 업데이트 방법은 위키 문서에서 확인할 수 있습니다.