家里的 NAS 网页打不开了,Docker 里跑的下载、相册、笔记服务停了一整夜,往往要到第二天想用的时候才发现。要是它一挂,手机就收到一条钉钉或飞书消息呢?这篇讲的就是这件事(想连 NAS 整机断电也能知道,Kuma 要装在另一台常开的机器上,第 3 节细说)。
GitHub 上做这件事、星数很高的一个开源项目叫 Uptime Kuma,9.4 万星,Docker 镜像被拉取了两亿多次。它是作者 louislam 2021 年 7 月一个人起头的,建仓 8 天就发了 1.0,到今天近 400 位贡献者里,他一个人的提交数还是第二名的九倍。
11 月 12 日,这个项目一天连发 2.5.10 和 2.5.11 两个版本,都带安全修复,后一个修的是一个远程代码执行漏洞,装过的人该先升级。
一个人想要个自己的 Uptime Robot,做成了 9.4 万星
Uptime Robot 是一个在线网站监控服务,替你定时访问网站,挂了发邮件。louislam 在 README 里写了起因:他想找一个能装在自己机器上的同类工具,没找到合适的,最接近的一个已经不稳定、也没人维护了。于是自己写,顺便学 Vue 3,顺便发布自己的第一个 Docker 镜像。
这个「顺便」的项目后来成了自托管圈的常备件:大版本 2.0 在 2025 年 10 月转正,现在是 2.5.x,许可证是 MIT,个人和公司都能免费用。界面有简体中文,官方有个在线演示站,数据 10 分钟自动清空,不装也能先点点看。
README 里有一句提醒值得照抄:在 Google 搜它,排第一的 uptimekuma.co 不是官方网站。官方仓库是 GitHub 上的 louislam/uptime-kuma,仓库主页挂的站是 uptime.kuma.pet。
能盯什么:网址、端口、Docker 容器,最短 20 秒查一次
Uptime Kuma 的用法是「加一个监控项,告诉它盯什么」。能盯的有十类:网页打不打得开、页面里有没有某段字、TCP 端口通不通、Ping、DNS 解析、Docker 容器是否在运行这些,最短 20 秒检查一次。
对 NAS 用户最实用的是两类。一类是 Docker 容器监控,直接看某个容器还在不在跑;另一类叫 Push,方向是反的:不是 Kuma 去问,而是你的定时任务每次跑完来「报到」一下,过了时间没来报到就算挂了。夜里的备份脚本有没有跑成,用的就是这个办法。
另外它会显示网站 HTTPS 证书的信息,能把监控结果做成状态页,绑到自己的域名上给家人或同事看;登录支持两步验证。只盯你自己的服务和设备,别拿去高频探测别人的站点。
挂了推到哪:90 多种通知渠道,钉钉、飞书、企业微信都在
README 写的是支持 90 多种通知服务。国内常用的基本都有:钉钉、飞书、企业微信、Server酱、PushPlus、Bark 这些,也能走邮件,或者用 Webhook 接到你自己写的程序。短信这类渠道由服务商按用量收费,先看清再开。
通知是单独配置的:先在设置里填好一个渠道,比如钉钉群机器人的地址,再在每个监控项里勾选它。一个监控项可以同时推好几个地方,钉钉群里通知值班的同事,自己手机上再收一份。
有一点要想清楚:Kuma 装在哪台机器上,就管不了那台机器自己整机断电。它装在 NAS 上,盯 NAS 里的各个服务没问题;但 NAS 整台关机了,Kuma 也跟着停,没人发通知。真要盯 NAS 本身,得把 Kuma 装在另一台常开的机器上。
一条 Docker 命令装好,面板别直接开到公网
官方 README 给的 Docker 命令只有一行:docker run -d --restart=always -p 3001:3001 -v uptime-kuma:/app/data --name uptime-kuma louislam/uptime-kuma:2。跑起来后浏览器打开「这台机器的 IP:3001」,第一次进来先选数据库:SQLite 是一个数据库文件,界面上写着推荐小规模部署用;Docker 版还自带一个 MariaDB,不用另外设置。选好再创建管理员账户。不用 Docker 也能装,要 Node.js 20.4 以上,Windows 10 以上、主流 Linux 都支持。
群晖这类能跑 Docker 的 NAS,在容器管理里拉 louislam/uptime-kuma:2 这个镜像就能装,官方 wiki 里收了一篇群晖的安装教程(注明是非官方作者写的)和群晖反向代理的设置方法。NAS 用户要注意 README 里一条:数据目录不支持放在 NFS 网络共享上,要映射到本地目录或 Docker 卷。
安全上两件事。第一,按默认命令装,面板在这台机器的所有网卡上都能访问,别直接映射到公网;只想本机访问,把端口写成 127.0.0.1:3001:3001,要从外面看就走反向代理加 HTTPS。设置里有个「禁用登录验证」,别开;能开两步验证就开。第二,装过的先升级到 2.5.11。它修的那个远程代码执行漏洞需要管理员身份才能触发,细节作者说 7 天后公开;前一个 2.5.10 把 Docker 镜像里的 Node.js 升到了修过高危漏洞的版本,不用 Docker 装的要自己升 Node.js。升级方法照官方 wiki:重新拉 louislam/uptime-kuma:2 镜像,停掉删掉旧容器,用原来的参数和同一个数据卷再建一个,监控项和通知设置都在数据卷里,不会丢。
它值得装:一行命令换来有人替你盯着
家里跑着 NAS 或几个 Docker 服务的人,缺的往往是有人替你盯着。Uptime Kuma 把这件事做成了一行命令加一个网页,挂了的消息直接进你天天看的钉钉或飞书。只有一两个服务要看的话,用现成的第三方监控也够,服务多了、想把数据留在自己手里再装它。
热门跟贴