进阶 uptime.kuma.pet 2026-11-20 10:30:00 · 8 阅读
第15章 使用 Cloudflare Tunnel 搭建反向代理
使用 Cloudflare Tunnel 搭建反向代理
简介
这大概是我见过最容易配置的反向代理方案!
尽管市面上反向代理方案层出不穷,但在我看来,没有哪一种是真正易用且对新手友好的。过去,不少 Uptime Kuma 用户一直询问如何配置反向代理。最近,我发现 Cloudflare 为 Cloudflare Tunnel 新增了网页管理界面,这使得使用过程变得极其简单。你无需复杂配置,即可将 Uptime Kuma 暴露到互联网上。
对于 Docker 用户,只需在“设置”中填入 Cloudflare Tunnel 令牌,就能在互联网上访问 Uptime Kuma 了。
关于 cloudflared 的更多信息:https://www.reddit.com/r/selfhosted/comments/tp0nqg/cloudflare_has_added_a_web_gui_for_controlling/
优点
- 免费
- 全图形界面,无需配置文件
- 可将 Uptime Kuma 置于防火墙后
- 无需暴露真实 IP
- 暴露 Docker 端口是可选的
- 无需 Nginx、Caddy 或 Traefik 等反向代理软件
- 零配置 SSL
- 免费 SSL 证书
缺点
- (如果你已在用 Cloudflare,这点则无妨)必须将域名的 Name Server 迁移至 Cloudflare。
- Docker 基础镜像体积增加 30MB
前置要求
- 域名的 DNS 托管在 Cloudflare 上
- 对于 Docker 用户,目前仅支持基于 Debian 的镜像,尚不支持 Alpine 基础镜像。
- 对于非 Docker 用户,需下载安装 cloudflared。参考链接:https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/install-and-setup/installation/
- Windows 非 Docker 用户可从 GitHub Release 页面下载 msi 安装包:https://github.com/cloudflare/cloudflared/releases/latest
速览(TL;DR)
- 在 Cloudflare Zero Trust 平台创建隧道
- 获取隧道令牌,填入你的 Uptime Kuma 实例
- 映射至 http://localhost:3001
- 完成
详细步骤
步骤其实非常简单。但由于该概念较新,多数人可能不太熟悉,因此有必要详细记录一下。不过相信我,一旦学会了,你根本不需要这篇指南也能配置 Cloudflare Tunnel!(相比之下,配置 Nginx 或 Traefik 时,我从来记不住具体操作,只能每次去网上搜)
前往 Cloudflare Zero Trust 平台
- 进入 Network > Tunnels > Create a Tunnel(网络 > 隧道 > 创建隧道)
- 选择 Cloudflared > Next(下一步)
- 输入隧道名称(例如 uptime-kuma),点击保存
- 点击剪贴板图标复制运行命令
将命令粘贴到文本编辑器中,从命令末尾提取令牌。命令格式如下:
cloudflared.exe service install eyJhIjoiZDA4ZGNiMTUXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
回到你的 Uptime Kuma 实例
- 进入 Settings > Reverse Proxy(设置 > 反向代理)
- 将令牌粘贴至 Cloudflare Tunnel Token 输入框
- 点击 Start cloudflared(启动 cloudflared)
- 返回 Cloudflare Zero Trust 平台,若能看到你的连接器,点击 Next(下一步)
- 选择你偏好的域名,并映射至 http://localhost:3001
- 点击 Save(保存),然后访问 https://<你的域名> 即可!没错,系统还会自动为你配置 SSL!
如何停止
- 选项 1:在 Cloudflare 上删除该域名映射
- 选项 2:在 Uptime Kuma 中点击 Stop cloudflared(停止 cloudflared)并移除令牌
环境变量
你也可通过环境变量设置令牌,cloudflared 将会自动启动。采用此方式,甚至无需将容器端口暴露到宿主机。
UPTIME_KUMA_CLOUDFLARED_TOKEN=
Prometheus API 密钥
你可以启用 API 密钥来管理 Prometheus 指标端点的访问权限。
上一章节:开发环境搭建
下一章节:API 密钥