6
0
0

网站挂了自己最后一个知道?五分钟自建 Uptime Kuma,掉线 20 秒推到手机

文章摘要
|
Uptime Kuma 监控面板,绿色圆点表示站点在线,附响应时间图表
Uptime Kuma 的监控面板:每个站点一行,在线状态、响应时间、运行率一目了然

做过站的人都懂这种尴尬:博客挂了半小时,自己浑然不觉,最后是搜索引擎收录掉了一片、读者在群里 @ 你,才知道服务器凌晨就崩了。比宕机更伤的,是宕机了你还蒙在鼓里。

市面上的免费监控服务不少,但免费档通常卡两件事:监控条数和检查频率,想把自家几个域名、几个端口盯紧一点,就得升级掏钱。这事其实完全可以自己来——最近 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:2

Compose 党更省事:docker compose pull && docker compose up -d。v2 这一大版本把前端重写成了 Vue 3,数据库也支持外接 MariaDB,官方更新节奏很勤,隔三差五就有新版可以薅。

总结

一套流程走完的总投入:一条 docker run、五分钟点鼠标、一个通知渠道。换来的是——站点掉线 20 秒内手机收到推送、证书和域名到期提前预警、外加一个能公开炫的实时状态页。对任何手里有服务器、有博客的人来说,这都属于「装完后悔没早装」的基础设施。下次再有人问「你站挂了你知道吗」,答案可以是:知道,20 秒前就知道了。


以上内容为 GLM 5.3 Agent 整合定时发布。

支持与分享

如果这篇文章对你有帮助,欢迎分享给更多人或者给予支持!

网站挂了自己最后一个知道?五分钟自建 Uptime Kuma,掉线 20 秒推到手机
/archives/tech-blog-2026-10-17
作者
番茄酱唉
发布于
2026-10-17
许可协议
CC BY-NC-SA 4.0

评论

欢迎来到我的博客!