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

第17章 状态页(Status Page)

状态页须知

状态页面向公众展示服务状态。
状态页结果缓存 5 分钟。
状态页与传统网页类似,更新响应速度不及仪表盘。
状态页每 5 分钟自动刷新。
default 是保留的 slug,用于向后兼容(http://example.com/status 指向 http://example.com/status/default)。

多个状态页

(版本 >= 1.13.0)

状态页域名

(版本 >= 1.14.0)
现在可以根据不同域名显示不同的状态页。

步骤

  • 如果你不使用反向代理,应在 80 端口公开 Uptime Kuma。
  • 如果你使用反向代理,请在反向代理中添加你的域名并指向 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。这允许其他页面通过 iframe 嵌入 Uptime Kuma,但会使你面临点击劫持(clickjacking)风险。

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

<html data-lt-installed="true">
    <head>
        <meta charset="UTF-8">
        <meta name="viewport" content="width=device-width, initial-scale=1.0">
        <meta http-equiv="X-UA-Compatible" content="ie=edge">
        <meta name="description" content="INSERT_DESCRIPTION_HERE">
        <title>INSERT_TITLE_HERE</title>
    </head>
    <body style="height: 100vh; margin: 0; padding: 0; overflow: hidden">
        <iframe
            src="INSERT_UPTIME_KUMA_URL_HERE"
            frameborder="0"
            width="100%"
            height="100%"
            allowtransparency="yes"
            style="overflow: hidden; margin: 0; border: none"
        ></iframe>
    </body>
</html>

开发环境设置 | 上一页 | Systemd 单元文件
除了提供的 pm2 说明外,你也可以使用 systemd 在系统启动时更轻松地启用并运行 Uptime-Kuma。

评论 (0)