别点 Google 第一个结果:Uptime Kuma 2.5.11 自托管踩坑清单

429次阅读
没有评论

共计 4220 个字符,预计需要花费 11 分钟才能阅读完成。

在 Google 搜 Uptime Kuma,排在前面的 uptimekuma.co 不是官方网站。这句话不是我总结的,是项目作者写在 GitHub 仓库 README 里的警告:官方不控制那个站点,安装请按仓库里的指南来。

2026 年 11 月 12 日,这个项目发布了 2.5.11,发行说明里写明包含安全修复。本文实测 2.5.11(截至 2026 年 11 月 19 日最新正式版为 2.5.12,含安全修复;我没有升级测试 2.5.12)。已经在用的人,请先按官方最新正式版更新再往下折腾。2.5.11 的修复细节官方写了 7 天后才公开,我这里不转述、也不推测。

Uptime Kuma 是一套自己托管的存活监控工具。你把它装在自己的电脑、NAS 或服务器上,加网站、端口或 Ping 检查,挂了可以通过 Telegram、邮件等渠道通知你,也可以做公开状态页。它回答的是「现在活着吗」,不是「为什么变慢了」——后面那种问题要另找指标系统。仓库地址是 https://github.com/louislam/uptime-kuma,协议 MIT。我写这篇时 GitHub 显示约 93,850 星,当天日榜上有 61 星。官方站点是 https://uptime.kuma.pet,演示在 https://demo.kuma.pet/start-demo,演示数据大约 10 分钟会清掉。

我在 Linux 测试机上用官方镜像 louislam/uptime-kuma:2 跑起来,日志和「设置 → 关于」都写的是 2.5.11。

别点 Google 第一个结果:Uptime Kuma 2.5.11 自托管踩坑清单

▲ 示意图:安装请走官方仓库,不要把搜索结果里靠前的未授权站点当成官网

· · ·

PART 01

官方 Compose 会把面板暴露到所有网卡

官方仓库根目录的 compose.yaml 只有这几行:

services:
  uptime-kuma:
    image: louislam/uptime-kuma:2
    restart: unless-stopped
    volumes:
      - ./data:/app/data
    ports:
      - "3001:3001"

README 写得很直白:这样启动后,服务会听在所有网卡上,本机 http://localhost:3001 能开,局域网或公网 IP 的 3001 端口也能开。官方 docker run 说明里另给了一行改法,只绑本机:

docker run ... -p 127.0.0.1:3001:3001 ...

我实际用的就是官方这份 Compose,只把端口改成了 "127.0.0.1:3001:3001"。改完之后,本机 http://127.0.0.1:3001 可以打开,用这台机器的局域网地址去访问 3001,连不上。

下载官方 compose.yaml → 把端口改成 127.0.0.1:3001:3001 → docker compose up -d → 浏览器打开 http://127.0.0.1:3001

🍎 不要随手把面板裸放到公网

管理界面里会有监控目标、之后还可能填通知令牌。要外网访问,先把端口留在 127.0.0.1,再用带 HTTPS 的反向代理转出去。官方还提醒:反代必须转发 WebSocket 的 Upgrade 和 Connection 头,否则页面能打开、数据不会实时刷新。这一步我这次没做,没有可写的反代截图。

>

另外,只有在你确实要监控同一台机器上的 Docker 容器时,才需要挂 /var/run/docker.sock。官方也把这当成高权限入口。我这次只做 HTTP 监控,没有挂这个文件。

别点 Google 第一个结果:Uptime Kuma 2.5.11 自托管踩坑清单

▲ 示意图:官方默认会把 3001 绑到所有网卡,生产环境应先改成只听本机

· · ·

PART 02

先确认你跑到的是 2.5.11

louislam/uptime-kuma:2 是官方的 v2 稳定标签,会跟着正式版走。我这次拉取后,镜像创建时间是 2026-11-12T09:15:31Z,容器日志第一屏写着:

Welcome to Uptime Kuma
Your Node.js version: 22.23.5
Uptime Kuma Version: 2.5.11

进到「设置 → 关于」,界面同样写着版本 2.5.11、前端版本 2.5.11。2.5.11 的 GitHub Release 发布于 2026-11-12T09:20:06Z,也就是北京时间 17:20。同一天稍早还有 2.5.10,发行说明提到 Docker 镜像把 Node.js 升到了 22.23.5;我这台容器里看到的正是这个 Node 版本。

已经在跑旧版本的,更新前先备份整个 data 目录,再执行:

docker compose pull
docker compose up -d

🍎 只提醒你更新,不展开那条安全修复

2.5.11 的发行说明写了存在安全修复,并注明细节 7 天后公开。请按官方最新正式版更新。不要在搜索引擎里拿旧版本对照着试。

别点 Google 第一个结果:Uptime Kuma 2.5.11 自托管踩坑清单

▲ 本机「设置 → 关于」截图,版本为 2.5.11(北京时间 2026 年 11 月 14 日上午,Linux 测试机)

· · ·

PART 03

第一次打开会问数据库,默认高亮不是 SQLite

容器起来之后,浏览器会被转到 /setup-database。2.5.11 这一版提供三个选项:Embedded MariaDB、MariaDB/MySQL、SQLite。我打开时,界面默认高亮的是 Embedded MariaDB。点到 SQLite 后,页面上的说明是:这是一个简单的数据库文件,推荐小规模部署使用;在 v2.0.0 之前,Uptime Kuma 默认用的就是 SQLite。

我选了 SQLite,点「下一步」。等了大约一两秒,页面跳到「创建管理员账户」。我在本地建了测试管理员,密码没有写进这篇文章。

别点 Google 第一个结果:Uptime Kuma 2.5.11 自托管踩坑清单

▲ 本机首次安装画面:数据库选 SQLite(北京时间 2026 年 11 月 14 日上午)。打开时默认高亮的是 Embedded MariaDB,需要自己点一下。

官方文档还写了:数据目录要映射到本地磁盘或 Docker volume,不支持 NFS。SQLite 需要 POSIX 文件锁,挂到网络盘上容易把库弄坏。备份不要只依赖界面里导出的 JSON——那是配置备份。完整做法是先停容器,再打包整个 data 目录(里面有 kuma.db 以及可能出现的 -wal、-shm 和上传文件)。

· · ·

PART 04

容器出不去网时,监控会先报 ENOTFOUND

管理员建好后,右上角可以「添加监控项」。监控类型默认是 HTTP(s)。我加的第一条是:

  • 显示名称:科技喵仔博客
  • URL:https://www.kejimiaozai.com
  • 心跳间隔:60 秒
  • 重试次数:1

保存之后,我先看到的不是绿色的「正常」,而是 getaddrinfo ENOTFOUND www.kejimiaozai.com,状态先是「重试中」,随后变成「故障」。

这不是博客当时挂了。同一时刻,我在宿主机上访问 https://www.kejimiaozai.com,返回的是 HTTP 200。进到容器里再查,www.kejimiaozai.com 和 example.com 都解析失败。原因出在这台测试机的环境:系统没有 iptables,Docker 默认网桥里的容器出不去网,DNS 也就失败了。面板本身已经只绑在 127.0.0.1:3001,这一步没有把管理界面暴露到外网。

我后来改用 host 网络,并加上官方环境变量 UPTIME_KUMA_HOST=127.0.0.1,让程序自己只听本机。容器日志出现 Custom hostname: 127.0.0.1 和 Listening on: http://127.0.0.1:3001。再用局域网地址访问 3001,仍然连不上。同一条监控在北京时间 08:06:43 返回 200 – OK,当时响应约 1546 毫秒,详情页稍后显示当前响应 1636 毫秒、24 小时平均 1591 毫秒。证书有效期显示到 2027-01-04,还剩 51 天。

仪表盘左侧那条监控的在线时间一度只有 40% 到 50%,是因为前面那几次 DNS 失败也被算进了历史,并不表示站点一直不可用。

别点 Google 第一个结果:Uptime Kuma 2.5.11 自托管踩坑清单

▲ 示意图:同一条 HTTP 监控,在容器能出网之后变成正常

别点 Google 第一个结果:Uptime Kuma 2.5.11 自托管踩坑清单

▲ 本机仪表盘(北京时间 2026 年 11 月 14 日 08:07 左右)。「科技喵仔博客」在 08:06:43 显示 200 – OK;前面的故障记录来自容器还出不去网的时候。

别点 Google 第一个结果:Uptime Kuma 2.5.11 自托管踩坑清单

▲ 「科技喵仔博客」监控详情(北京时间 2026 年 11 月 14 日上午)。检测频率 60 秒。

为了确认故障状态长什么样,我另加了一条 HTTP 监控,地址是 https://this-site-does-not-exist.invalid(.invalid 是保留域名,不会指向某个真实网站)。这条一直是「故障」。容器能出网之后,报错从 ENOTFOUND 变成了 TLS 握手失败,状态仍然是故障。我没有对真实网站做任何故障注入。

你自己装的时候,如果 Docker 网络是正常的,用官方 Compose 并绑 127.0.0.1:3001:3001 即可,不必改成 host 网络。host 网络只是这台测试机在没有 iptables 时的权宜办法。

间隔我建议先用 60 秒,重试设 1 到 3 次。官方最短可以到 20 秒,设太短时,一次网络抖动就容易把通知刷爆。

· · ·

PART 05

通知渠道很多,这次我没有真的发出去

「设置 → 通知」里写着:暂不可用,请先设置。点「设置通知」会弹出表单,通知类型列表里能看到 Telegram、Discord、Webhook、邮件等很多选项。默认打开的是 Telegram,要填机器人令牌和 Chat ID,页面上写着令牌可从 @BotFather 获取。

我只看到了这些设置项,没有填写令牌,也没有点测试或保存出一条可用的通知渠道。所以这篇文章不能写成「我已经收到过宕机推送」。官方文档里有各渠道的配置方法;要真用起来,还得把通知分配给对应的监控项,页面上写了:通知必须被分配给监控项才能正常工作。

别点 Google 第一个结果:Uptime Kuma 2.5.11 自托管踩坑清单

▲ 本机「设置 → 通知 → 设置通知」表单(北京时间 2026 年 11 月 14 日上午)。我没有填写令牌,也没有实际发出通知。

· · ·

它适合有几个网站或服务、希望挂了能自己先知道、又想把数据留在自己机器上的人。它不适合用来做 CPU、内存、慢查询这类深度分析。监控面板自己也会挂,如果业务和监控在同一台机器上,这台机器宕机时你可能仍然收不到通知——条件允许的话,把监控放到另一台机器上更稳妥。这一点我没有做双机实测,只是把边界说清楚。

如果你也在自己搭别的服务,站内还有一篇 开源记账 Sure 的自托管实测,同样是 Docker 自建,但用途不同,不是这篇的续篇。

安装仍以 GitHub 仓库 louislam/uptime-kuma 和官方站点 uptime.kuma.pet 里的指南为准。

正文完
 0

版权声明:除特殊说明外本站文章皆由CC-4.0协议发布,转载请注明出处。

科技喵仔
版权声明:本站原创文章,由 科技喵仔 于2026-11-14发表,共计4220字。
转载说明:除特殊说明外本站文章皆由CC-4.0协议发布,转载请注明出处。
评论(没有评论)
验证码
    中文English