Uptime Kuma CLI 封装工具，支持监控增删改查、心跳历史查看及批量维护操作，适合自托管监控场景。
说明：
## 核心用法
本 Skill 为 Uptime Kuma 监控服务器的 Python CLI 封装，基于 `uptime-kuma-api` 库通过 Socket.IO 与服务器交互。支持完整的监控生命周期管理：查看整体状态、列出/获取/添加/删除监控项、暂停/恢复检查、查看心跳历史及通知渠道管理。
**典型工作流：**
– 快速诊断：`kuma.py status` 查看整体健康度，`kuma.py list` 定位故障（? 标记）
– 灵活添加：支持 HTTP/HTTPS、ICMP Ping、TCP 端口、DNS、数据库（MySQL/PostgreSQL/MongoDB/Redis）、Docker 容器、MQTT、被动 Push 等 10+ 监控类型
– 维护操作：支持单个或批量暂停/恢复（配合 shell 循环实现全站维护模式）
– 历史追溯：`kuma.py heartbeats ` 查看指定时间窗口内的检测记录
## 显著优点
– **协议覆盖全面**：从基础网络层（Ping、Port）到应用层（HTTP Keyword、数据库、Docker）全栈支持
– **被动监控支持**：Push 类型允许内网服务主动上报，解决不可达场景
– **批量运维友好**：JSON 输出配合 `jq` 可实现脚本化批量操作
– **自托管可控**：对接开源 Uptime Kuma 项目，数据私有化
## 潜在缺点与局限性
– **依赖 Socket.IO 连接**：网络不稳定时 API 调用可能失败
– **无内置高可用**：Uptime Kuma 本身为单节点架构，Skill 无法规避该限制
– **权限粒度粗**：仅支持用户名/密码认证，无 RBAC 或 API Token 机制
– **告警配置受限**：仅能查看通知渠道，无法通过 CLI 创建或修改告警规则
– **无 SSL 证书过期专项监控**：HTTP 类型不单独暴露证书有效期指标
## 适合人群
– 运维工程师/SRE：需要快速批量操作监控的日常值班场景
– 自托管用户：已部署 Uptime Kuma 且偏好命令行工作流的开发者
– 自动化集成：需将监控操作嵌入 CI/CD 或运维脚本的团队
## 常规风险
– **凭证泄露**：`UPTIME_KUMA_USERNAME/PASSWORD` 环境变量需妥善保管，避免写入版本控制
– **误删风险**：`delete` 操作无二次确认，脚本调用时需额外校验
– **维护误操作**：批量 pause/resume 可能影响核心服务监控覆盖
– **API 兼容性**：Uptime Kuma 版本升级可能破坏 Socket.IO 接口契约，需锁定版本测试
会员专属
