把域名接入 Cloudflare 之后,很多人以为加速已经完成了。其实默认状态下,Cloudflare 只缓存图片、样式表、脚本这类静态文件,你辛辛苦苦写的 HTML 页面默认根本不进缓存,每一次访问都要回源站取。想让 CDN 真正发挥作用,就得自己动手配规则:哪些内容缓存、缓存多久、哪些内容坚决不能缓存、缓存的副本按什么维度区分。
本篇的主线是这样的:先把 Cloudflare 的默认缓存行为和源站响应头的关系说清,再教你怎么验证一次请求到底命没命中缓存;然后逐个拆 Cache Rules 的匹配表达式和缓存动作;接着给三个可以直接抄的实战规则;最后讲缓存键、清除缓存、分层缓存和排障。配完这一篇,你的站该快的快、该实时的实时,不再靠运气。
默认缓存行为:先搞清谁说了算
Cloudflare 的缓存不是「什么都存一份」,它有一套默认判断逻辑。理解这套逻辑,是配规则的前提。
默认只认文件扩展名
在没有任何自定义规则时,Cloudflare 按 URL 的文件扩展名决定要不要缓存。默认会缓存的包括:
- 图片类:
jpg、jpeg、png、gif、webp、svg、ico - 样式与脚本:
css、js - 字体类:
woff、woff2、ttf、eot - 文档与媒体:
pdf、mp4、mp3等
而下面这些默认不缓存:
- HTML 页面(无扩展名路径、
/结尾的路径、.html之外的动态路由) - 带查询字符串的 API 接口(多数情况)
- 源站明确要求不缓存的响应
也就是说,一个典型的动态站点接上 Cloudflare 之后,静态资源确实被加速了,但页面本体每次都要回源。这就是很多人觉得「上了 CDN 好像没快多少」的原因:默认缓存只覆盖静态文件,HTML 和动态内容要不要缓存,必须由你自己用规则明确指定。
源站 Cache-Control 与 Cloudflare 的优先级
缓存这件事有两方在说话:源站通过 Cache-Control、Expires 响应头表达意愿,Cloudflare 作为中间层做最终决定。两者的关系如下:
| 情形 | 源站响应头 | Cloudflare 默认行为 |
|---|---|---|
| 静态文件,源站无特殊头 | 无 Cache-Control | 按默认 TTL 缓存(按扩展名有默认时长) |
| 源站要求不缓存 | Cache-Control: no-store 或 private | 尊重源站,不缓存 |
| 源站给了 max-age | Cache-Control: max-age=3600 | 在边缘 TTL 设为「使用源站」时按 3600 秒缓存 |
| 源站给了 no-cache | Cache-Control: no-cache | 每次回源验证,不直接给缓存副本 |
| 配了 Cache Rules 强制缓存 | 任意 | 规则可以覆盖源站意愿(取决于边缘 TTL 模式) |
有几个细节要记牢:
- 源站返回
Set-Cookie的响应,默认情况下 Cloudflare 不会缓存它,这是防串号的保命设计,后文还会再提。 - 源站返回 200 以外的状态码(比如 404),Cloudflare 也可能短暂缓存,具体时长有默认表,别指望它替你兜住所有情况。
- 如果你用规则强制缓存,源站的
no-store有可能被覆盖。源站明确标注 no-store 的内容通常是敏感数据,强制缓存前必须先确认内容性质,不要为了命中率把保命设置绕过去。
验证缓存命中:看 cf-cache-status
配规则之前,先学会验证。不然规则配了一堆,到底生没生效全靠猜。
每次经过 Cloudflare 的响应都会带一个响应头 cf-cache-status,它直接告诉你这次请求在边缘节点经历了什么:
| 取值 | 含义 | 你应该怎么理解 |
|---|---|---|
HIT | 命中缓存 | 边缘节点直接返回副本,没回源,最理想 |
MISS | 未命中,已回源 | 第一次请求常见,回源取了并存入缓存(如果可缓存) |
DYNAMIC | 不缓存,动态内容 | 该 URL 按规则或默认逻辑不进缓存,每次回源 |
EXPIRED | 缓存已过期 | 副本超过 TTL,已回源刷新或正在刷新 |
STALE | 返回了过期副本 | 源站暂时不可达时,边缘先给旧副本顶着 |
BYPASS | 按规则绕过缓存 | 规则里明确设了 Bypass,每次回源 |
REVALIDATED | 回源验证后副本仍有效 | 带着验证条件回源,源站说没变,继续用副本 |
实测方法很简单,用 curl 看响应头即可:
# 看某个静态资源的缓存状态curl -sI https://example.com/assets/app.css | grep -i "cf-cache-status"
# 看首页 HTML 的缓存状态curl -sI https://example.com/ | grep -iE "cf-cache-status|cache-control|age"验证时注意三点:
- 同一个 URL 第一次请求多半是
MISS,紧接着再请求一次才应该变HIT。只测一次就下结论,是新手最常见的误判。 - 响应头里的
age表示这份副本已经在边缘存了多少秒,可以用来反推 TTL 还剩多久。 - Cloudflare 在全球有大量边缘节点,你命中是哪个节点、那份副本存不存在,各节点独立。在自己电脑上测出 HIT,不等于全世界用户都是 HIT,尤其低流量页面,偏远节点可能长期是冷的。
还有一个进阶验证技巧:响应头里的 cf-ray 末尾带有机场代码(如 NRT、FRA、SIN),它标明处理这次请求的是哪个城市的节点。同一条命令在不同网络环境下多跑几次,对比 cf-ray 的节点代码和 cf-cache-status,就能大致摸清各个地区节点的预热情况。如果某个主力访客所在地区的节点长期是 MISS,通常不是规则的问题,而是那个地区流量太少、副本存不住,这正是后面要讲的分层缓存要解决的问题。
Cache Rules 的结构:匹配 + 动作
Cache Rules 位于控制台的「缓存」→「Cache Rules」(部分版本在「规则」栏目下)。一条规则由两部分组成:
- 匹配条件:哪些请求适用这条规则。
- 缓存动作:对这些请求怎么处理缓存。
匹配表达式:用字段圈定范围
匹配条件既可以用可视化编辑器点选,也可以用表达式编辑器手写。常用字段有:
| 字段 | 匹配对象 | 典型用法 |
|---|---|---|
| 主机名(Hostname) | 请求的域名 | 只对某个子域名生效 |
| URI 路径(URI Path) | 路径部分,如 /assets/ | 按目录划分缓存策略 |
| URI 完整(URI Full) | 含查询字符串的完整地址 | 精细匹配带参数的地址 |
| 文件扩展名(File Extension) | 如 css、png | 对某类文件统一策略 |
| 查询字符串(Query String) | 参数部分 | 区分带版本参数的资源 |
| Cookie / 请求头 | 请求携带的 Cookie 或 Header | 按登录状态区分(慎用) |
| 国家/地区 | 访客来源地 | 分区域策略 |
手写表达式的语法和防火墙规则表达式一致,比如:
(http.request.uri.path contains "/assets/")(http.request.uri.path contains "/wp-admin/") or (http.request.uri.path contains "/wp-login.php")(ends_with(http.request.uri.path, ".html")) or (http.request.uri.path eq "/")规则是自上而下匹配的:请求命中第一条符合条件的规则后,就按那条规则执行,不再往下走。所以顺序很重要,越具体的规则越要放前面,兜底规则放最后。
再补两条管理上的经验。第一,给规则起名字要带上意图,比如「静态资源-长缓存-30天」「后台-绕过-防串号」,半年后回来改规则的人还是你自己,名字说不清意图的规则没人敢动,最后越堆越乱。第二,规则总数是有限的(具体条数以控制台和当前套餐为准),不要一条路径建一条规则;同类路径用 or 合进一条表达式里,把额度留给真正需要单独策略的内容。每次改完规则,别忘了回到上一节的验证方法实测一遍,控制台里显示「已启用」不等于请求真的按你想的走。
缓存动作:四个核心设置
命中规则后,可以配置这些动作:
1. 符合缓存条件(Eligible for cache)
这是总开关:
- 设为「符合缓存条件」:这类请求进入缓存体系,后续 TTL 等设置才有意义。
- 设为「绕过缓存(Bypass cache)」:每次都回源,边缘不存副本。
2. 边缘 TTL(Edge TTL)
决定副本在边缘节点存多久,三种模式:
| 模式 | 行为 | 适合场景 |
|---|---|---|
| 忽略源站 Cache-Control | 完全按你填的秒数缓存,无视源站头 | 静态站、版本化静态资源 |
| 使用源站 Cache-Control(Use cache-control header if present) | 源站说了算,没给头时用你填的默认值 | 源站已经有成熟缓存策略的应用 |
| 尊重源站但设上下限的思路 | 通过源站头加规则默认值组合 | 混合型站点 |
注意「忽略源站」是个强力选项:它连源站的 no-store 都可能盖掉。给静态资源用没问题,给任何带用户状态的路径用「忽略源站 + 长 TTL」,就是在给串号事故铺路。
3. 浏览器 TTL(Browser TTL)
控制访客浏览器本地缓存多久,和边缘 TTL 是两回事:边缘存 30 天、浏览器只存 1 小时,意味着用户每小时会向边缘发一次请求(大概率 HIT)。一般保持「尊重源站」或按资源类型单独设。
4. 其他常用项
- 在源站不可用时提供过期内容(Serve stale content):源站挂了时先给旧副本顶着,提高可用性,静态站建议开。
- 忽略查询字符串 / 缓存键相关设置:在缓存键里细讲。
实战规则一:静态目录长缓存
场景:/assets/、/static/ 目录下是带构建指纹的 CSS、JS、图片(文件名形如 app.a1b2c3.js,内容变了文件名就变)。这类资源可以放心长缓存。
配置:
规则名称:静态资源长缓存匹配表达式:(http.request.uri.path contains "/assets/") or (http.request.uri.path contains "/static/")符合缓存条件:是边缘 TTL:忽略源站 Cache-Control,设为 30 天(2592000 秒)浏览器 TTL:覆盖为 7 天(604800 秒)——可选提供过期内容:开为什么敢设 30 天:因为文件名带指纹,新版本是新 URL,老副本留在边缘再久也不会被请求到。如果你站里的静态文件是固定文件名覆盖更新(比如永远叫 style.css),那就别设这么长,或者改用带版本号的引用方式(后文排障里细说)。
实战规则二:后台与登录路径绕过缓存
场景:任何站点的后台、登录页、用户中心,都不应该被缓存。拿 WordPress 举例,其他 CMS 同理:
规则名称:后台绕过缓存匹配表达式:(http.request.uri.path contains "/wp-admin/") or (http.request.uri.path contains "/wp-login.php") or (http.request.uri.path contains "/account/")符合缓存条件:否(Bypass cache)这条规则要放在所有「强制缓存」类规则的前面,否则可能被前面的宽泛规则先命中。
必须讲清 Bypass 的代价:绕过缓存意味着每一个请求都打到源站。后台本身流量小,无所谓;但如果误把高流量路径设成 Bypass,源站会被自己的流量打满。所以 Bypass 只给低流量、高实时性的路径用。判断标准很简单:Bypass 给「人少但必须实时」的地方,长缓存给「人多且内容不变」的地方,中间地带用短 TTL 加源站头控制。
另外提醒:登录状态的判断别只靠路径。很多应用登录后访问的还是普通路径,只是多了 Cookie。这类站点要么靠源站响应头(private、no-store)让 Cloudflare 自动不缓存,要么在缓存键和规则里考虑 Cookie 字段,绝不能只凭路径就放心。
实战规则三:静态站整站 HTML 缓存
场景:纯静态站点(博客、文档站、落地页),HTML 本身也是静态文件,可以整站缓存,效果立竿见影——源站哪怕是一台小机器,也能扛住流量高峰,因为绝大多数请求根本到不了源站。
配置思路:
规则名称:整站缓存匹配表达式:(http.host eq "example.com") // 对整站生效,排在前两条规则之后符合缓存条件:是边缘 TTL:忽略源站,设为 2 小时(7200 秒)起步,稳定后可拉长提供过期内容:开配套纪律,比规则本身更重要:
- 发布更新后必须清缓存。部署脚本最后一步调 Cloudflare 的清除接口,或者人工在控制台清一次。忘了清,用户看到的就是旧页面,还会以为部署失败。稍微讲究一点的做法是把清缓存做成自动化:为站点单独建一个只有「清除缓存」权限的 API 令牌,部署流水线在上传文件成功后自动调用清除接口,只清本次变更过的 URL 列表。这样既不用每次人工进控制台,也避免了图省事直接全部清除。令牌权限只给到单个区域的缓存清除,泄露了也伤不到 DNS 和其他设置。
- TTL 别一上来就设一个月。先设 1 到 2 小时,确认更新流程顺畅、清缓存动作稳定执行,再逐步拉长。
- 评论、搜索这类动态功能如果靠第三方服务嵌入(不经过源站),不影响整站缓存;如果站内有自己的动态接口,把那些路径单独拎出来 Bypass 或短 TTL。
WARNING整站缓存只适用于内容对所有访客完全一致的站点。只要页面里有「欢迎回来,某某某」这类按用户变化的内容,整站缓存立刻从优化变成事故预告,下一节细说。
缓存键:副本按什么维度区分
缓存键(Cache Key)决定边缘节点把哪些请求视为「同一个资源」。默认缓存键主要看 URL(含查询字符串)。也就是说:
/app.css?v=1和/app.css?v=2是两份副本(合理,版本不同)。/page?utm_source=a和/page?utm_source=b也是两份副本(不合理,内容明明一样)。
第二种情况就是命中率杀手。营销参数、追踪参数让同一个页面裂变成几十份副本,每份都要单独预热,命中率自然惨不忍睹。
在规则或缓存设置里可以调整缓存键:
| 调整项 | 作用 | 建议 |
|---|---|---|
| 忽略查询字符串 | 所有带参请求共用一份副本 | 仅对确认参数不影响内容的资源用 |
| 只保留指定参数 | 只让 v、lang 等参数参与区分 | 静态资源和多语言页面的常用做法 |
| 按 Cookie 区分 | 不同 Cookie 值存不同副本 | 只对确实按 Cookie 变内容的页面开 |
| 按请求头区分 | 如按 Accept-Language 分语言副本 | 多语言站点用,别滥用 |
原则:参与区分的维度越少,命中率越高;但少到把本该区分的维度也合并了,就会给用户发错内容。lang 参数决定页面语言的站,把查询字符串整个忽略,法国用户就会看到中文页。所以调整缓存键之前,先列一张表:这个资源的响应内容到底受哪些因素影响,只保留那些因素。
清除缓存:三种粒度和各自的代价
更新内容后旧副本还在边缘,就需要清除缓存(Purge)。控制台「缓存」→「配置」里有入口,API 也能调。三种粒度:
| 方式 | 范围 | 代价 | 适用场景 |
|---|---|---|---|
| 按 URL 清除 | 指定单个或一批 URL | 最小,只影响这些资源 | 改了某篇文章、换了某张图 |
| 按前缀/主机名清除 | 某目录或某子域全部 | 中等,该范围内要重新预热 | 整站改版、目录结构调整 |
| 全部清除(Purge Everything) | 整个域名所有缓存 | 最大,全站回源压力骤增 | 极少使用,仅限配置大改后 |
全部清除是最被滥用的一个按钮。点下去的瞬间,全球边缘节点的副本全部作废,接下来的每一波流量都直达源站,小机器源站可能直接被打挂。全部清除不是「刷新一下」那么轻松,它等于把 CDN 临时关掉让源站裸奔,除非确有必要,能按 URL 清就按 URL 清。
还有一个临时手段:开发模式(Development Mode)。开启后 3 小时内所有请求绕过缓存直达源站,适合调试样式、排查「到底是缓存问题还是源站问题」。调试完记得它会自动关闭,不用手工关,但调试期间站点等于无缓存状态,别在高峰期开着忘了。
分层缓存 Tiered Cache:要不要开
普通模式下,每个边缘节点各自为战:东京节点缓存了你的首页,不代表法兰克福节点也有,法兰克福的第一个访客还是要回源。分层缓存(Tiered Cache)的做法是在边缘节点之上再设一层「上层缓存节点」:下层节点没命中时,先去上层节点要,上层也没有才回源。
好处很直接:回源次数大幅减少,偏远地区、长尾页面的命中率明显提升,源站压力更平滑。开启方式在控制台「缓存」→「分层缓存」里,有免费的智能分层选项可直接启用(具体可用范围以控制台为准)。
打个比方:没有分层时,一百个边缘节点各回源一次,你的源站要扛一百次首访;开了分层后,这一百个节点先汇到少数上层节点,上层节点大多已经有副本,真正落到源站的可能只有几次。对源站是小机器、又怕被流量打满的个人站点,这个开关的性价比极高,基本属于「开了不后悔」的那一类设置。
建议:只要你的访客分布跨多个地区,或者源站性能一般,就值得开,基本没有副作用。单地区小站收益不明显,但开了也不亏。
动态内容长缓存:事故级配置
这一节必须单独拿出来说,因为它是缓存领域最经典、后果最严重的一类事故。
设想:某电商站为了提升速度,给全站配了「忽略源站、边缘 TTL 7 天」的规则。管理员登录后访问订单页,这个页面包含他的姓名、订单、地址。Cloudflare 把这份响应存进边缘。接下来任何一个访客打开同一个 URL,边缘直接把管理员的那份页面发给他——姓名、订单、地址全在里面。这就是串号:A 用户看到了 B 用户的页面。
出事的根本原因有三个,缺一不可地凑齐了才会爆:
- 内容随用户变化(动态页面);
- 被强制缓存(规则覆盖了源站的保护头);
- 缓存键不区分用户(没按 Cookie 等维度拆分)。
Cloudflare 的默认行为其实已经防了一手:带 Set-Cookie 的响应默认不缓存。但只要你用规则把「忽略源站」打开、再把这类路径圈进去,这道防线就被你亲手拆了。
WARNING购物车、用户中心、订单页、个人资料页这类内容随用户变化的页面,绝对不要配长缓存,更不要用「忽略源站 Cache-Control」。真要优化这类页面,方向是优化源站响应速度、缓存页面里的静态片段资源,而不是缓存页面本体。一旦发生串号,漏出去的是别人的隐私数据,这是事故,不是性能问题。
自查方法:用未登录状态和登录状态分别 curl 同一个动态 URL,看 cf-cache-status。登录态的响应如果出现 HIT,立刻停下来检查规则。
排障
规则配了不生效
按这个顺序查:
- 顺序:规则自上而下命中第一条就停。你的新规则是不是排在了一条更宽泛的规则后面,请求根本轮不到它?
- 表达式没匹配上:路径大小写、末尾斜杠、子域名写错,都是常见原因。用表达式编辑器里的测试思路逐段核对字段值,必要时先把条件放宽到只匹配主机名,确认规则能命中,再逐步加细。
- 被源站头否决:规则设了「符合缓存条件」,但边缘 TTL 用的是「使用源站」,而源站回了
no-store,照样不缓存。看源站实际响应头再判断。 - 规则数量与可用范围:不同套餐可建的规则条数不同(以控制台为准),超限的规则建不上去或不生效,别在旧规则上反复改,先确认规则本身处于启用状态。
更新了文件,访客还是旧的
- 先确认边缘状态:对出问题 URL 执行
curl -sI,看cf-cache-status和age。是HIT且 age 很大,就是副本没清。 - 按 URL 清除这一份缓存,再测。还不行,检查浏览器 TTL——可能边缘已经是新的,访客浏览器还在用本地副本。
- 治本手法是版本号:静态资源引用带指纹或版本号(
app.css?v=20261115),新版本新 URL,天然绕开旧缓存。这比每次更新后手工清缓存可靠得多。
命中率低得离谱
- 查询字符串在作怪:统计一下访问日志,同一路径带不同参数的占比有多高。营销参数满天飞的站,先在缓存键里把无关参数剔除。
- Cookie 在作怪:某些应用给每个访客都种不同的 Cookie 并让响应带
Set-Cookie,这类响应默认不缓存。先确认是不是应用行为,能改应用就改应用,不能改就接受这类页面不缓存。 - 流量太分散:长尾页面每个节点访问量都很低,副本还没预热就过期了。开分层缓存、适当拉长 TTL,是这类问题的正解。
- TTL 太短:TTL 设 60 秒的资源,边缘刚存好就过期,命中率必然难看。对照内容更新频率重新评估 TTL,别矫枉过正。
小结
- Cloudflare 默认只缓存静态扩展名资源,HTML 默认不缓存;想加速页面本体,必须自己配 Cache Rules。
- 验证先行:
cf-cache-status是判断缓存行为的唯一可信依据,第一次 MISS、第二次 HIT 才是正常节奏。 - Cache Rules = 匹配表达式 + 缓存动作,规则自上而下命中即停,具体规则在前、兜底规则在后。
- 边缘 TTL 三种模式里,「忽略源站」最强也最危险,只给纯静态内容用;Bypass 只给人少且必须实时的路径用。
- 缓存键决定副本的拆分维度,无关查询参数是命中率头号杀手,按内容实际影响因素做减法。
- 清缓存优先按 URL,全部清除等于让源站裸奔,非必要不用;开发模式只适合短时调试。
- 分层缓存能显著减少回源,跨地区站点建议开启。
- 动态页面配长缓存会串号,泄露的是用户隐私,这是缓存配置里最不能犯的错。
把这一篇的规则配好,你的站才算真正把 CDN 用起来了:静态资源长缓存压住源站压力,动态路径干净绕行,更新有清除纪律,命中率有缓存键兜底。