내 서버에 Uptime Kuma 배포하기

무엇을 만들게 되나요

Uptime Kuma는 HTTP 엔드포인트, TCP 포트, ping 체크, 키워드 체크를 모니터링하는 오픈소스 상태 모니터입니다. 이 튜토리얼은 Kumo2의 원클릭 셀프 호스팅 앱 흐름에서 시작해, 앱이 온라인 상태가 된 뒤 먼저 확인할 설정을 짚어 줍니다.

이 튜토리얼의 검증 방식

이 튜토리얼은 현재 Kumo2 Uptime Kuma 앱 흐름을 기준으로 유지됩니다. Docker 기반 프로비저닝, 영구 앱 스토리지, 서버 상세 페이지, Uptime Kuma 첫 실행 관리자 설정을 확인합니다. 새 단일 서버 배포를 위한 문서이며, 다른 호스트에서 기존 모니터 기록을 이전하는 절차는 아닙니다.

시작하기 전에

Kumo2 계정, 결제 수단, 그리고 보기 좋은 공개 URL을 원한다면 도메인이나 서브도메인이 필요합니다. 먼저 서버 IP로 직접 배포를 테스트할 수도 있습니다.

작은 개인용 모니터라면 적당한 서버 크기로 시작하세요. 나중에 많은 엔드포인트를 추적하거나 긴 기록을 보관할 계획이라면 CPU나 메모리를 추가하면 됩니다.

앱 배포하기

Uptime Kuma 셀프 호스팅 앱 페이지를 열고, 모니터링할 서비스와 가까운 리전을 선택한 뒤 주문을 확인합니다. Kumo2는 서버를 만들고 Docker 런타임을 설치한 다음, 영구 스토리지와 함께 Uptime Kuma를 시작합니다.

프로비저닝이 끝나면 서버 상세 페이지에서 앱 URL을 열고 Uptime Kuma에서 첫 관리자 계정을 만드세요.

첫 모니터 추가하기

주요 웹사이트나 API용 HTTP 모니터를 만드세요. 공개 URL을 사용하고, 적절한 간격을 설정하며, 대시보드를 쉽게 훑어볼 수 있도록 짧고 친숙한 이름을 붙입니다.

비공개 서비스를 모니터링한다면 같은 private network 안에서 체크를 유지하거나 방화벽 규칙으로 접근을 제한하세요. 모니터 하나를 위해 넓은 관리 포트를 공용 인터넷에 열 필요는 없습니다.

배포 확인하기

첫 모니터를 만든 뒤 최소 한 번의 성공한 체크와 한 번의 전체 체크 간격을 기다리세요. 대시보드가 업데이트되는지, 페이지를 새로고침해도 모니터 기록이 유지되는지, 서버 방화벽이 의도적으로 연 포트만 노출하는지 확인합니다.

내구성 확인하기

앱 데이터 볼륨이 연결되어 있는지, 보관 설정에 충분한 디스크가 있는지 확인하세요. Uptime Kuma가 운영 흐름의 일부가 된다면 알림을 일찍 설정해 장애가 대시보드에만 머물지 않고 올바른 메일함이나 채팅방으로 전달되도록 하세요.

다음 단계

• 앱이 정상 동작하면 도메인을 서버로 연결합니다.
• 사용자가 먼저 알아차릴 서비스부터 모니터를 추가합니다.
• 서버 방화벽을 좁게 유지하세요. 웹 트래픽은 허용하고, 관리는 신뢰할 수 있는 위치에서만 접근하게 합니다.
• 모니터 목록과 알림 대상의 책임자를 문서화합니다.