5767 字
29 分钟
规则体系实战:重定向、改写与响应头

源站程序跑得好好的,总有一些事情不值得为它改代码、重新发版:www 和裸域名要统一成一个、老链接换了新路径、某个接口临时要指到另一台机器、响应里少了几个安全头。这些事过去要么改 Nginx 配置,要么改应用代码,要么干脆凑合着不管。现在它们有一个更合适的位置——Cloudflare 的边缘规则:请求还没到达源站,就先在离用户最近的边缘节点上被整理一遍。

这一篇讲 Cloudflare 现行的新规则体系里负责「改请求」的四类规则:Redirect Rules 管跳转,Transform Rules 管 URL 改写和请求/响应头修改,Origin Rules 管回源时改地址、改端口、改 Host 头。Cache Rules 在本系列的缓存篇已经讲过,这里只在执行顺序里带一句。读完这一篇,你应该能独立完成三件最常见的事:把 www 规范化到裸域名、把整站老链接平滑迁移到新域名、给全站响应补上安全头——全程不动源站一行代码。

先把核心结论放在前面:重定向会改浏览器地址栏,重写不会——这是 Redirect 和 Rewrite 最根本的区别,后面所有的选型都从这一句出发。要让用户和搜索引擎都知道「地址变了」,用重定向;只是内部把请求递到另一个路径、对外地址保持原样,用重写。

一、先看全景:新规则体系与执行顺序#

Cloudflare 现在的规则体系按职责拆成了好几类,每一类只管一段「请求生命周期」。一个请求从用户浏览器出发,大致要依次经过这些阶段:先判断要不要直接跳转(Redirect),然后改写 URL(Transform 的 URL Rewrite),再修改请求头(Transform 的 HTTP Request Header Modification),接着决定到底回哪个源、走哪个端口(Origin Rules),再决定缓存策略(Cache Rules),请求才真正发往源站;源站返回之后,响应在回用户的路上还会经过响应头修改(Transform 的 HTTP Response Header Modification)和压缩等阶段。安全类的 WAF 自定义规则、速率限制等阶段也插在这条链里,本篇不展开,只聚焦「改请求」的这几段。

执行阶段(先 → 后)对应规则在这一段做什么
1. 重定向Redirect Rules命中就直接返回 3xx,请求不再往下走
2. URL 改写Transform Rules → URL Rewrite在内部把路径/查询串换成另一个样子
3. 请求头修改Transform Rules → Request Header Modification增、改、删发往源站的请求头
4. 回源改写Origin Rules改 Host 头、改解析目标、改回源端口
5. 缓存设置Cache Rules决定缓存资格与 TTL(缓存篇已讲)
6. 请求到达源站—源站看到的是被前面几步整理过的请求
7. 响应头修改Transform Rules → Response Header Modification在响应回用户前增、改、删响应头

这张顺序表有两个直接的实战推论。第一,重定向排在最前面:一旦某条 Redirect Rule 命中并返回了 301,后面的改写、回源规则对这个请求全部失效,浏览器会拿着新地址重新发一个请求、从头再走一遍。所以「既想跳转又想改写」的需求,要拆成两次请求来理解。第二,同一类规则内部是按列表从上到下依次执行的,顺序靠前的先处理;把更具体的规则放在更宽泛的规则前面,是避免互相截胡的基本功。具体的阶段全集与细节以 Cloudflare 官方文档和控制台为准,这里给出的是与本篇相关的简化链路,足够指导日常配置。

WARNING

规则是在边缘「拦截并加工」请求,配错一条宽泛规则,影响的不是某个页面,而是全站。新建规则时先用尽量窄的匹配条件(具体主机名、具体路径前缀)小范围验证,确认无误再放宽范围;改完立刻用无痕窗口和 curl 各测一次,不要等用户报障。

二、和旧 Page Rules 的关系:新配置一律用新规则#

很多老教程还在教 Page Rules:一条规则里把缓存级别、重定向、SSL 模式等设置打包在一起,按 URL 匹配。需要明确的是,Page Rules 已经进入淘汰通道,Cloudflare 正在推动用户迁移到新规则体系,它的功能已经被拆解到 Redirect Rules、Cache Rules、Transform Rules、Configuration Rules 等新规则里一一对应。新站点、新需求不要再往 Page Rules 里加配置,否则将来迁移时还要再拆一遍。

如果你的站点已经有在跑的 Page Rules,迁移时注意三点。第一,先盘点:把每条 Page Rules 的匹配 URL 和动作列出来,逐项对应到新规则(转发 URL 对应 Redirect Rules、缓存级别对应 Cache Rules、Always Use HTTPS 这类对应 Configuration Rules 或重定向规则)。第二,先建新规则、验证生效,再删旧规则,顺序反过来会出现配置真空期。第三,Page Rules 是「一条命中就不再匹配后续同类设置」的老逻辑,新规则按阶段分层执行,迁移后同一请求可能同时被多个阶段的规则处理,效果需要重新实测,不能想当然地认为和原来完全一致。迁移完成后把 Page Rules 清空,避免新旧两套并存时互相干扰、排查问题时无从下手。

三、Redirect Rules 实战:三个最常见的跳转#

Redirect Rules 的工作方式很直白:当请求的字段(主机名、路径、查询串、来源国家、User-Agent 等)满足匹配条件时,边缘直接返回一个 3xx 响应,告诉浏览器去新地址重新请求。创建入口在控制台对应站点的「规则 → 重定向规则」里,每条规则由三部分组成:名称、匹配条件(通配符或自定义表达式)、跳转参数(目标 URL、状态码、是否保留查询字符串)。免费与付费套餐可建的条数不同,具体以控制台为准。

选状态码是第一课。跳转分临时和永久,又分保不保持原请求方法:

状态码含义方法与请求体典型用途
301永久移动可能被改成 GET域名迁移、www 规范化、链接永久改版
302临时移动可能被改成 GET临时活动页、A/B 分流、维护跳转
307临时重定向严格保持原方法与请求体接口临时迁移、POST 场景临时跳转
308永久重定向严格保持原方法与请求体接口永久迁移且方法不能变

SEO 上的一句结论:永久迁移要用 301(或 308),搜索引擎会把旧地址的索引与权重信号转移到新地址;整站迁移如果误用 302,搜索引擎会继续保留旧域名的索引,新域名迟迟排不上去。反过来,只是临时把流量挪走几天,就老老实实用 302/307,恢复时删掉规则即可,不会给搜索引擎留下「已永久搬家」的错误信号。

例一:www 跳裸域名,保留路径与查询串#

需求:www.example.com/abc?x=1 统一跳到 example.com/abc?x=1,让站点只有一个对外域名。用通配符(Wildcard)写最省事:

规则名称:www 到裸域名
匹配方式:通配符
请求 URL:www.example.com/*
目标 URL:https://example.com/$1
状态代码:301
保留查询字符串:勾选

这里的 * 是捕获符,它把 www.example.com/ 之后的部分(本例是 abc)捕获下来,在目标 URL 里用 $1 引用回去;「保留查询字符串」勾上后,?x=1 会被自动拼到目标地址后面。注意通配符匹配的是去掉协议后的部分,书写格式以控制台给出的示例为准,第一次建完务必实测一个带多级路径和参数的地址。

例二:整站 HTTP 跳 HTTPS(规则版做法)#

把 HTTP 强制跳 HTTPS,更常见的做法是打开站点 SSL/TLS 设置里的「始终使用 HTTPS」开关;但如果你只想对部分路径、或想留一条可随时回滚的规则,用 Redirect Rules 也能做。匹配条件用表达式判断协议:

规则名称:HTTP 强制 HTTPS
匹配方式:自定义表达式
表达式:(http.request.uri.scheme eq "http")
目标 URL:动态,concat("https://", http.host, http.request.uri.path)
状态代码:301
保留查询字符串:勾选

这个表达式里 http.request.uri.scheme 是请求协议,http.host 是主机名,concat() 把几段字符串拼成完整的新地址。需要提醒:跳转目标里的查询串由「保留查询字符串」选项负责拼接,表达式本身只需管到路径为止。

例三:整站换域名,旧域名对应路径 301 到新域名#

站点从 old.com 迁到 new.com,要求每条老链接都落到新域名的同路径上,而不是全跳到首页(全跳首页会让搜索引擎把深层页面当作失效处理)。通配符写法:

规则名称:旧域名迁移到新域名
匹配方式:通配符
请求 URL:old.com/*
目标 URL:https://new.com/$1
状态代码:301
保留查询字符串:勾选

子域名如果也要迁,再补一条 *.old.com/* 的规则,或用表达式按主机名后缀统一处理。迁移类跳转的配套动作还有两个:一是新域名站点的解析与证书先就绪,再开跳转规则,顺序反了用户点开老链接会直接报错;二是跳转规则至少保留几个月,老链接、外部收藏和搜索引擎索引更新都需要时间,别迁完一周就删。

WARNING

重定向循环最常见的成因就是跳转打架:Cloudflare 侧把 HTTP 跳到 HTTPS,源站又因为回源协议或配置问题把 HTTPS 跳回 HTTP,浏览器来回几十次后报 ERR_TOO_MANY_REDIRECTS。典型组合是 SSL 模式设为「灵活」时源站误以为请求来自 HTTP 而强制跳 HTTPS。遇到循环先把两边各自的跳转逻辑列出来对一遍,只保留一处负责跳转。

四、匹配方式:通配符与表达式怎么选#

Redirect Rules 和 Transform Rules 都支持两种匹配与取值方式,理解它们的分工能少走很多弯路。

通配符(Wildcard)是简化模式:一串模式里用 * 表示「任意一段」,可以出现多次,按出现顺序编号,在目标里用 $1、$2 引用。它适合结构规整的场景——域名规范化、目录整体迁移、加前缀去前缀这类「形状不变、只换壳子」的需求,写起来短、可读性好,出错率低。

表达式(Expression)是完整模式:匹配条件用字段加运算符写,比如 (http.host eq "www.example.com")、(starts_with(http.request.uri.path, "/old/"));目标值也可以是动态表达式,用函数现场拼。常用函数先认识这几个:

函数作用例子
concat(a, b, ...)拼接字符串concat("https://", http.host, http.request.uri.path)
lower(x)转小写lower(http.request.uri.path) 统一路径大小写
upper(x)转大写处理需要大写的参数值
substring(x, start, len)截取子串截掉路径固定前缀
regex_replace(...)正则替换复杂路径变换(可用性以控制台为准)

一条实用的表达式版跳转:把 /old-blog/ 前缀下的文章迁到 /posts/ 下,其余路径不动:

匹配表达式:(starts_with(http.request.uri.path, "/old-blog/"))
目标 URL(动态):concat("https://", http.host, "/posts/", substring(http.request.uri.path, 10))
状态代码:301

substring(http.request.uri.path, 10) 里的 10 是 /old-blog/ 这 10 个字符的长度,从第 10 位开始截取,正好把前缀剥掉、保留后面的文章路径——这类「差一位就全错」的计算是重写与跳转排障的头号来源,写完先拿三个真实地址手算一遍再保存。选型原则一句话:能用通配符表达的就别上表达式;表达式留给确实需要按字段判断、按函数拼装的场景。匹配字段、运算符与函数的全集以官方文档为准,控制台的表达式编辑器带字段提示,边写边用它的预览校验。

五、Transform Rules 之一:URL Rewrite,地址栏不变的内部改写#

URL Rewrite 和 Redirect 只差一个字,行为却完全相反:重定向是把浏览器打发去新地址,地址栏会变、会多一次请求;重写是边缘在内部把请求换个路径递给源站,浏览器对此一无所知,地址栏保持原样、没有额外往返。重写解决的是「对外地址要好看/要稳定,对内实现路径是另一套」的问题。

典型场景一:内容目录换了组织方式,但不想让外部链接和用户感知到。站点文章实际存放在 /articles/ 下,对外想暴露成 /blog/:

规则名称:blog 对外、articles 对内
匹配:通配符,请求 URL 为 example.com/blog/*
重写到:/articles/$1(静态改写路径)
查询字符串:保持不变

这样用户访问 example.com/blog/docker-guide,源站实际收到的是 /articles/docker-guide,源站的目录、程序都不用动。场景二:多语言或多版本目录收敛,比如把 /v1/docs/* 内部转到当前文档目录。场景三:给某些路径统一补上或去掉尾缀,比如把无扩展名的请求重写到实际的 .html 文件(静态站托管在源站时常用)。

重写可以改路径,也可以改查询字符串,两者可分别设为「保持不变 / 静态替换 / 动态表达式」。有两条边界要记住。第一,重写只换「递给源站的请求长什么样」,源站程序如果按 Host 头或绝对 URL 生成页面里的链接,生成出来的仍可能是内部地址,需要源站配合或改用重定向,这不是规则能兜底的。第二,重写目标写错一位,源站就是实打实地找不到文件、返回 404,而且因为地址栏没变,用户和你的第一反应都不会怀疑到规则上——排障时记得把重写规则列进嫌疑名单(见第八节)。

六、Transform Rules 之二:给请求头和响应头做增删改#

Transform Rules 里还有两个子类型:HTTP 请求头修改(Request Header Modification)和 HTTP 响应头修改(Response Header Modification)。每个头可以做三种操作:设置(Set,不存在就加、存在就覆盖)、设置动态值(用表达式现场算)、移除(Remove)。请求头修改作用于「发往源站」的方向,响应头修改作用于「返回用户」的方向,两个方向别搞混。

请求头方向的典型用法,是给源站递一个可信的标记。Cloudflare 本身已经会自动给回源请求带上 CF-Connecting-IP(真实访客 IP)、CF-Ray 等头,源站日志和程序应该优先读这些现成的。但有些场景需要自定义:比如同一源站后面挂了两个站点,想让源站按头区分来源,可以加一条规则给某域名来的请求统一设置 X-Site-Mark: main,源站据此打日志或走不同逻辑。再比如把访客所在国家以自定义头递给源站做统计,用动态值把 ip.src.country 写进头里:

规则:请求头修改
匹配:(http.host eq "example.com")
操作:设置动态请求头
头名称:X-Visitor-Country
值(表达式):ip.src.country

响应头方向最常见的活是补安全头。很多老应用没给响应带安全相关的头,在边缘统一补上比逐个改应用现实得多:

规则:响应头修改
匹配:(http.host eq "example.com")
操作 1:设置响应头 X-Content-Type-Options = nosniff
操作 2:设置响应头 Referrer-Policy = strict-origin-when-cross-origin
操作 3:移除响应头 X-Powered-By

X-Content-Type-Options: nosniff 阻止浏览器对响应内容做 MIME 猜测,Referrer-Policy 控制跳转时带多少来源信息,X-Powered-By 这类头纯属把技术栈写在脸上、能删就删。同理,如果源站自己已经在发某个头,边缘再 Set 一次就是覆盖,排查「头怎么有两份/怎么对不上」时要把源站和边缘两边一起看。

WARNING

响应头里有一个要格外小心的:Strict-Transport-Security(HSTS)。HSTS 一旦被浏览器记下且 max-age 设得很长,在有效期内浏览器会拒绝一切 HTTP 访问,配错了短时间无法回滚。确认全站 HTTPS 长期稳定、子域名都覆盖到之前,不要在边缘随手给全站加上大 max-age 的 HSTS,更不要轻易带 preload。

七、Origin Rules:同一域名,按路径回不同的源#

Origin Rules 管的是链路的后半段:请求已经通过前面的阶段,接下来到底发到哪台机器、哪个端口、以什么 Host 头去敲门。默认情况下,回源目标由 DNS 记录决定、端口由请求协议决定、Host 头就是用户访问的主机名。Origin Rules 可以按匹配条件覆盖三样东西:

可覆盖项改的是什么典型场景
Host 头(Host Header)源站收到的 Host 值一台源站按虚拟主机分流多个站点
DNS 记录(DNS Record / Resolve Override)把回源解析指到另一个主机名同域名部分路径回另一台源站
目标端口(Destination Port)回源连接的端口源站服务跑在 8080 等非标准端口

一个把三样用得上的场景:主站 example.com 的普通页面回默认源站,但 /api/ 路径的服务其实跑在另一台机器的 8443 端口上,且那台机器按 Host 头区分租户。可以建一条 Origin Rule:匹配 (starts_with(http.request.uri.path, "/api/")),把 DNS 记录覆盖为后端机的主机名、目标端口覆盖为 8443、Host 头覆盖为后端期望的值。用户侧完全无感,域名和证书都不用变,拆分服务只动一条规则。

这条能力很强,边界也要清楚。第一,Origin Rules 只是「改投递地址」,被指过去的源站必须真的能处理这个 Host 和路径,否则就是把 404/502 换了个地方产生。第二,DNS 覆盖的目标必须是能被正确解析的主机名,填错或目标宕机时,全站会直接报 5xx 且报错页面上看不出是规则的锅,改这类规则务必保留快速回滚的路径(记住原值、改完立刻全链路实测)。第三,改端口只影响 Cloudflare 到源站这一段,用户到 Cloudflare 的端口不变;源站防火墙要放行 Cloudflare 的回源连接打这个新端口,别只改规则忘了放行。

八、排障:规则类问题三板斧#

规则配错的表现通常就三种:跳来跳去、该生效的没生效、改完之后 404。下面按症状给排查顺序。

症状一:重定向循环(ERR_TOO_MANY_REDIRECTS)。 先用 curl -sI https://example.com/路径 看响应头里的 location 指向哪,再对 location 的地址继续 curl -sI,手动跟两三跳,循环的形状立刻现形:是 HTTP 与 HTTPS 之间来回(两边都在做协议跳转,见第三节的 warning,多半还牵涉 SSL 模式「灵活」与源站强制 HTTPS 打架),还是 www 与裸域之间来回(两条规范化规则方向相反,或源站里还留着一条反向跳转)。原则是全网只保留一处负责某类跳转:边缘规则建了,源站里的同类跳转就删掉或关掉。

症状二:规则保存了却不生效。 按这个顺序查:①匹配没命中——路径大小写敏感、主机名对不上、漏了尾斜杠,用表达式的先把条件简化成只匹配主机名验证规则本身能触发,再逐步加回条件;②被同阶段更靠前的规则截胡——同类规则按顺序执行,宽泛规则在前会先处理,把本条拖到更靠前或把前一条的匹配范围收窄;③阶段顺序理解错——期望 URL Rewrite 在 Redirect 之前生效是不可能的,跳转一旦返回,后续阶段对该请求不再执行,需要改方案(比如先在第一次请求里用重写、跳转规则改匹配重写前的地址);④忘了规则只对「经过 Cloudflare 代理(橙云)」的流量生效,灰云直连源站的请求规则一概管不着,拿灰云子域名测试会得出「规则没用」的错误结论。

症状三:重写/回源改完之后源站 404 或 502。 404 先查路径拼接:把规则的匹配段和目标段拿真实地址逐字手算,重点看前缀长度差一位、重复拼接(源站目录本身带前缀又被规则加了一遍)、丢了尾斜杠导致目录索引不触发。502 先查回源目标:Origin Rules 的 DNS 覆盖与端口是否指向真实在跑的服务,源站防火墙有没有放行新端口,Host 头覆盖后源站虚拟主机认不认这个 Host。验证方法:绕开规则,用源站 IP 加 --resolve 或 hosts 方式直连源站按「规则改完后的样子」手工发一次请求,能复现就说明问题在源站侧配置,接不通则是规则侧投递参数写错:

Terminal window
# 按规则改完后的 Host 与路径,直连源站验证
curl -sI --resolve api.example.com:8443:源站IP https://api.example.com:8443/api/health

另外养成一个习惯:任何规则改动后,用 curl -sI 把关键响应头(location、cf-ray、自己加的标记头)留一份记录,出问题时和正常时对比,比对着控制台猜要快得多。

小结#

这一篇的规则体系可以收成几句话。请求进边缘后按阶段走:Redirect 先决定要不要把人送走,URL Rewrite 在内部换路径,请求头修改给源站递标记,Origin Rules 决定最终投递到哪台机器哪个端口,响应回来时再过一遍响应头修改。重定向与重写的分界线是地址栏变不变:对外宣布搬家用 301 重定向,只是内部换实现用重写。Page Rules 已在淘汰通道,新配置一律建在新规则上,老配置按「先建新、验证、再删旧」的顺序迁。匹配能用通配符就不用表达式,表达式里的截取长度这类计算先手算再保存。最后一条纪律:规则的影响面是全站,窄范围验证、改完立刻实测、Origin 与跳转类规则留好回滚路径——做到这三点,边缘规则就是省事的工具,而不是半夜把人叫醒的事故源。

规则体系实战:重定向、改写与响应头
https://www.anexns.cloudns.org/posts/cloudflare-rules-transform/
作者
Anexns
发布于
2026-11-15
许可协议
CC BY-NC-SA 4.0