Uptime Kuma网站监控与故障通知
先选对监控位置和目标
本文适用于已安装 Docker Engine 28及以上、Compose v2 的 Linux 服务器,使用 Uptime Kuma 2.5.11。监控机应与业务机分开,最好处于不同网络;业务机停机时,监控和发信仍须能运行。单个监控点只代表它到网站的访问路径,不能证明所有地区、运营商都能访问。
先选择自己的正式 HTTPS 域名和一个只读页面。首页正常只能说明首页可取回;需要判断应用是否可用,应由应用提供不写数据库、不扣款、不发信的健康检查地址。不要把订单、发送短信、导出大文件等接口作为一分钟调用一次的探测目标。
安装并保留监控数据
在监控机新建独立目录,保存以下 compose.yaml。若目录或该文件已存在,先另选空目录,不能覆盖原项目文件。数据卷须落在本地文件系统,不能放到 NFS。若已有同名项目,先换一个项目名,避免接管原容器。
mkdir -p ~/bly-uptime
cd ~/bly-uptime
cat > compose.yaml <<'YAML'
services:
kuma:
image: louislam/uptime-kuma:2.5.11
restart: unless-stopped
ports:
- "127.0.0.1:3001:3001"
volumes:
- kuma_data:/app/data
volumes:
kuma_data:
YAML
docker compose -p bly-uptime config --quiet
docker compose -p bly-uptime up -d
docker compose -p bly-uptime ps
docker compose -p bly-uptime logs --tail=80 kuma
管理端口只监听本机。在自己电脑的终端建立 SSH 隧道;把 deploy、示例地址和端口换成监控机的真实登录信息,保持该终端连接。
ssh -o ExitOnForwardFailure=yes -N \
-L 127.0.0.1:3001:127.0.0.1:3001 -p 22 deploy@192.0.2.10
浏览器打开 http://127.0.0.1:3001,在首次数据库引导中选择适合少量监控的 SQLite,再创建管理员,设置强密码,再把界面语言设为简体中文。若本地 3001 已占用,将隧道左侧端口改为 13001,并访问对应地址。隧道关闭后,服务器中的监控仍会继续运行。
建立一个真正有意义的检测
- 点击新增监控,选择 HTTP(s),名称写清业务和探测点,URL 填正式 HTTPS 地址。首次验收使用间隔60秒、超时10秒、重试0次,便于核对一次失败后的故障与恢复流程。验收后若需要过滤短暂抖动,可按业务容忍度调整为1~2次重试,并重新测量告警延迟。
- 正常状态码按该接口约定填写,例如只接受 200。确认最终地址是否经过重定向,防止跳到登录页后仍被判定正常。
- 需要验证正文时选择 HTTP(s) 关键词类型,填写响应中稳定、唯一的成功标记。关键词不能取页面上任何错误页也有的公司名称。

Uptime Kuma 2.5.11 官方临时演示:HTTP(s)关键词监控的字段位置。图中网址与“宝乐云”关键词仅用于示范;正式使用自己的业务地址,并选择只出现在成功响应中的标记。
- 保持证书验证开启。保存后查看实际状态、响应耗时和错误原因;短暂抖动与持续失败应按重试记录判断,不按单个红点下结论。
把通知送到真正会看的地方
在监控编辑页设置通知,选择“电子邮件(SMTP)”,填写已有邮箱服务提供的服务器、端口、安全性方式、账号或授权码,以及收件地址。
Uptime Kuma 2.5.11 官方临时演示:SMTP通知参数填写位置。smtp.example.com和monitor@example.com均为示例,不能照抄;图中587对应“无/STARTTLS”选项,“忽略TLS错误”和“禁用STARTTLS”均未勾选,实际参数以自己的发信服务资料为准。
发送测试通知,并在收件箱实际确认邮件;保存成功不能代表送达。之后还要在该监控中勾选这一通知渠道,不能只完成通知通道的设置。
新建一个名称带“验收”的独立监控,先指向自己的正常页面,确认正常。再只修改这个测试监控的 URL,指向自己域名下确认返回 404 的不存在路径,验收故障通知;恢复正常地址后验收恢复通知。不要为了测试关闭正式网站。记录故障发生、面板变红、邮件收到三处时间,得到实际告警延迟。
上线后的检查
定期检查最后一次探测时间、通知邮箱容量和监控机磁盘。业务维护前只给相关监控设置维护时段。监控数据需要备份,SQLite 数据备份应在该容器停止后取得一致副本,保留原卷;升级前参考容器升级与回滚。重要业务再增加独立观察点,并让另一处监控监控机自身,避免监控失效时无人发现。