본문으로 건너뛰기
오픈소스 전체 목록

Uptime Kuma

직접 운영하는 사이트 · 서비스 가동 감시 도구. HTTP · TCP · Ping · DNS 감시와 알림 90종 이상, 상태 페이지를 지원해요. MIT

원본:louislam/uptime-kuma

요약

직접 운영하는 사이트 · 서비스 가동 감시 도구. HTTP · TCP · Ping · DNS 감시와 알림 90종 이상, 상태 페이지를 지원해요. MIT

설명

Uptime Kuma 로고

Uptime Kuma

Uptime Kuma는 쓰기 쉬운 직접 운영(self-hosted)형 모니터링 도구입니다.

별 Docker 다운로드 Docker 이미지 버전 마지막 커밋 Open Collective 후원자 GitHub 스포서

Uptime Kuma 대시보드 스크린샷

🥔 라이브 데모

직접 써 보세요!

데모 서버(위치: 독일 프랑크푸르트): https://demo.kuma.pet/start-demo

임시 라이브 데모이며, 모든 데이터는 10분 뒤에 삭제됩니다. Uptime Kuma 후원자가 후원합니다.

⚠️ 경고 조심하세요. 구글 검색 상위 결과인 uptimekuma.co는 우리의 공식 웹사이트가 아니며, 우리가 운영하는 사이트가 아닙니다. 이 GitHub 저장소의 설치 안내를 따르길 추천합니다.

⭐ 기능

  • HTTP(s) / TCP / HTTP(s) 키워드 / HTTP(s) Json 쿼리 / Websocket / Ping / DNS 레코드 / Push / Steam 게임 서버 / Docker 컨테이너의 가동 시간 모니터링
  • 멋지고, 반응형이며, 빠른 UI/UX
  • Telegram, Discord, Gotify, Slack, Pushover, 이메일(SMTP), 그리고 90종 이상의 알림 서비스(전체 목록은 여기를 누르세요)로 알림
  • 20초 간격
  • 여러 언어
  • 여러 상태 페이지
  • 상태 페이지를 특정 도메인에 연결
  • 핑 차트
  • 인증서 정보
  • 프록시 지원
  • 2단계 인증(2FA) 지원

🔧 설치 방법

🐳 Docker Compose

mkdir uptime-kuma
cd uptime-kuma
curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml
docker compose up -d

Uptime Kuma가 이제 모든 네트워크 인터페이스에서 실행 중입니다(예: http://localhost:3001 또는 http://your-ip:3001).

⚠️ 경고 NFS(네트워크 파일 시스템) 같은 파일 시스템은 지원하지 않습니다. 로컬 디렉터리나 볼륨에 연결하세요.

🐳 Docker 명령

docker run -d --restart=always -p 3001:3001 -v uptime-kuma:/app/data --name uptime-kuma louislam/uptime-kuma:2

Uptime Kuma가 이제 모든 네트워크 인터페이스에서 실행 중입니다(예: http://localhost:3001 또는 http://your-ip:3001).

로컬호스트에만 노출하려면:

docker run ... -p 127.0.0.1:3001:3001 ...

💪🏻 Docker 없이

요구 사항:

  • 플랫폼
    • ✅ Debian, Ubuntu, Fedora, ArchLinux 같은 주요 Linux 배포판
    • ✅ Windows 10 (x64), Windows Server 2012 R2 (x64) 이상
    • ❌ FreeBSD / OpenBSD / NetBSD
    • ❌ Replit / Heroku
  • Node.js >= 20.4
  • Git
  • pm2 - Uptime Kuma를 백그라운드에서 실행하기 위함
git clone https://github.com/louislam/uptime-kuma.git
cd uptime-kuma
npm run setup

# Option 1. Try it
node server/server.js

# (Recommended) Option 2. Run in the background using PM2
# Install PM2 if you don't have it:
npm install pm2 -g && pm2 install pm2-logrotate

# Start Server
pm2 start server/server.js --name uptime-kuma

Uptime Kuma가 이제 모든 네트워크 인터페이스에서 실행 중입니다(예: http://localhost:3001 또는 http://your-ip:3001).

더 유용한 PM2 명령

# If you want to see the current console output
pm2 monit

# If you want to add it to startup
pm2 startup && pm2 save

고급 설치

더 많은 옵션이 필요하거나 역방향 프록시를 거쳐 접속해야 한다면 다음을 읽으세요.

https://github.com/louislam/uptime-kuma/wiki/%F0%9F%94%A7-How-to-Install

🆙 업데이트 방법

다음을 읽으세요.

https://github.com/louislam/uptime-kuma/wiki/%F0%9F%86%99-How-to-Update

🆕 다음 계획

요청과 이슈는 다음 마일스톤에 할당합니다.

https://github.com/louislam/uptime-kuma/milestones

❤️ 후원자

이 프로젝트를 후원해 주셔서 대단히 감사합니다!

특별 후원자

Atlas Cloud

Atlas Cloud(https://www.atlascloud.ai)가 AI 모델을 쓰는 데 매달 400달러를 이 프로젝트에 후원합니다.

Atlas Cloud 제공

Open Collective와 GitHub 스포서

(목록은 GitHub에 캐시되어 갱신에 최대 24시간이 걸릴 수 있습니다)

Uptime Kuma 후원자

🖼 더 많은 스크린샷

라이트 모드:

대시보드가 어떻게 보이는지 보여 주는 Uptime Kuma 라이트 모드 스크린샷

상태 페이지:

Uptime Kuma 상태 페이지 스크린샷

설정 페이지:

Uptime Kuma 설정 페이지 스크린샷

Telegram 알림 예시:

Uptime Kuma Telegram 알림 예시 스크린샷

만든 이유

  • "Uptime Robot" 같은 직접 운영형 모니터링 도구를 찾고 있었지만 알맞은 것을 찾기 어렷습니다. 가장 가까운 것 중 하나가 statping입니다. 안타깝게도 안정적이지 않고 더 이상 유지보수되지 않습니다.
  • 멋진 UI를 만들고 싶었습니다.
  • Vue 3와 vite.js를 배우고 싶었습니다.
  • Bootstrap 5의 힘을 보여 주고 싶었습니다.
  • REST API 대신 SPA에서 WebSocket을 써 보고 싶었습니다.
  • 내 첫 Docker 이미지를 Docker Hub에 배포하고 싶었습니다.

이 프로젝트가 마음에 드신다면 ⭐를 눌러 주시길 부탁드립니다.

🗣️ 토론 / 도움 요청

⚠️ 일반 또는 기술 관련 질문은 이메일로 보내지 마세요. 그런 방식으로는 지원할 수 없어서, 거기에 질문하시면 답변하지 않겠습니다.

질문의 답을 찾을 때는 Google, GitHub Issues, 또는 Uptime Kuma의 서브레딧을 이용하길 추천합니다. 필요한 정보를 찾지 못했다면 마음 편히 물어보세요.

제 Reddit 계정: u/louislamlam 서브레딧에서 질문할 때 저를 멘션하셔도 됩니다.

기여하기

풀 리퀘스트 만들기

풀 리퀘스트는 언제든 환영입니다. 리뷰를 빠르고 효과적으로 유지하려면 풀 리퀘스트 가이드라인을 꼭 읽어 주세요.

풀 리퀘스트 테스트하기

지금 풀 리퀘스트가 많지만 저는 모두 테스트할 시간이 없습니다. 도우고 싶다면 다음을 확인해 보세요. https://github.com/louislam/uptime-kuma/wiki/Test-Pull-Requests

베타 버전 테스트하기

최신 베타 릴리스는 여기에서 확인하세요: https://github.com/louislam/uptime-kuma/releases

버그 신고 / 기능 요청

버그를 신고하거나 새 기능을 요청하고 싶다면 마음 편히 새 이슈를 열어 주세요.

번역

Uptime Kuma를 자기 언어로 번역하고 싶다면 Weblate Readme를 보세요.

맞춤법 및 문법

문서나 코드의 문법을 편히 고쳐 주세요. 제 모국어는 영어가 아니어서 문법이 완벽하지 않습니다.

라이선스

MIT. LICENSE 파일을 보세요.

저장소

louislam/uptime-kuma

평점

–평가 0개 기준
5점
0
4점
0
3점
0
2점
0
1점
0