Uptime Kuma 설치 방법 – Ubuntu 웹사이트 상태 점검
Uptime Kuma 설치는 Ubuntu 서버에 웹 기반 모니터링 시스템을 간편하게 구축하고자 할 때 매우 유용한 방법입니다. 이 툴은 오픈소스로 제공되며, 사용자는 직관적인 웹 UI를 통해 실시간으로 서버와 웹사이트의 상태를 점검할 수 있습니다.
Ubuntu 22.04 기준으로 설치는 Node.js와 npm 환경을 설정한 뒤, GitHub에서 코드를 받아 도커 없이도 실행이 가능합니다. 별도의 복잡한 설정 없이도 Ping, HTTP, 포트 상태 등을 모니터링할 수 있으며, 실패 시 알림 설정도 가능합니다.
이처럼 Uptime Kuma 설치는 서버 관리의 기초적인 모니터링 작업을 자동화하고 시각적으로 확인할 수 있도록 도와줍니다. 추가적으로 Telegram 연동, Discord, Slack 등과도 연동이 가능하여 장애 발생 시 빠르게 알림을 받을 수 있는 기능도 제공됩니다. Telegram 연동은 봇 생성 후 토큰과 채널 ID를 등록해 설정할 수 있습니다.
공식 사이트 : https://uptime.kuma.pet/
🔧 Uptime Kuma 설치 전 준비
Ubuntu 22.04 환경에서 아래의 구성 요소가 필요합니다.
-
Docker
-
Docker Compose
-
인터넷 연결
-
관리자 권한 계정
1. Uptime Kuma 설치 전 시스템을 업데이트 합니다.
# apt update && sudo apt upgrade -y
2. Docker 및 Docker Compose 설치
#apt install -y docker.io docker-compose
# systemctl enable –now docker
3. Uptime Kuma 디렉토리 생성
# mkdir -p ~/uptime-kuma
# cd ~/uptime-kuma
4. docker-compose.yml 파일 작성 및 컨테이너 실행
# vi docker-compose.yml
version: ‘3’
services:
uptime-kuma:
image: louislam/uptime-kuma:latest
container_name: uptime-kuma
restart: always
ports:
– “3001:3001”
volumes:
– ./data:/app/data
# docker-compose up -d
5. 보안설정
3001포트로 접근을 위해 방화벽 룰셋에 3001/tcp 를 추가합니다.
# ufw allow 3001/tcp
6. Uptime Kuma 접속 및 초기 설정
웹 브라우저에서 다음 주소로 접속 후 초기 관리자 계정을 생성합니다.
http://<서버 IP>:3001
7. Uptime Kuma 모니터링
예시와 같이 ping, ssh, http 등 모니터링 종류를 설정가능하며 웹페이지 인증서 만료 알람 설정도 가능합니다.