내 서비스가 꺼지면 알림 받기 (Uptime Kuma)

웹사이트나 게임 서버가 꺼졌을 때 디스코드로 바로 알림을 받고 싶다면 Uptime Kuma를 쓰면 됩니다. 주기적으로 내 서비스에 접속해보고, 응답이 없으면 알려주는 무료 프로그램입니다. Docker로 설치합니다.

1. 설치

Docker가 없다면 Docker 설치하고 사용하기로 먼저 설치합니다.

docker run -d --name uptime-kuma --restart unless-stopped \
  -p 127.0.0.1:3001:3001 \
  -v uptime-kuma:/app/data \
  louislam/uptime-kuma:1

127.0.0.1에만 연결해서 외부에서는 바로 접속할 수 없게 했습니다. 관리 화면은 아래 두 방법 중 하나로 엽니다.

2. 관리 화면 열기

방법 A. 도메인으로 열기 (계속 쓸 거라면 권장)

웹사이트 띄우기대로 Nginx와 HTTPS를 설정하고, proxy_pass를 http://127.0.0.1:3001로 맞춥니다. Uptime Kuma는 실시간 연결(WebSocket)을 쓰므로 location / 안에 아래 줄을 함께 넣습니다.

    location / {
        proxy_pass http://127.0.0.1:3001;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
    }

방법 B. SSH 터널로 잠깐 열기

내 PC의 PowerShell에서 실행하고, 브라우저에서 http://localhost:3001로 접속합니다.

ssh -N -L 3001:127.0.0.1:3001 계정명@서버IP

처음 접속하면 관리자 계정을 만드는 화면이 나옵니다. 바로 만들어주세요.

3. 감시할 서비스 추가

새 모니터 추가를 누르고 종류를 고릅니다.

확인 간격은 기본 60초면 충분합니다.

4. 디스코드로 알림 받기

1. 디스코드 채널 설정 → 연동 → 웹후크 → 새 웹후크 → 웹후크 URL 복사
2. Uptime Kuma 오른쪽 위 프로필 → 설정 → 알림 → 알림 설정
3. 알림 유형 Discord, 복사한 웹후크 URL을 붙여 넣고 테스트로 확인 후 저장
4. 각 모니터의 편집 화면에서 이 알림을 켭니다.

알아둘 것

• Uptime Kuma가 감시하는 서비스와 같은 서버에 있으면, 서버 자체가 꺼졌을 때는 알림도 보내지 못합니다. 서버 자체의 상태는 마이페이지에서도 확인할 수 있습니다.
• 감시 기록은 uptime-kuma 볼륨에 저장됩니다. 업데이트는 docker pull louislam/uptime-kuma:1 후 컨테이너를 지우고 같은 명령어로 다시 실행하면 됩니다. (볼륨을 지우지 않는 한 기록은 남습니다)