Repolode
bluewave-labs

bluewave-labs/Checkmate

HTTP, ping, 포트, DNS, Docker 등을 점검하고 상태 페이지와 장애 알림을 제공하는 셀프 호스팅 가동 시간 및 인프라 모니터링 앱입니다.

대체할 수 있는 제품:UptimeRobotPingdomStatuspage

스타
10,959
포크
1,230
열린 이슈
119
마지막 커밋
17시간 전

어떤 프로젝트인가요?

Checkmate는 웹사이트와 서버에 접속할 수 있는지, 응답 속도는 어떤지 추적하는 오픈 소스 셀프 호스팅 모니터링 애플리케이션입니다. 일정에 따라 점검을 실행하고 결과를 저장하며, 서비스가 중단되거나 복구되면 장애를 생성하고 이메일, Slack, Discord, Telegram, PagerDuty 등의 채널로 알림을 보냅니다.

모니터링 유형에는 HTTP(SSL 인증서 만료 포함), ping, 포트, DNS, Docker, gRPC, WebSocket, 게임 서버가 있습니다. CPU, 메모리, 디스크, 온도 등의 인프라 지표를 수집하려면 함께 제공되는 Capture 에이전트가 필요합니다. 이 에이전트는 Linux, Windows, macOS, Raspberry Pi 또는 Go를 실행할 수 있는 모든 기기에서 실행할 수 있습니다. 공개 상태 페이지와 예약된 유지보수 시간도 제공됩니다.

이 프로젝트는 MongoDB를 사용하는 단일 Docker 이미지로 구성되며, 예제 Docker Compose 파일을 사용해 배포할 수 있습니다. 인터페이스는 React와 MUI로 구축했고, 백엔드는 Node.js에서 실행됩니다.

핵심 기능

  • 01HTTP, ping, 포트, DNS, Docker, gRPC, WebSocket, 게임 서버를 일정에 따라 점검
  • 02모니터링 대상 서비스의 상태가 바뀌면 장애를 생성하고 해결 처리
  • 03상태 페이지와 예약된 유지보수 시간 제공
  • 04이메일, 웹훅, Slack, Discord, Telegram, PagerDuty 등으로 알림 전송
  • 05Capture 에이전트를 통해 CPU, 메모리, 디스크 등의 인프라 지표 수집

활용 사례

  • 회사 웹사이트와 API의 가동 시간 및 응답 속도 모니터링
  • 홈랩, Raspberry Pi 서버, Docker 컨테이너 상태 확인
  • 장애 및 유지보수 중 고객에게 보여 줄 상태 페이지 게시
  • 내부 HTTPS 엔드포인트의 SSL 인증서 만료 여부 확인

빠른 시작

  1. 1

    Docker와 Git을 설치합니다

  2. 2

    참고용 Docker Compose 파일을 다운로드합니다

    curl -O https://raw.githubusercontent.com/bluewave-labs/checkmate/master/docker/docker-compose.yaml
  3. 3

    생성된 JWT 시크릿으로 Checkmate를 시작합니다

    JWT_SECRET="$(openssl rand -hex 32)" docker compose up -d
  4. 4

    브라우저에서 http://localhost:52345를 엽니다

사용 전 알아둘 점

  • MongoDB가 필요하며 애플리케이션 이미지에 포함되어 있지 않습니다.
  • 로컬 Docker 소켓이나 원격 Docker 데몬을 모니터링하려면 볼륨 마운트와 TLS 자격 증명 등의 추가 설정이 필요합니다.
  • Checkmate는 AGPL-3.0 라이선스를 따릅니다. AGPL-3.0은 네트워크를 통한 사용에도 의무가 적용되는 카피레프트 라이선스입니다.

토픽

자주 묻는 질문

Checkmate은(는) 무엇인가요?
HTTP, ping, 포트, DNS, Docker 등을 점검하고 상태 페이지와 장애 알림을 제공하는 셀프 호스팅 가동 시간 및 인프라 모니터링 앱입니다. Checkmate는 웹사이트와 서버에 접속할 수 있는지, 응답 속도는 어떤지 추적하는 오픈 소스 셀프 호스팅 모니터링 애플리케이션입니다. 일정에 따라 점검을 실행하고 결과를 저장하며, 서비스가 중단되거나 복구되면 장애를 생성하고 이메일, Slack, Discord, Telegram, PagerDuty 등의 채널로 알림을 보냅니다.
Checkmate은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
Checkmate은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
Checkmate은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. Checkmate의 마지막 커밋은 2026년 10월 19일입니다.
Checkmate은(는) 어디에 사용할 수 있나요?
회사 웹사이트와 API의 가동 시간 및 응답 속도 모니터링 홈랩, Raspberry Pi 서버, Docker 컨테이너 상태 확인 장애 및 유지보수 중 고객에게 보여 줄 상태 페이지 게시 내부 HTTPS 엔드포인트의 SSL 인증서 만료 여부 확인
Checkmate는 어떻게 설치하나요?
Docker와 Git을 설치합니다 참고용 Docker Compose 파일을 다운로드합니다: curl -O https://raw.githubusercontent.com/bluewave-labs/checkmate/master/docker/docker-compose.yaml 생성된 JWT 시크릿으로 Checkmate를 시작합니다: JWT_SECRET="$(openssl rand -hex 32)" docker compose up -d 브라우저에서 http://localhost:52345를 엽니다
Checkmate은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/bluewave-labs/Checkmate

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트