进阶 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)。你也可以在规则中为多个域名设置条件,例如:
并在规则的末尾配置 JS 挑战。这样,只有当(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"))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 配置中添加以下内容: