服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- cloudflared 2026.11.0 开始在 Tunnel ingress 匹配前处理分号分隔的路径参数。
- Cloudflare 将影响范围限定为需要 Access 校验的 Tunnel 规则;没有这类规则的配置不受影响。
- 当前默认关闭;2027-02-08 起的新 cloudflared 发布版计划默认开启,日期取代此前的 2027-01-25。
- 送往源站的 URL 路径保持不变;先对比入口规则命中、Access 校验结果和源站收到的路径。
先把版本与默认值分开看
Cloudflare 在 2026-11-12 的更新说明中宣布,Cloudflare Tunnel 从 Tunnel 连接器 cloudflared 2026.11.0 起会在 ingress 规则匹配前处理分号分隔的路径参数。这是对 2026.10.0 引入的 URL 标准化的扩展;公告描述的是匹配阶段的路径处理,不应推断为每条 Tunnel 路由都会改变。
这项设置目前默认关闭。Cloudflare 计划从 2027-02-08 起,让新发布的 cloudflared 版本默认开启;该日期比此前公布的 2027-01-25 晚两周。它描述的是计划中的新版本默认值,不代表今天的运行环境已经开启。
先确认规则是否要求 Access 校验
Cloudflare 将受影响范围限定为使用 Access 校验规则的 Tunnel 配置,并明确表示没有这类规则的配置不受此次变化影响。先从实际使用的 ingress 规则中找出需要 Access 校验的部分,再决定是否安排专门验证,不要把所有 Tunnel 一概视为受影响。
分号分隔的路径参数会在规则匹配前被标准化,因此包含这类参数的请求值得核对预期的 ingress 命中和 Access 校验结果。公告只说明这一类路径参数,不应扩展解读为所有 URL 编码、查询参数或源站处理都发生变化。
把匹配路径与源站路径分开验证
Cloudflare 明确说明,发送到源站的 URL 路径保持不变。测试时把两个观测点分开记录:Tunnel 在 ingress 规则匹配时选择了什么规则,以及源站最终收到什么路径。这样可以避免把匹配逻辑的变化误写成源站路径被重写。
如果启用后访问结果不同,先对照运行的 cloudflared 版本、相关 ingress 规则和 Access 校验结果,再核对源站侧记录。不要仅凭页面返回状态推断具体是哪一层改变,也不要把未核实的源站路径变化当作 Cloudflare 已宣布的行为。
用隔离测试覆盖实际 ingress
从实际运行的 cloudflared 版本和 Tunnel 配置清单开始,筛出要求 Access 校验的 ingress 规则。在获准的隔离环境中选择有代表性的请求,其中包含分号分隔的路径参数,对比当前默认行为与启用新标准化后的规则匹配结果。
按团队现有 Access 策略分别检查允许与拒绝的请求,核对预期 ingress 规则、Access 校验是否执行,以及源站观测到的路径。记录版本、规则、每个副本的设置和测试结果;不要把测试流量或临时例外直接复制到生产规则。
在授权环境明确选择是否启用
若要在计划日期前试用,Cloudflare 提供两种显式启用方式:使用 CLI 选项 --disable-path-normalization=false,或在每个 cloudflared 副本上设置 TUNNEL_DISABLE_PATH_NORMALIZATION=false 并重启。环境变量方法要求逐个副本配置;测试多副本环境时,也要确认记录覆盖了实际参与的副本。
若暂不提前启用,就按自己的升级策略继续核对后续版本。采用 2027-02-08 之后发布的 cloudflared 版本前,先验证要求 Access 校验且路径包含分号分隔参数的规则,并为配置变化保留明确的回退办法。
资料来源
常见问题
Cloudflare 有没有公布第一个默认开启该行为的 cloudflared 版本号?
没有。公告给出的是从 2027-02-08 起新发布版本的默认行为,没有列出具体版本号。选定升级版本时,应再核对该版本自己的发布说明和实际默认设置。
2027-02-08 到来时,现有 Tunnel 会自动升级吗?
公告描述的是该日期起新发布版本的默认值,没有说账户会自动升级或现有部署会被强制迁移。请结合自己的版本固定和升级流程,检查实际运行的 cloudflared 版本。