开源服务器监控工具Checkmate

发表于 分类于 Waline： 阅读次数： 本文字数： 4.5k 阅读时长 ≈ 4 分钟
Checkmate 是一个开源、自托管的服务器和基础设施监控工具，支持实时监控、告警通知和状态页面。

简介

什么是 Checkmate ？

Checkmate 是一个开源、自托管的服务器和基础设施监控工具。它可以实时跟踪服务器硬件状态、网站正常运行时间、响应时间和事件，并通过精美的可视化界面展示监控数据。Checkmate 定期检查服务器或网站是否可访问和运行正常，提供实时告警和监控服务可用性、停机时间和响应时间的报告。

主要特点

  • 多种监控类型：支持 Uptime、Docker、Ping、SSL、端口、游戏服务器等多种监控方式
  • 页面速度监控：监测网页加载速度性能
  • 基础设施监控：通过 Capture agent 监控 CPU、内存、磁盘、温度等硬件状态
  • 选择性磁盘监控：支持按挂载点选择监控特定磁盘
  • 事件概览：集中查看所有监控事件和告警
  • 状态页面：提供 4 款精美主题的公开状态页面
  • 多样化通知：支持邮件、Webhook、Discord、Slack、PagerDuty、Matrix、Microsoft Teams、Telegram、Pushover、Twilio (SMS) 等通知方式
  • 计划维护：支持设置维护时间段，期间不会触发告警
  • JSON 查询监控：支持自定义 JSON 响应验证
  • 多语言支持：支持包括中文在内的 17 种语言
  • 高性能：已通过 1000+ 活跃监控器压力测试
  • 开源免费：基于 AGPL-3.0 协议开源，可免费使用和修改

应用场景

  • 网站监控：监控网站是否在线、响应时间、SSL 证书有效期
  • 服务器监控：监控服务器 CPU、内存、磁盘使用情况（需安装 Capture agent）
  • Docker 容器监控：监控容器运行状态和资源使用
  • 服务端口监控：监控特定服务端口是否开放
  • API 监控：通过 HTTP 和 JSON 查询监控 API 接口状态
  • 团队状态页面：为团队或客户提供公用的服务状态展示页面

Checkmate 是一个功能强大的自托管监控解决方案，可以替代 UptimeRobot、Pingdom 等商业监控服务，适合个人开发者和中小企业使用。

安装

在群晖上以 Docker 方式安装。

推荐使用 Combined FE/BE Docker 方式（前后端集成在一个镜像中），部署最简单。

docker-compose 安装

采用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
version: '3.8'

services:
  server:
    image: ghcr.io/bluewave-labs/checkmate-backend-mono:latest
    container_name: checkmate-server
    restart: always
    ports:
      - "52345:52345"
    # volumes:
    #   - /var/run/docker.sock:/var/run/docker.sock:ro   
    environment:
      - UPTIME_APP_API_BASE_URL=http://localhost:52345/api/v1
      - UPTIME_APP_CLIENT_HOST=http://localhost
      - DB_CONNECTION_STRING=mongodb://mongodb:27017/uptime_db
      - CLIENT_HOST=http://localhost
      - JWT_SECRET=your_secret_key_here
    depends_on:
      mongodb:
        condition: service_healthy

  mongodb:
    image: ghcr.io/bluewave-labs/checkmate-mongo:latest
    container_name: checkmate-mongodb
    restart: always
    command: ["mongod", "--quiet", "--bind_ip_all"]
    volumes:
      - ./data:/data/db
    healthcheck:
      test: ["CMD", "mongosh", "--eval", "db.adminCommand('ping')", "--quiet"]
      interval: 5s
      timeout: 30s
      start_period: 0s
      retries: 30

更新 compose 文件中的几个环境变量。将 localhost 替换为服务器的 IP，老苏的服务器 IP 是 192.168.0.197

1
2
3
- UPTIME_APP_API_BASE_URL=http://192.168.0.197:52345/api/v1
- UPTIME_APP_CLIENT_HOST=http://192.168.0.197
- CLIENT_HOST=http://192.168.0.197
可变 值 说明
UPTIME_APP_API_BASE_URL http://localhost:52345/api/v1 API 基础地址，如果部署在远程服务器，请修改为实际 IP 或域名
UPTIME_APP_CLIENT_HOST http://localhost 客户端访问地址
DB_CONNECTION_STRING mongodb://mongodb:27017/uptime_db MongoDB 连接字符串
CLIENT_HOST http://localhost 授权来自指定来源的 API 请求
JWT_SECRET 自定义密钥,可以用 openssl rand -base64 32 来生成 用于 JWT 认证，建议使用强随机字符串

如果需要监控 Docker 容器，可取消下面的注释

1
2
3
4
server:
  # ... 其他配置 ...
  volumes:
    - /var/run/docker.sock:/var/run/docker.sock:ro  # 监控 Docker 容器

然后通过 SSH 登录到您的群晖，执行下面的命令：

1
2
3
4
5
6
7
8
9
10
# 新建文件夹 checkmate 和 子目录
mkdir -p /volume1/docker/checkmate/data

# 进入 checkmate 目录
cd /volume1/docker/checkmate

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d

运行

在浏览器中访问 http://<群晖IP>:52345 即可进入登录界面。

先切换到中文，然后我们注册管理员用户

注册完成后，会进入到主界面

添加监控

添加监控项，还是以老苏的博客 https://laosu.tech 为例

  • 选择监控类型（HTTP、Ping、Docker、SSL 等）
  • 填写监控目标地址和名称
  • 设置检查间隔和告警阈值
  • 配置通知方式

创建成功后

还可以配置告警通知方式，方便我们在监控异常时接收报警信息

稍等一下就会有信息了

安装 Capture Agent（可选）

如果需要监控服务器硬件（CPU、内存、磁盘、温度等），需要在被监控服务器上安装 Capture agent

老苏还是在同一台群晖主机上安装的

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# 运行 agent 容器
docker run -d \
   --restart unless-stopped \
   --name checkmate-agent \
   -p 59232:59232 \
   -e API_SECRET=your_agent_secret_key_here \
   ghcr.io/bluewave-labs/capture:latest
   
# 示例1
docker run -d \
   --restart unless-stopped \
   --name checkmate-agent \
   -p 59232:59232 \
   -e API_SECRET=Trtsodtyftb19PJGraq2+pKooqmANQ3ScTNBqRWITL0= \
   ghcr.io/bluewave-labs/capture:latest

# 示例2（挂载静态信息）
docker run -d \
   --restart unless-stopped \
   --name checkmate-agent \
   -p 59232:59232 \
   -v /etc/os-release:/etc/os-release:ro \
   -e API_SECRET=Trtsodtyftb19PJGraq2+pKooqmANQ3ScTNBqRWITL0= \
   ghcr.io/bluewave-labs/capture:latest
  1. API_SECRET 可以用 openssl rand -base64 32 来生成 ；
  2. 如果主机支持，可以挂载 -v /etc/os-release:/etc/os-release:ro，来标识发行版名称/版本等静态信息，群晖 DSM6 不支持，但是也可以自己建一个 os-release 文件，内容示例：
1
2
3
NAME="Synology DSM"  
VERSION="6.x"  
ID="synology"

进入 基础设置

  • URL：填入 Capture agent 的地址，老苏的是 http://192.168.0.197:59232/api/v1/metrics
  • 授权密钥：填入 Capture agent 中 API_SECRET 设置的值
  • 显示名称：主机名称，例如 DS3617xs
  • 告警阈值：根据需要进行设置

创建成功后，等待初始化完成

等 正常 之后就可以查看了

注意事项

  1. 数据持久化：MongoDB 数据存储在 /data 目录，请定期备份
  2. 端口冲突：默认使用 52345 端口，确保该端口未被占用
  3. 公网部署：如果需要公网访问，建议配置反向代理（如 Nginx Proxy Manager）和 HTTPS
  4. 安全建议：
    • 修改默认的 JWT_SECRET 为强随机字符串
    • 公网部署时启用 MongoDB 认证
    • 使用强密码并定期更换
  5. Docker 监控：需要挂载 /var/run/docker.sock 才能监控容器
  6. 升级更新：重新拉取最新镜像并运行 docker-compose up -d，确保挂载相同的数据目录以保留数据

参考文档

Checkmate: An open source uptime and infrastructure monitoring application
地址：https://github.com/bluewave-labs/Checkmate

Checkmate 官方文档 - 安装指南
地址：https://docs.checkmate.so/users-guide

Checkmate 在线演示
地址：https://demo.checkmate.so/

Capture Agent - 服务器硬件监控代理
地址：https://github.com/bluewave-labs/capture

Checkmate 官方 Discord 社区
地址：https://discord.gg/NAb6H3UTjK