Uptime Kuma 自托管监控面板

Uptime Kuma 是什么

Uptime Kuma 是一款自托管监控工具，定位类似开源的 Uptime Robot。它用现代 Web 界面帮你持续检测站点与服务的可用性，并在异常时通过多种渠道推送告警。项目以 JavaScript 编写，前端为 Vue 3 单页应用，通过 WebSocket 实时推送状态，后端基于 Node.js。

核心能力

• 多类型监控：HTTP(s)、TCP 端口、HTTP 关键字、JSON 查询、WebSocket、Ping、DNS 记录、Push 心跳、Steam 游戏服务器、Docker 容器等。
• 实时面板：响应式 UI，状态变化即时刷新，附带 Ping 图表与证书信息。
• 通知体系：内置 Telegram、Discord、Slack、Gotify、Pushover、SMTP 邮件等 90+ 通知服务。
• 状态页：可创建多个对外公开的状态页，并绑定到不同域名。
• 安全与网络：支持 2FA 登录、代理配置、多语言界面。

快速部署

最省事的方式是 Docker Compose：

mkdir uptime-kuma
cd uptime-kuma
curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml
docker compose up -d

也可以用单条 Docker 命令：

docker run -d --restart=always -p 3001:3001 \
  -v uptime-kuma:/app/data --name uptime-kuma \
  louislam/uptime-kuma:2

启动后访问 http://localhost:3001 即可进入初始化流程。

注意：数据目录不支持 NFS 等网络文件系统，请挂载到本地目录或本地卷。

非 Docker 方式需要 Node.js（>= 20.4）、Git 与 PM2，克隆仓库后执行 npm run setup，再用 node server/server.js 或 PM2 常驻运行。

使用建议

1. 首次登录后立即修改默认管理员账号并开启 2FA。
2. 按业务分组建立监控项，配合标签与状态页对外展示。
3. 至少配置一个即时通知渠道（如 Telegram 或邮件），避免告警漏看。
4. 定期备份 /app/data 目录，升级前先看官方 Wiki 的更新说明。

适用与边界

Uptime Kuma 适合个人站长、运维与小型团队做服务可用性监控。它更偏「轻量可用性检测」，若需要复杂的指标采集、链路追踪或大规模分布式探测，应搭配 Prometheus、Grafana 等专业方案使用。