XUGOU - 基于 CloudFlare 搭建的轻量化监控平台
July 26, 2026 · View on GitHub
XUGOU 是一个基于 CloudFlare 的轻量化系统监控平台，提供系统监控和状态页面功能。
📅 开发计划
目前已实现的主要功能：
- ✅ 系统监控 - 客户端资源监控与数据上报
- ✅ HTTP 监控 - API 接口健康检测
- ✅ 数据可视化 - 实时数据展示与历史趋势
- ✅ WebSocket 实时监控 - 指标秒级推送到仪表盘，无需刷新页面
- ✅ 状态页面 - 可定制的服务状态页面，支持隐藏指定客户端
- ✅ 告警通知 - 异常事件多渠道通知（Resend 邮件、Telegram、飞书、企业微信、钉钉、Bark、Server 酱、WxPusher、Gotify 共 9 种）
- ✅ 账单与到期提醒 - 记录服务器账单周期与到期时间，提前提醒续费
- ✅ 用户管理 - 支持用户注册、多用户管理，可分配不同权限
✨ 核心特性
-
🖥️ 系统监控
- 实时监控 CPU、内存、Swap、磁盘、网络、TCP/UDP 连接数、进程数等系统指标
- 四线路（电信/联通/移动/教育网）Ping 延迟与丢包率、IPv4/IPv6 双栈地址采集
- agent 秒级采集、批量上报（默认 2s 采集、5s 一批上报），采集/上报间隔可在网页端远程下发
- 全平台支持（agent 由 go 编写，理论上 go 能编译的平台都可以支持）
- agent 自管理命令：
xugou-agent update（自升级）、xugou-agent uninstall（自卸载）、xugou-agent status（运行状态自检）
-
⚡ WebSocket 实时推送
- 仪表盘与详情页通过 WebSocket 实时接收指标，秒级刷新、无需轮询
- 基于 Cloudflare Durable Object 广播，支持断线重连与最近数据回放
-
🌐 HTTP 监控
- 支持 HTTP/HTTPS 接口监控
- 自定义请求方法、头部和请求体
- 响应时间、状态码和内容检查
-
📊 数据可视化
- 实时数据图表展示
- 自定义仪表盘
- 7 天历史趋势查询（SQL 降采样，单次查询响应可控）
-
💰 账单与到期提醒
- 记录服务器价格、账单周期、到期时间
- 到期临近自动提醒，避免忘记续费
-
🌍 状态页面
- 自定义状态页面
- 支持多监控项展示，可将指定客户端设为隐藏不对外展示
- 响应式设计
-
🔔 告警通知
- 支持 9 种通知渠道：Resend 邮件、Telegram、飞书、企业微信、钉钉、Bark、Server 酱、WxPusher、Gotify
- 支持渠道内一键发送测试通知，验证配置有效性
-
👥 用户管理
- 支持新用户注册
- 支持多用户管理
- 可分配不同权限
🏗️ 系统架构
XUGOU 采用现代化的系统架构，包含以下组件：
- Agent: 轻量级系统监控客户端
- Backend: 基于 Hono 开发的后端服务，支持部署在 Cloudflare Workers 上
- Frontend: 基于 React + TypeScript 的现代化前端界面
实时链路与 D1 存储优化的实现细节，请查看 实时监控与性能优化。
🚀 快速开始
部署指南
默认用户名：admin 默认密码: admin123
开发指南
质量门禁
常见问题
⭐ 支持一下作者
🤝 贡献
欢迎所有形式的贡献，无论是新功能、bug 修复还是文档改进。
🏢 赞助
感谢以下赞助商支持 XUGOU 的开发：
📄 开源协议
本项目采用 MIT 协议开源，详见 LICENSE 文件。