立即开始
全部 VPS 应用
监控

Uptime Kuma:在您自己的服务器上监控在线状态

一款自行部署的监控工具,每分钟检查您的网站和服务,一旦有服务无响应,立即通知您。

订购装有 Uptime Kuma 的服务器 查看 VPS 套餐

关于 Uptime Kuma

Uptime Kuma 是由开发者 Louis Lam 发起的开源监控工具,如今已是 GitHub 上星标最多的自托管项目之一。它检查各类目标是否有响应:HTTP(S) 网站、页面关键词、TCP 端口、Ping、DNS 记录、数据库等。

检查失败时,它会通过数十种支持的渠道之一发送通知,包括 Telegram、Discord、Slack、电子邮件和 Webhook。它还会记录响应时间,在 TLS 证书到期前发出提醒,并支持为客户创建公开状态页面。

许多人自行部署它,因为它轻量、免费,界面简洁,几分钟即可完成设置。关键在于将它运行在独立的服务器上:与网站位于同一台机器上的监控,无法在这台机器宕机时通知您。

常见用途

网站宕机时告警

每分钟检查您的网站和 API,一旦无响应,立即通过 Telegram 或电子邮件通知您。

证书到期提醒

在 HTTPS 证书到期前几天收到提醒,而不是从客户那里得知。

公开状态页面

在由您掌控的页面上向客户展示服务的当前状态。

下单之后

服务器首次启动时会安装 Uptime Kuma 并在防火墙中开放 3001 端口,监控可通过 http://your-server-address:3001/ 访问。首次访问时需创建管理员账号,因此请在服务器就绪后立即打开该地址。之后添加第一个监控项并连接通知渠道。

部署位置

Uptime Kuma 从其运行的位置发起检查。与被监控服务位于同一台服务器上的监控会随它们一起宕机,无法向您发出告警,因此请将它部署在与被监控对象不同的服务器上。

为 Uptime Kuma 配置自有域名和 HTTPS

默认情况下,Uptime Kuma 通过服务器 IP 地址以普通 HTTP 提供访问。如需为它配置 status.example.com 这样的名称并启用证书,请在您的 DNS 中为该名称创建一条指向服务器 IPv4 地址的 A 记录,然后在其前面部署 Caddy:Caddy 会自动申请并续期免费的 Let's Encrypt 证书。以下命令适用于我们应用服务器所用的 Ubuntu 24.04。

在控制面板中,为服务器防火墙开放 TCP 80 和 443 端口:Caddy 需要通过它们获取 Let's Encrypt 证书并提供网站服务。

apt install -y caddy
cat > /etc/caddy/Caddyfile <<'EOF'
status.example.com {
    reverse_proxy 127.0.0.1:3001
}
EOF
systemctl reload caddy

配置域名后,即可与客户分享 Uptime Kuma 的状态页面:创建状态页面,选择要显示的监控项,然后提供 https://status.example.com/status/your-page 链接。您也可以在状态页面的设置中为其单独绑定域名。

域名生效后,就不再需要直接使用 3001 端口:在 /opt/uptime-kuma/compose.yml 中将 "3001:…" 改为 "127.0.0.1:3001:…",运行 docker compose up -d,并从防火墙中移除 3001 端口。此后 Uptime Kuma 只能通过 HTTPS 访问。

更新 Uptime Kuma

/opt/uptime-kuma/compose.yml 中的镜像固定为具体版本,因此直接运行 docker compose pull 只会再次拉取相同版本。如需更新,请将 image: 行中的版本改为目标版本(请先阅读发布说明),然后拉取镜像并重新创建容器。数据保存在 Docker 卷中,不会丢失。

cd /opt/uptime-kuma
nano compose.yml        # the new version in the image: line
docker compose pull
docker compose up -d

备份 Uptime Kuma

在控制面板中,您可以开启整台服务器的每日备份(套餐价格的 +20%,保留最近 7 份),并可从其中任意一份恢复服务器。不过,仍建议将应用自身的数据另存为文件:这样可以迁移到其他服务器,或在不回滚其他内容的情况下单独恢复。

监控项、通知设置和检查历史保存在 uptime-kuma_uptime_kuma 卷(/app/data)中。请短暂停止应用,以确保数据库文件在一致状态下被复制:

cd /opt/uptime-kuma && docker compose stop
docker run --rm -v uptime-kuma_uptime_kuma:/data -v /root:/backup alpine \
  tar czf /backup/uptime-kuma-$(date +%F).tgz -C /data .
docker compose start

如何运作

  1. 在服务器订购页面选择 Uptime Kuma,并选一个内存足够的套餐。
  2. 服务器首次启动时会自动安装应用,通常几分钟内完成。
  3. 在控制面板中打开服务器:访问地址和登录信息都在那里。

关于 Uptime Kuma 的问题

够用。Uptime Kuma 很轻量:最低配置为 1 GB 内存和 20 GB 磁盘,可轻松处理数十个监控项。若有数百个短间隔监控项,建议使用 2 GB 内存。
最好不要。如果两者共用一台服务器,服务器故障时监控也会一起宕机,不会发出任何告警。使用一台独立的小型服务器才是可靠的方案。
支持。小型 ARM 套餐和 x86 套餐同样适用。
通过您在 Uptime Kuma 中设置的通知渠道:Telegram、SMTP 电子邮件、Slack、Discord、Webhook 等。添加一次渠道后,将其关联到各个监控项即可。
第一个打开该地址的人会创建管理员账号,因此请在服务器就绪后立即打开 http://your-server-address:3001/。

监控中的其他应用