GGitHub 趋势观察站
每日 07:00 更新订阅EN
← 返回今日榜单

精选指南 · 编程与开发

Uptime Kuma

用 Docker 在本机启动监控器和测试网页,观察一次人为中断如何被发现,再确认网页恢复。

访问 GitHub 仓库 ↗
最近上榜 · 2026-11-15#11

当日排名

+432当日新增 Star94,215总 Star
← 全部精选指南

入选理由:网站不可用是常见运维问题,官方安装、端口和检查配置均可核实。用两个容器就能观察故障与恢复,补充目录已有的 Prometheus 指标采集指南。

入选:2026-11-14 · 资料核对:2026-11-14。根据官方资料整理,未进行安装与功能实测。

Uptime Kuma:用本机练习记录网页中断与恢复

它解决什么问题

打开网页一次只能知道当时是否有响应。Uptime Kuma 会定时访问你指定的地址,记录正常、失败和恢复的时间。配置通知渠道后,也能在服务异常时发消息。

这次练习用一个独立的 Nginx 容器作为样本站点。你会在管理界面添加一项 HTTP 监控,停止样本站点,等到失败记录出现,再启动它并检查恢复记录。

适合谁,哪些情况不适合

适合维护个人网站、内部工具或家庭服务器,希望知道服务何时失去响应的人。第一次试用可先做这组练习,后续再替换为自己有权探测的地址。

监控器和站点在同一台机器上时,机器断电会同时停掉二者。需要从公网用户视角验证连通性时,应把探测运行在另一台机器或网络上。需要定位接口变慢的原因时,可以结合应用日志和性能指标。

环境与准备

在 Linux 上准备可运行 Linux 容器的 Docker Engine,在 macOS 或 Windows 上可使用处于 Linux 容器模式的 Docker Desktop。先在终端运行 docker version,确认能看到服务器版本。练习使用 Docker Engine 28.0.0 或更新版本,Docker 文档记载更早版本在某些同网段场景下仍可能访问发布到本机回环地址的端口。

你需要能下载两个镜像,并让主机的 13001 端口可用。练习使用在官方发行页核实的 Uptime Kuma 2.5.11,Kuma 数据写入 Docker 本地命名卷。命令可在任意目录执行,取样行为发生在两个容器共用的网桥内。管理界面经 IPv4 本机回环访问。以下步骤依据官方文档与代码编写,状态变化为预期结果。

安装与第一次使用

1. 启动样本站点及监控器。 在你准备用来练习的机器上打开终端,执行这三条命令。各命令成功后再执行下一条。

docker network create kuma-lab-net
docker run -d --name kuma-lab-web --network kuma-lab-net nginx:alpine
docker run -d --name kuma-lab-monitor --network kuma-lab-net -p 127.0.0.1:13001:3001 -v kuma-lab-data:/app/data louislam/uptime-kuma:2.5.11

Nginx 使用镜像自带的示例首页,未向主机发布端口。两个容器加入同一个自定义网桥,监控器可以用 kuma-lab-web 这个容器名访问样本站点。在终端运行 docker ps,确认两个容器都显示运行中。

2. 添加 HTTP 监控。 在同一台机器的浏览器打开 http://127.0.0.1:13001,按首次设置页面创建管理员。选择「添加监控项」,填写以下项目后保存。

  • 监控类型选 HTTP(s),显示名称填「本机实验网页」。
  • URL 填 http://kuma-lab-web/,这是 Kuma 容器可解析的名字。
  • 心跳间隔设 20 秒,重试次数设 0。保留默认的其他检查选项,本次无需配置通知。

等到面板出现一条正常记录,确认已经完成首次检查。若浏览器直接访问容器名失败,以 Kuma 的监控结果为准,容器名解析由练习网桥提供。

3. 观察中断和恢复。 回到终端,执行 docker stop kuma-lab-web。保持浏览器打开,等待下一次探测和可能的连接超时,在该监控项中确认出现失败记录,记下时间。看到失败后,再执行 docker start kuma-lab-web。等待下一次成功记录,确认同一个监控项恢复正常。停止和启动之间留够一次探测时间,才有机会在界面里看到中断。

实验完成后,可以用 docker stop kuma-lab-monitor kuma-lab-web 暂停两个容器。之后用 docker start kuma-lab-web kuma-lab-monitor 恢复练习,命名卷会保留账号和监控历史。

主要能力与典型场景

  • 核对网页是否真的加载了预期内容。 对你控制的静态页面,可另建关键词监控,检查响应正文是否含有预先约定的文字。
  • 检查不同层级的连通性。 TCP 检查能观察端口是否接受连接,HTTP 检查还能观察网页是否按预期应答。把两项记录放在一起,有助于判断问题发生在哪一层。
  • 通知和状态页按需配置。 为正式服务接入通知前,先用样本站点验证故障和恢复是否会以预期方式送达。向用户展示状态时,只选择适合公开的项目。

常见问题与排错

  • 管理界面打不开。 确认访问的是 127.0.0.1:13001,用 docker ps -a 和 docker logs --tail 50 kuma-lab-monitor 查看启动状况。若 13001 已占用,给这次练习选另一空闲的主机端口并使用对应 URL。
  • 样本站点始终失败。 检查 URL 和容器名是否一致,再运行 docker network inspect kuma-lab-net,核对两个正在运行的容器都接在该网桥。监控地址应使用样站容器名。
  • 停启后没有失败记录。 如果两次操作落在同一个探测间隔内,这次中断可能未被采样。延长停止时间,先确认失败,再恢复容器。
  • 重建后找不到配置。 核对启动时使用的卷名和容器目录。复用 kuma-lab-data:/app/data 才会读到这次练习保存的数据。

费用、隐私与限制

Uptime Kuma 代码采用 MIT。本地练习需要镜像下载、存储和机器运行资源。改用云服务器或通知服务时,费用取决于你所选的服务。

监控配置和记录保存在本地卷。接入通知提供方后,告警会发到对应服务,目标地址或故障信息可能出现在消息里。公开状态页前先查看要展示的项目。官方安装文档要求使用本地目录或卷,NFS 不在支持范围内。

这次练习的检查周期是 20 秒,短于探测间隔的中断可能不会留下记录。2.5.11 发行说明列有依赖安全修复,长期使用时应查看当前稳定版及其安全更新。

官方资料