2026-11-02 POST

Uptime Kuma：给家里所有服务装一个会叫人的监控

9.3 万 star 的自建监控，一个容器、五分钟装完。网页、端口、Ping、证书到期都能盯，出事推到微信、Telegram、邮件都行。

NAS 上跑的服务一多，就会有那种"什么时候挂的都不知道"的情况。

影视库的容器悄悄退出、反代的证书过期、路由器半夜重拨换了 IP——这些都不会主动告诉你，你是某天想看片的时候才发现。

Uptime Kuma 就是干这个的。9.3 万 star，地址：

https://github.com/louislam/uptime-kuma

它是自托管的监控面板：你告诉它盯哪些地址，它每隔几十秒去敲一次门，一有异常就通过你能收到的方式叫你。

装：一个容器，两个参数

这是今天这五篇里最省事的一个。

应用中心搜 Uptime Kuma，或者直接用 Docker：

services:
  uptime-kuma:
    image: louislam/uptime-kuma:1
    container_name: uptime-kuma
    restart: unless-stopped
    ports:
      - "3001:3001"
    volumes:
      - ./kuma-data:/app/data
    environment:
      - TZ=Asia/Shanghai

docker compose up -d

打开 http://NAS地址:3001，第一次进去设管理员账号。

./kuma-data 这个目录一定要挂出来。不挂的话，容器一删，你配的所有监控和通知渠道全没——从头配一遍能让人崩溃。

先加五个最常见的监控

进后台点「添加新监控」，类型选对是关键：

1. 网站/服务是否活着 类型选 HTTP(s)，URL 填 http://192.168.1.10:5666，间隔 60 秒。进阶：勾上「接受的状态码」只填 200，这样它返回 502 也算异常。

2. 端口是否通 有些服务不返回网页（比如数据库、SSH）。类型选 TCP 端口，填 192.168.1.10 和 22。

3. 机器是否在线 类型 Ping，填内网 IP。机器直接断电、断网，这一条最先报警。

4. 域名解析对不对 类型 DNS，填你的域名。DDNS 没更新、解析被改了，这条能抓到。

5. 证书还剩几天 类型选 HTTP(s) - 关键字 不太对，正确做法是加一条 HTTP(s) 监控后，在「证书」那一栏勾上到期提醒（提前 14 天）。

五条加起来不到十分钟，之后你就再也不用靠"感觉"判断服务好不好了。

通知怎么配

这才是它的价值所在。点右上角头像 →「设置」→「通知」，支持几十种渠道，常用的：

Telegram：建个 bot，填 token 和 chat id；
企业微信 / 钉钉 / 飞书：用群机器人的 webhook 地址；
邮件（SMTP）：填服务器、端口、账号密码；
Bark / Server酱：推到手机通知栏，国内最省事。

配好之后一定要点「测试」。很多人配完不测，真出事的时候发现通知根本没发出去——那还不如不装。

我的习惯是：严重级别分两档。核心服务（NAS 本体、路由器、反代）挂了推手机；次要服务（某个容器）只记日志，别半夜吵人。

状态页：给家人看的那种

Kuma 自带公开状态页。左侧「状态页」→ 新建，把你允许公开的监控勾进去，会给你一个地址。

版面上可以写"家里的影视库"、“照片备份”，家人打开就知道现在能不能用，不用来问你。

注意：状态页是公开的，别把管理后台、内网 IP 明细这些放上去。要放就改个名，比如把 192.168.1.10:5666 显示成「NAS 管理」。

几个实用的细节

心跳间隔别设太短 60 秒够用。设成 10 秒，一天几万次请求，日志能把磁盘写满。

重试次数 默认失败一次就报警，网络抖一下会误报。建议把「重试次数」设成 2–3 次，连续失败才算真挂。

维护窗口 你要重启 NAS 的时候，先在 Kuma 里开个维护窗口，这段时间不报警。不然每次更新都被自己的监控吵一遍。

数据存在哪 全在 ./kuma-data/kuma.db（SQLite）。这个文件很小，几十兆，跟着你的备份任务一起备就行。

会踩的坑

容器重启后监控全没了 卷没挂对。检查 compose 里 ./kuma-data:/app/data 有没有生效——docker inspect 看挂载点。

通知发不出去 国内服务器连 Telegram 基本不通。用企业微信机器人或者 Bark，别死磕。

监控内网地址，但 Kuma 跑在 Docker 里 容器里的 localhost 是它自己。要盯宿主机的服务，填宿主机的内网 IP，或者用 host.docker.internal（Linux 下需要额外配置）。

状态页打开是空的 监控建好了但没勾进状态页。回去编辑状态页，把监控加进去。

它适合谁

家里服务超过三个，已经记不清谁在跑谁没跑的；
被"证书过期"坑过一次的；
想让家人自己看"现在能不能用"，而不是来问你的。

不适合：只跑一两个服务、出问题重启一下就好的人。为两个容器装一套监控，属于给自己找活干。

最后

这类工具的价值不在装的那一刻，在第一次半夜收到"服务已恢复"通知的时候——你会庆幸有它。