4098 字
20 分钟
重定向规则实战:老链接一个都不能丢

站点刚改完版,或者域名干脆换了新的,老链接点开全是 404:搜索引擎收录的页面、别人收藏夹里存的地址、其他网站链过来的外链,一夜之间全成了死路。重定向规则就是干这个的——在 Cloudflare 边缘直接告诉浏览器「这个地址搬走了,新家在这里」,老链接点开自动落到新页面,收录权重跟着走,访客也无感。

这一篇不讲原理铺垫,全是配方:www 与裸域互跳、HTTP 跳 HTTPS、单个页面改名、整目录迁移、整站换域名,再加上几百上千条老链接的批量导入方法。每条配方都给出控制台里逐项照填的值,抄完部署就能用。

官方文档:https://developers.cloudflare.com/rules/url-forwarding/

一、重定向规则在哪配:一条规则的构成#

登录 Cloudflare 控制台,选中目标域名,左侧进入 Rules → Redirect Rules,点 Create rule 新建。新建时先选匹配方式,二选一:

  • Wildcard pattern(通配符模式):直接填一个带 * 的 Request URL 模式,所见即所得,本篇所有配方都用它;
  • Custom filter expression(自定义筛选表达式):用 http.host、http.request.uri.path 这类字段拼条件,适合「只对某个国家、某种设备生效」这类复合条件。

不管选哪种,一条重定向规则拆开都是四件事:

构成控制台字段说明
匹配条件Request URL(通配符模式)或筛选表达式什么样的请求会被这条规则拦下
目标 URLTarget URL静态填固定地址;动态可用 ${1}、${2} 引用源模式里第几个 * 捕获的内容
状态码Status code301 / 302 / 307 / 308,怎么选看下一节
查询字符串Preserve query string 开关开启后,源 URL 的 ?a=1&b=2 原样带到目标 URL

先记住核心结论:重定向是「永久搬家」还是「临时借住」,全靠状态码表达,配错码比配错地址更难察觉。另外注意配额:免费版每个域名有 10 条这类单条重定向规则(Single Redirects),日常站点足够用,真不够了用第四节的批量重定向。同一域名下多条规则按列表从上到下匹配,命中第一条就执行,后面的不再看——具体规则放前面、宽泛规则放后面,是贯穿全篇的摆放原则。

再补一个进阶形态:选了自定义筛选表达式时,目标 URL 可以选 Dynamic(动态),用表达式现场拼。以「按主机名整站跳转」为例,匹配条件填 http.host eq "old.com",目标表达式填:

concat("https://new.com", http.request.uri.path)

请求进来时,边缘把当前路径实时拼到新域名后面,效果和通配符版整站跳转一样。通配符模式胜在直观、不用学表达式语法;表达式模式胜在条件能叠加(比如「老域名+路径以 /api 开头」才跳)。日常配方用通配符足够,遇到复合条件再切表达式。

二、状态码怎么选:301 / 302 / 307 / 308#

四个码都是「去别处」,区别在两点:是永久还是临时、跳转后请求方法(GET / POST)和请求体保不保留。

状态码永久 / 临时方法与请求体典型场景
301 Moved Permanently永久浏览器可能把 POST 改成 GET 再发页面永久改名、整站换域名、www 规范化
302 Found临时浏览器可能把 POST 改成 GET 再发活动页临时引流、短期维护跳转
307 Temporary Redirect临时方法与请求体原样保留接口地址临时切换、带表单提交的临时跳转
308 Permanent Redirect永久方法与请求体原样保留永久迁移且目标是接口、不能丢 POST

普通网页之间的跳转,访客发的都是 GET 请求,301 和 308 用起来没差别,选 301 最稳妥、兼容性最好;只有当被跳转的是 API 接口或表单提交地址时,才需要认真区分 307 / 308。控制台的状态码下拉里还有一个 303 See Other:强制把请求改成 GET 再发往目标,典型用途是表单 POST 提交后跳到一个结果页。日常迁移用不上它,知道有这回事即可。SEO 方面,搜索引擎只把 301 / 308 理解为「地址永久变更」,会把旧地址的收录与权重信号转移到新地址;永久迁移如果误用 302,搜索引擎会继续保留旧地址的索引,新地址迟迟没有排名。反过来,临时跳转老老实实用 302 / 307,活动结束删掉规则即可,不留后遗症。

三、常用配方:逐个照抄#

以下配方都用通配符模式。示例域名统一写 example.com,替换成你自己的即可。每个配方默认状态码 301、Preserve query string 开启(带参数的老链接跳转后不丢参数),另有说明的除外。

配方 1:www 与裸域互跳#

把 www.example.com 统一到裸域 example.com:

字段填什么
Request URLhttps://www.example.com/*
Target URLhttps://example.com/${1}
Status code301

${1} 就是源模式里唯一的 * 捕获到的部分,也就是路径(含多级目录,* 可以跨 / 匹配)。反过来裸域跳 www,把两个地址对调即可。前置条件别漏:www 这条 DNS 记录必须存在且开启橙云代理,否则请求根本到不了 Cloudflare,规则写得再对也不会触发;DNS 记录的配法见 DNS 记录管理篇。

配方 2:HTTP 跳 HTTPS#

字段填什么
Request URLhttp://*
Target URLhttps://${1}
Status code301

这里的 * 捕获的是 http:// 之后的全部内容(主机名+路径),拼回 https:// 后面即可。其实整站强制 HTTPS 还有个更省事的开关:SSL/TLS → Edge Certificates → Always Use HTTPS,打开后全域 HTTP 请求自动 301 到 HTTPS,一条规则都不用写。两者二选一即可,别叠加使用;证书与 HTTPS 的完整设置见 SSL/TLS 配置篇。

配方 3:单个页面改名#

文章改了 slug、产品页换了路径,这类一对一跳转用静态目标最稳:

字段填什么
Request URLhttps://example.com/old-page
Target URLhttps://example.com/new-page
Status code301

源地址不要带 *,精确匹配这一个 URL;目标地址写完整固定值(必须带 https:// 的完整 URL,只写路径不行)。还有个细节:/old-page 和 /old-page/(带尾斜杠)在匹配时是两个不同的 URL,源站如果两种写法都有流量,就补两条规则,或者改用表达式把路径写成集合:http.request.uri.path in {"/old-page" "/old-page/"},目标选静态。页面多起来之后不要在单条规则里堆几十条同类跳转,攒多了转第四节的批量方案。

配方 4:整目录迁移(通配符保留后缀)#

博客从 /blog/ 搬到 /posts/,几百篇文章的后缀(slug)保持不变,这是通配符最典型的用法:

字段填什么
Request URLhttps://example.com/blog/*
Target URLhttps://example.com/posts/${1}
Status code301

效果:/blog/hello-world → /posts/hello-world,/blog/2024/01/review → /posts/2024/01/review,一级目录平移、后面原样保留。

这里藏着一个最容易踩的编号坑:${n} 按源模式里 * 出现的顺序编号,协议部分的 * 也算一个。如果源模式写成 http*://example.com/blog/*(想同时匹配 HTTP 和 HTTPS),路径部分的捕获就变成了 ${2},目标要写 https://example.com/posts/${2}。写错一位,跳转目标会变成空段或字面量,上线前务必用真实链接验一遍。

配方 5:换域名整站跳转#

老域名 old.com 整体搬到 new.com,路径全保留:

字段填什么
所在域名old.com(规则配在老域名下)
Request URLhttps://old.com/*
Target URLhttps://new.com/${1}
Status code301

三个前置条件:第一,新域名已经接入 Cloudflare 且站点可正常访问;第二,老域名哪怕源站已经关停,DNS 里也要留一条开启橙云的记录占位(随便一条 A 记录即可,流量在边缘就被跳走,不会真打到源站),否则请求进不了边缘、规则无从触发;第三,这条规则要放在老域名所有规则的最前面,避免被别的规则截胡。域名注册本身的转移与接入流程,见 域名转入篇。

配方 6:子域名下线并入主站#

独立博客子域名 blog.example.com 不再维护,内容并进主站的 /posts/ 目录:

字段填什么
所在域名example.com(子域名与主域名同属一个 zone 时,规则配在该 zone 下即可)
Request URLhttps://blog.example.com/*
Target URLhttps://example.com/posts/${1}
Status code301

它本质是配方 4 的跨主机版:匹配条件里把主机名换成子域名,目标里把落点换成主站目录。同理,shop.、help. 这类退役子域名都能用同一形状收编,无非是目标目录不同。子域名的 DNS 记录同样要保持橙云,哪怕对应的服务早已下线。

WARNING

重定向最怕成环:配方 1 把 www 跳到裸域,又在另一条规则里把裸域跳回 www;或者整站迁移后新域名上残留一条指回老域名的规则——两种都会让浏览器原地打转,最后报 ERR_TOO_MANY_REDIRECTS,访客眼里就是「网站打不开」。另一个同级大坑是范围失控:用 https://example.com/* 这类全站通配符做跳转时,先想清楚后台、接口、验证文件这类特殊路径会不会被一起卷走,把自己锁在管理后台门外,就是这么发生的。宽泛规则上线前,先用窄条件灰度,确认无误再放开。

四、批量重定向:上千条老链接一次导入#

单条规则适合「一类链接一条规则」;如果是整站迁移留下的几百上千条一对一映射(每篇老文章对应一个新地址,毫无规律可循),逐条建规则不现实,用 Bulk Redirects(批量重定向):

  1. 它是账户级功能:进入账户主页打开 Bulk Redirects,先建一个 URL Redirect List(重定向列表),逐条添加「源 URL → 目标 URL」,也可以按官方模板用 CSV 文件导入,几千条一次进;
  2. 再建一条 Bulk Redirect Rule 把列表绑上,规则生效后列表里的映射全部开始跳转;
  3. 每条映射可带参数:状态码、是否保留查询字符串、是否包含子域名(Include subdomains)、是否子路径匹配(Subpath matching)、是否保留路径后缀(Preserve path suffix)——后三个开关决定一条映射能「顺带」覆盖多少相邻 URL,导入前先想清楚再勾。

列表里躺着的就是一堆纯粹的一对一映射,长这样:

源 URL目标 URL
https://example.com/2023/05/first-post.htmlhttps://example.com/posts/first-post
https://example.com/Article/Show?id=812https://example.com/posts/legacy-812
https://example.com/download/v1.ziphttps://example.com/releases/v2.zip

这种映射没有通配符可提炼——每条路径都独一无二,正是批量列表的主场。两个使用习惯值得养成:其一,列表是账户级的,同一个列表可以被账户下多个域名的批量规则引用,集团站、镜像站共用一份映射时不用重复维护;其二,后续增删映射只改列表、不用动规则,改完即时生效,适合上线后陆续补漏。

免费版的配额是 5 个列表、合计 10,000 条 URL 重定向,中小站点的历史包袱绰绰有余。执行顺序上,单条重定向规则先于批量重定向执行:同一个 URL 两边都配了,以单条规则为准,正好用来给个别链接留「特例通道」。

五、老 Page Rules 的 Forwarding URL:该迁了#

老站长可能还记得 Page Rules 里的 Forwarding URL(URL 转发),当年配 www 跳转、域名跳转全靠它。它和转换规则一样属于上一代功能:Cloudflare 已从 2025 年 1 月起停止新建 Page Rules,存量规则虽还能跑,官方计划逐步自动迁移到新规则体系。与其等迁移,不如自己动手:一条 Forwarding URL 对应一条 Redirect Rule,照第三节配方重建即可。迁移时只有一个换算要注意:老写法里的占位符 $1,在新规则里写作 ${1};而且新模式是从完整 URL(含协议)开始数 * 的,老模式不带协议时编号一致,带了 http* 时要顺延一位——配方 4 里那个编号坑,迁移时最常翻车。

六、与转换规则的分工#

一句话:要让浏览器地址栏变成新地址、让搜索引擎认新地址的,用重定向;地址不变、只在 Cloudflare 内部把请求换个路径递给源站的,用 URL Rewrite(改写)——两者在规则体系里的位置和更多改写配方,见 规则转换篇。

七、上线后怎么验#

规则部署后等几十秒,先用 curl 看响应头,别急着开浏览器:

Terminal window
# 看状态码和 Location 是否符合预期
curl -sI https://www.example.com/blog/hello-world | grep -iE "HTTP/|location"
# 跟完整条跳转链,确认最终落地且跳数正常
curl -sIL https://example.com/old-page -o /dev/null -w "final: %{http_code}, hops: %{num_redirects}\n"

第一条应看到 301 和指向新地址的 location;第二条的 hops 正常应为 1–2,数字异常大或命令迟迟不结束,就是成环了。curl 通过后,再用浏览器无痕窗口点开老链接实测一次(无痕是为了避开浏览器对 301 的本地缓存——301 会被浏览器长期记住,改错了之后哪怕规则已修正,你自己的浏览器还可能拿着旧缓存跳错地方)。最后抽查几个带查询字符串、带多级目录的链接,确认参数和后缀都没丢。

上线前还有一道保险:控制台 Rules 区域提供的 Rules simulator(规则模拟器) 可以拿任意 URL 试跑,提前看它会命中哪条规则、跳到哪里。宽泛规则(整站、整目录)部署前先在模拟器里喂几个样本 URL——首页、深层文章页、带参数的链接各一个——比上线后等访客踩坑划算得多。

八、排障:规则不生效时按这个顺序查#

  • DNS 不是橙云:重定向在边缘执行,目标主机名的 DNS 记录如果是灰云(仅解析),流量直达源站,规则完全不会触发。先去 DNS 列表确认相关记录是橙云,尤其是配方 1、5 里的 www 和老域名占位记录。
  • 规则没启用或改错了域名:确认规则状态为 Active,且配在请求实际进入的那个域名下(规则是域名级隔离的,配在 A 域名下的规则管不到 B 域名)。
  • 被前面的规则截胡:同类规则命中第一条即停。把不生效的规则往上拖,或检查前面是不是有更宽泛的规则先命中了;单条规则与批量列表撞车时,也是单条规则优先。
  • 重定向循环:浏览器报 ERR_TOO_MANY_REDIRECTS、curl -sIL 里 Location 反复横跳。逐条列出所有跳转的起点和终点画成链:A→B、B→A 是最典型的环;还有一种隐蔽环是目标地址本身又落进源模式的通配符范围(比如 /posts/* 跳 /posts/* 的自引用)。另外别只查 Cloudflare:源站 Nginx、程序框架自己配的跳转和边缘规则叠加,同样能拼出一条环。
  • 捕获编号错位:目标 URL 里出现空段、字面量或少了一截路径,多半是 ${n} 数错了 *,回配方 4 对照协议部分的 * 重新数。
  • 跳是跳了,落地 404:规则没问题,是目标地址本身不存在。用浏览器直接打开 Target URL 验证一遍,别在规则里找不存在的错。
  • 刚改完没变化:等一分钟再测;浏览器测不准就以 curl 结果为准,301 的本地缓存是这里最常见的假象。

小结#

重定向规则的全部要点,收拢起来就四句:地址永久变了用 301 / 308、临时借用用 302 / 307;一类链接一条通配符规则,${1} 把后缀原样带走;成百上千条无规律映射交给批量重定向列表导入;上线后先 curl 看状态码和 Location、再无痕实测,重点防成环。老链接是站点多年攒下的资产,改版和换域名时把这一篇的配方过一遍,就能让它们一个都不丢。

重定向规则实战:老链接一个都不能丢
https://www.anexns.cloudns.org/posts/cloudflare-redirect-rules/
作者
Anexns
发布于
2026-11-15
许可协议
CC BY-NC-SA 4.0