进阶 uptime.kuma.pet 2026-11-20 10:30:00 · 8 阅读

第16章 Status Page(状态页)

Status PageThings You Should Know

状态页面向公众开放,供用户检查服务运行状况。

状态页会缓存结果,缓存时长为 5 分钟。

状态页本质上就是一个传统的网页。因此,其数据刷新响应速度不如仪表盘快。

状态页每 5 分钟自动刷新一次。

default 是保留的 slug 参数,用于向后兼容(例如:http://example.com/status 实际指向 http://example.com/status/default)。

多个状态页

(Version >= 1.13.0)

状态页支持域名配置

(Version >= 1.14.0)

现在,你可以根据不同的域名展示不同的状态页。

配置步骤

如果你没有使用反向代理,请将 Uptime Kuma 暴露在 80 端口。

如果你正在使用反向代理,请在反向代理中添加你的域名,并将其指向 Uptime Kuma。

(⚠️ 注意:对于 Apache 或 nginx 等代理服务器,你需要将 X-Forwarded-Host 或 Host 头转发给 Uptime Kuma,否则 Uptime Kuma 无法识别当前的域名)

在你的 DNS 管理中添加该域名的 A 记录或 CNAME 记录。

在状态页设置侧边栏中添加你的域名。

这是一个示例,它们都来自同一个实例:

https://status.louislam.net

https://status.kuma.pet

自定义子目录 / 在状态页中自定义 HTML

注意事项

要实现以下功能,必须设置环境变量 UPTIME_KUMA_DISABLE_FRAME_SAMEORIGIN=true。这将允许其他页面将 Uptime Kuma 嵌入为 iframe,但会使你的站点容易受到点击劫持(clickjacking)攻击。

更改 Uptime Kuma 子目录的问题追踪于 https://github.com/louislam/uptime-kuma/pull/1092 ,将脚本/meta 标签嵌入 Uptime Kuma 的问题追踪于 https://github.com/louislam/uptime-kuma/issues/3115 。一种绕过此限制的方案是利用 iframe。以下是配置示例(将 INSERT_{...}_HERE 替换为你自己的值):


    
        
        
        
        
        INSERT_TITLE_HERE
    
    
        
    

设置开发环境

上一页

Systemd 单元文件

除了提供的 pm2 说明外,你还可以使用 systemd 在系统启动时更轻松地启用和运行 Uptime-Kuma。

评论 (0)