hunterlong/statup

Statping - 状态页面与监控服务器

Statping是一款易于使用的网站和应用状态监控工具，可自动获取应用状态并生成功能丰富的美观状态页面，支持MySQL、Postgres或SQLite数据库，适用于多种操作系统。

镜像概述

Statping致力于提供可靠的状态监控服务，即使被监控的服务故障，也能确保状态页面正常运行以通知用户。其Docker镜像仅约16MB，二进制文件最大约17MB，轻量高效，无额外依赖，可在Raspberry Pi等设备上运行。

核心功能

• 轻量快速：资源占用低，部署便捷；
• 多数据库支持：兼容MySQL、Postgres、SQLite；
• 自定义样式：支持SASS样式定制，灵活调整页面外观；
• 多通知渠道：集成Slack、SMTP邮件等通知方式，服务故障时及时提醒；
• 移动优化：状态页面适配移动端与桌面端；
• 静态HTML导出：可将状态页面导出为静态文件，方便部署到GitHub Pages或FTP服务器；
• Prometheus集成：提供/metrics端点，支持Prometheus监控；
• 插件扩展：支持用户创建自定义插件和通知器。

使用场景

• 监控个人/企业网站、API服务的可用性；
• 构建公开的状态页面，向用户展示服务运行状态；
• 集成到现有监控体系（如Prometheus），增强监控能力；
• 部署在独立服务器（如AWS EC2）上，确保状态页面在被监控服务故障时仍可访问。

配置说明

Docker部署

直接运行镜像：

bash
docker run -it -p 8080:8080 hunterlong/statping

Docker Compose部署（基础版）

使用包含nginx、postgres和Statping的docker-compose.yml：

bash
docker-compose up -d

Docker Compose部署（自动SSL）

设置域名和***，自动获取Let's Encrypt证书：

bash
LETSENCRYPT_HOST=mydomain.com \
LETSENCRYPT_EMAIL=info@mydomain.com \
docker-compose -f docker-compose-ssl.yml up -d

Prometheus集成

在Prometheus配置中添加以下内容（替换MY API SECRET HERE为Statping的API密钥）：

yaml
scrape_configs:
  - job_name: 'statping'
    bearer_token: 'MY API SECRET HERE'
    static_configs:
      - targets: ['statping:8080']

注意事项

建议将Statping部署在与被监控服务独立的服务器上，避免因被监控服务故障导致状态页面无法访问。