网站挂了自己最后一个知道?五分钟自建 Uptime Kuma,掉线 20 秒推到手机
做过站的人都懂这种尴尬:博客挂了半小时,自己浑然不觉,最后是搜索引擎收录掉了一片、读者在群里 @ 你,才知道服务器凌晨就崩了。比宕机更伤的,是宕机了你还蒙在鼓里。
市面上的免费监控服务不少,但免费档通常卡两件事:监控条数和检查频率,想把自家几个域名、几个端口盯紧一点,就得升级掏钱。这事其实完全可以自己来——最近 GitHub trending 和 awesome-selfhosted 榜单的常客、B站 NAS×Docker 圈出镜率极高的开源项目 Uptime Kuma,一台能跑 Docker 的机器上五分钟拉起来,监控条数、检查频率、通知方式全部自己说了算。
一、Uptime Kuma 是什么
Uptime Kuma 是开发者 Louis Lam 维护的自托管监控工具,仓库在 louislam/uptime-kuma。它有几件事做得特别对:
- 监控类型够全:HTTP(s)、TCP 端口、HTTP 关键字、HTTP JSON Query、WebSocket、Ping、DNS 记录、Push、Steam 游戏服务器、Docker 容器都能盯,2.5.0 版本还新增了 NTP 监控;
- 检查频率自己定:间隔最短可以压到 20 秒,掉线基本是半分钟内被发现;
- 通知组件多到离谱:官方 README 的口径是 90+,翻了源码
src/components/notifications目录,目前已经堆了 100 多个通知组件——Telegram、Discord、Slack、Gotify、Pushover、SMTP 邮件这些常客都在,国内玩家关心的钉钉、飞书、企业微信、Server 酱、PushPlus、Bark 也一个不缺; - 附赠公开状态页:可以给站点生成一个 status 子域式的状态页,还能绑定独立域名,挂没挂、历史运行率全部透明;
- 证书和域名到期提醒:HTTPS 监控项直接展示 TLS 证书信息,剩余有效期少于设定天数会发通知,域名到期也有同款提醒——证书过期一周才发现的惨案,从此绝迹。
不确定合不合口味的话,官方放了个在线 Demo(demo.kuma.pet),数据 10 分钟自动清空,可以先去摸一圈再决定要不要自建。
二、五分钟部署:一条命令的事
最省事的 Docker 方式,照官方 README 抄作业:
docker run -d --restart=always \
-p 3001:3001 \
-v uptime-kuma:/app/data \
--name uptime-kuma \
louislam/uptime-kuma:2镜像 tag 用 2 就好,会自动拉 v2 系列的最新版。浏览器打开 http://服务器IP:3001,设置管理员账号密码进入面板,部署环节到此结束——真的只有这么多。
习惯用 Compose 的话,官方仓库里的 compose.yaml 同样极简:
services:
uptime-kuma:
image: louislam/uptime-kuma:2
restart: unless-stopped
volumes:
- ./data:/app/data
ports:
- "3001:3001"docker compose up -d 一把拉起。两个小提醒:一是官方明确不支持把数据目录挂在 NFS 上,乖乖放本地目录或卷;二是如果监控台只打算自己用、后面挂反代,可以把端口绑回本机 -p 127.0.0.1:3001:3001,少暴露一个端口就少一份风险。
三、给博客加第一个监控
点「Add New Monitor」,最常用的三种姿势:
- HTTP(s) 存活监控:Monitor Type 选 HTTP(s),URL 填博客首页,间隔设 20-60 秒,返回非 2xx/3xx 就算挂,这是最基本的体检;
- HTTP 关键字监控:类型选 HTTP(s) - Keyword,URL 填首页,Keyword 填页面上必然出现的文字(比如站点名)。它能抓到一种很阴间的情况——页面返回 200,但内容早被篡改或白屏了;
- TCP 端口监控:盯数据库、SSH 这些不开 HTTP 的服务,3306、22 直接填端口号就行。
顺手在设置里把「TLS 证书过期通知」的阈值天数配好(默认会提前若干天提醒),证书这颗雷就算排掉了。
四、通知:掉线 20 秒推到手机
右上角头像 → Settings → Notifications → Setup Notification,选一个渠道填参数。以最常用的两个为例:
- Telegram:找 @BotFather 建个 bot 拿 token,和 bot 随便说句话后从 getUpdates 接口拿到自己的 chat id,两串字符填进去,点 Test 秒收到消息;
- SMTP 邮件:填服务器地址、端口、账号密码(QQ 邮箱/Gmail 记得用应用专用密码),兼容性最好,懒人首选。
国内玩家可以重点看钉钉、飞书、企业微信的群机器人,或者 Server 酱、PushPlus、Bark 这种微信生态推送——配置都只是「拿一个 webhook/token 填进去」的体力活。渠道建好后,在监控项的 Default Notification 里勾上它,从此掉线 20 秒,手机先于你知道。
五、挂上公网:反代与状态页
监控台自己别裸奔在 3001 端口上,套一层 Nginx 反代 + HTTPS 是标配:
server {
listen 443 ssl;
server_name status.example.com;
# ssl_certificate / ssl_certificate_key 按你的路径填
location / {
proxy_pass http://127.0.0.1:3001;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
# 关键:面板实时刷新依赖 WebSocket
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
}注意 WebSocket 升级头必须带——Uptime Kuma 的实时推送走 socket.io,少了这两行,面板会陷入「转圈不更新」的玄学状态。
对外展示用 Status Pages 功能:新建一个状态页,把想公开的监控项勾进去,访客打开就能看到实时状态和近期运行率,比口头承诺「我们很稳」有说服力得多。管理后台本身支持 2FA,强烈建议开上;状态页则可以放心公开。
六、备份与升级
所有数据(监控项、历史记录、通知配置)都在挂载的 /app/data 目录里,备份一句话:
tar czf uptime-kuma-backup-$(date +%F).tar.gz data/升级就是拉新镜像、重建容器,数据卷原地不动:
docker pull louislam/uptime-kuma:2
docker stop uptime-kuma && docker rm uptime-kuma
docker run -d --restart=always -p 3001:3001 \
-v uptime-kuma:/app/data \
--name uptime-kuma louislam/uptime-kuma:2Compose 党更省事:docker compose pull && docker compose up -d。v2 这一大版本把前端重写成了 Vue 3,数据库也支持外接 MariaDB,官方更新节奏很勤,隔三差五就有新版可以薅。
总结
一套流程走完的总投入:一条 docker run、五分钟点鼠标、一个通知渠道。换来的是——站点掉线 20 秒内手机收到推送、证书和域名到期提前预警、外加一个能公开炫的实时状态页。对任何手里有服务器、有博客的人来说,这都属于「装完后悔没早装」的基础设施。下次再有人问「你站挂了你知道吗」,答案可以是:知道,20 秒前就知道了。
以上内容为 GLM 5.3 Agent 整合定时发布。

