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

第6章 Cloudflare 补充说明

Cloudflare 补充说明

使用 Cloudflare 监控网站

默认情况下,Cloudflare 对 API 请求不够友好,包括来自 Uptime Kuma 的请求。Cloudflare 可能会拦截这些请求。

你需要在 Cloudflare 仪表板中禁用或绕过“Browser Integrity Check”,可以通过以下任一方法实现:

  • (最简单)将你的 Uptime Kuma 主机 IP 地址添加到 IP Access 规则中作为允许的地址,可选地在你的 Cloudflare 账户中的所有域名上生效。
  • 通过 WAF Custom Rules 和特定头部(header)允许 Uptime Kuma 绕过检查。例如,在 Kuma 的请求头部中添加以下内容(请将 kuma-qwerty123456 替换为你自己的随机值):
    {
        "kumaping": "kuma-qwerty123456"
    }
  • 然后创建一个规则,当存在该头部时绕过 JS 挑战(JS challenge)。你也可以在规则中为多个域名设置条件,例如:
    (http.host eq "domain1" and all(http.request.headers["kumaping"][*] ne "kuma-qwerty123456")) or (http.host eq "domain2" and all(http.request.headers["kumaping"][*] ne "qwerty123456"))
    并在规则的末尾配置 JS 挑战。这样,只有当 kumaping 头部不存在或值不正确时,挑战才会被触发。
  • 使用配置规则(Configuration Rule)为你的 Uptime Kuma IP 地址禁用该检查。

相关讨论:https://community.cloudflare.com/t/api-403-after-enabling-cloudflare/108078/6

如何透过 Cloudflare 代理 Uptime Kuma

请参阅:/docs/Reverse-Proxy#cloudflare

环境变量(1.20.0)对于非 Docker 用户,你可以在根目录创建一个名为 .env 的新文件。格式如下:

Prometheus 集成
在你的 Prometheus 配置中添加以下内容:

评论 (0)