一、CheckCle介绍

1.1 CheckCle简介

CheckCle 是一个开源、自托管的全栈监控平台，专为系统、应用程序和基础设施设计，提供无缝、实时的监控与告警功能。无论你是管理本地服务器、云服务还是混合架构，CheckCle 都可以在任何环境中部署，帮助你全面掌控系统的健康状态。

1.2 主要特性

• 实时正常运行时间监控：持续追踪服务状态，确保第一时间发现中断。
• 分布式检查机制：支持多区域节点监测，提升故障定位准确性。
• 事件跟踪与日志记录：完整记录服务状态变化（如正常 / 异常 / 警告 / 暂停）。
• 灵活的告警通知系统：支持通过电子邮件、Telegram、Discord 和 Slack 发送即时警报。
• 多种协议支持：涵盖 HTTP、DNS、Ping、TCP 等常用协议，适用于 API、FTP、SMTP 等服务监控。
• SSL 与域名监控：自动检测证书有效期、签发者、域名到期等关键安全信息。
• 服务器性能监控：提供一键安装脚本，监控 Linux 和 Windows 服务器的 CPU、内存、磁盘和网络使用情况。
• 运行状态页面：可创建公开状态页，向用户展示服务健康状况，提升透明度与信任度。
• 维护计划与事故管理：支持设定维护窗口，避免误报并优化故障响应流程。
• 数据报告与分析功能：生成监控报告，辅助性能优化与决策制定。
• 丰富的设置选项：包括用户权限管理、数据保留策略、多语言支持、主题切换（深色/浅色模式）、通知模板等。

二、本次实践规划

2.1 本地环境规划

本次实践为个人测试环境，操作系统版本为Ubuntu 22.04.1。

2.2 本次实践介绍

1.本次实践部署环境为个人测试环境，生产环境请谨慎；
2.在Docker环境下部署CheckCle开源监控平台。

三、本地环境检查

3.1 检查Docker服务状态

检查Docker服务是否正常运行，确保Docker正常运行。

root@jeven01:~#  systemctl status docker
● docker.service - Docker Application Container Engine
     Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
     Active: active (running) since Wed 2025-07-02 14:16:57 UTC; 21h ago
TriggeredBy: ● docker.socket
       Docs: https://docs.docker.com
   Main PID: 878 (dockerd)
      Tasks: 28
     Memory: 1.2G
        CPU: 1min 50.356s
     CGroup: /system.slice/docker.service
             ├─  878 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock

3.2 检查Docker版本

检查Docker版本

root@jeven01:~# docker -v
Docker version 27.1.1, build 6312585

3.3 检查docker compose 版本

检查Docker compose版本，确保2.0以上版本。

root@jeven01:~# docker compose version
Docker Compose version v2.19.1

四、拉取CheckCle镜像

拉取CheckCle容器镜像，如下所示：

docker pull operacle/checkcle

五、部署CheckCle服务

5.1 创建部署目录

• 创建部署目录

mkdir -p /data/checkcle  &&  cd /data/checkcle

5.2 编辑部署文件

在部署目录下，创建docker-compose.yaml文件，如下所示：

vim docker-compose.yaml

      
version: '3.9'
services:
  checkcle:
    image: operacle/checkcle:latest
    container_name: checkcle
    restart: unless-stopped
    ports:
      - "8090:8090" # Map ports for external access, if local only "127.0.0.1:8090:8090"
    volumes:
      - /opt/pb_data:/mnt/pb_data  # Mount persistent data

    # Optional: set user limits
    ulimits:
      nofile:
        soft: 4096
        hard: 8192

5.3 创建CheckCle容器

执行以下命令，创建CheckCle容器。

docker compose up -d

5.4 查看CheckCle容器状态

检查CheckCle容器运行状态，确保CheckCle容器正常启动。

root@jeven01:/data/checkcle#  docker compose ps
WARN[0000] /data/checkcle/docker-compose.yaml: the attribute `version` is obsolete, it will be ignored, please remove it to avoid potential confusion
NAME       IMAGE                      COMMAND                SERVICE    CREATED          STATUS          PORTS
checkcle   operacle/checkcle:latest   "/app/entrypoint.sh"   checkcle   26 seconds ago   Up 26 seconds   0.0.0.0:8090->8090/tcp, [::]:8090->8090/tcp, 8091/tcp

5.5 查看CheckCle容器日志

检查CheckCle容器运行日志，确保CheckCle服务正常运行。

docker compose logs

六、访问CheckCle服务

浏览器地址： http://<个人的服务器IP>:8090，访问CheckCle的初始页。如果无法访问，请确保宿主机的防火墙已关闭或已放行相关端口，对于云服务器还需配置相应的安全组规则。

使用默认账号 admin@example.com 和密码 Admin123456 即可登录 CheckCle 管理界面。

七、CheckCle基本使用

7.1 创建监控服务

在CheckCle首页，点击“New Service”，创建一个监控服务。

我们添加一个本地的网站监控服务，可参考如下配置：

7.2 查看监控服务状态

• 所有监控服务的总览页面

• 添加的监控服务详情页面

八、总结

通过Docker部署CheckCle，可以快速搭建一个功能全面、性能稳定的自托管监控平台。整个过程简单高效，极大地简化了环境配置和安装流程。无论是个人项目还是企业级服务，CheckCle结合Docker都能提供灵活可靠的监控解决方案。