2.5 KiB
2.5 KiB
title, type, aliases, tags, date
| title | type | aliases | tags | date | |||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Uptime Kuma | entity |
|
|
2025-11-11 |
Uptime Kuma
Overview
Uptime Kuma 是开源的自托管 uptime monitoring 工具,被称为"自托管的 UptimeRobot",由 louislam 开发。它通过模拟 HTTP/TCP/DNS/TLS 请求来检测服务可用性,支持历史记录存储和丰富的通知通道。相比 Prometheus + blackbox_exporter 方案,Uptime Kuma 提供了更友好的 Web UI 和更低的配置门槛,适合家庭用户快速搭建合成监控。
Key Characteristics
- 友好 Web UI:现代化的监控面板,无需编写 YAML 配置文件
- 多协议支持:HTTP(S)、TCP、DNS、TLS 证书、Ping、Steam 游戏服务器
- 通知通道:邮件、Slack、Telegram、Discord、Webhook、PagerDuty 等
- 历史记录:持久化的 uptime 历史和响应时间图表
- 证书监控:自动检测 TLS 证书到期并告警
- Docker 部署:一条命令即可启动
Home Server Deployment
# docker-compose.yml 片段(来源:uptimekuma.org)
version: '3.8'
services:
uptime-kuma:
image: louislam/uptime-kuma:latest
container_name: uptime-kuma
restart: unless-stopped
ports:
- "3001:3001"
volumes:
- ./uptime-kuma-data:/app/data
environment:
- TZ=Asia/Shanghai
访问 http://localhost:3001 完成初始化(首次访问时设置管理员账户)。
Comparison: Uptime Kuma vs Prometheus blackbox_exporter
| 维度 | Uptime Kuma | blackbox_exporter |
|---|---|---|
| 配置方式 | Web UI 点点点 | YAML 配置文件 |
| 学习门槛 | 低 | 中 |
| 数据持久化 | 内置 SQLite | 依赖 Prometheus 存储 |
| 仪表盘 | 内置 | 需 Grafana |
| 告警配置 | UI 绑定通知 | Prometheus rules |
| 适合场景 | 快速验证、家庭使用 | 生产级、规模化 |
Use Case
Uptime Kuma 适合外网/内网服务可用性的快速监控搭建。配合 Prometheus + blackbox_exporter 使用:Uptime Kuma 负责外网端点快速告警,blackbox_exporter 负责更细粒度的指标(响应时间分布、证书剩余天数)。
Related Sources
Related Entities
- Prometheus — 互补的 Prometheus blackbox_exporter
- blackbox_exporter — 细粒度探测方案
- Alertmanager — 告警分发
Related Concepts
- 合成监控 — 核心应用场景
- System Monitoring — 上游领域