Cloudflare CDN 缓存规则怎么设置?从静态资源到动态页面的安全配置
简答:Cloudflare CDN 缓存规则应先按内容类型分流:图片、CSS、JavaScript等静态资源通常可直接缓存;HTML、JSON、登录页、购物车和个人中心不要直接对全站启用缓存。最稳妥的做法是先确认 DNS 记录处于代理状态,再进入 Cache Rules 创建“静态资源缓存”规则,必要时为确定无用户数据的公开 HTML 单独设置 Eligible for cache,最后用 CF-Cache-Status 和 Rules simulator 验证。
定义:Cloudflare Cache Rules 是用于控制请求是否具备缓存资格、缓存位置、缓存时间及匹配范围的规则功能。
先看速查表:不同内容应该怎么设
如果你只是想先解决“静态文件没有缓存”或“改完页面仍显示旧内容”,可按下面的安全分流开始。Cloudflare 官方说明,图片、CSS、JavaScript等静态内容默认可缓存,而 HTML 等动态内容默认不缓存;Cache Rules 需要对应 DNS 记录经过 Cloudflare 代理。
| 内容类型 | 建议动作 | 匹配思路 | 主要风险 |
|---|---|---|---|
| 图片、CSS、JavaScript、字体 | Eligible for cache | 按文件扩展名或静态目录匹配 | 文件更新后可能仍命中旧对象,需要版本号或清理缓存 |
| 公开且不含用户数据的 HTML | 谨慎使用 Eligible for cache | 限定主机名、路径或公开页面 | 把个性化内容、Cookie或登录结果缓存给其他访客 |
| 登录页、后台、个人中心 | Bypass cache | 按路径、Cookie或后台主机名排除 | 若排除规则排在前面,可能被后面的缓存规则覆盖 |
| 购物车、订单、支付和用户 API | Bypass cache | 按路径和请求特征排除 | 错误缓存会造成数据展示与权限问题 |
| 带 Set-Cookie 或 no-store 的响应 | 通常不要强制缓存 | 先检查源站响应头 | 强行覆盖源站策略前应确认业务逻辑 |
该表是配置决策,不是对所有站点的固定模板。最终结果还会受到源站 Cache-Control、Set-Cookie、请求方法和当前账户可用设置影响。参考 Cloudflare Cache 入门文档 与 默认缓存行为说明。
设置前先确认三个条件
- 域名已经接入并且记录经过代理:Cache Rules 要求域名或子域名的 DNS 记录通过 Cloudflare 代理。若记录是 DNS-only,规则可能无法按预期作用于请求。
- 明确页面是否包含用户数据:只要响应会随登录身份、Cookie、地区、购物车或权限变化,就不要先把它当成公共静态页面缓存。
- 准备一个可验证的 URL:最好分别准备一个静态文件、一个公开页面和一个登录或 API 路径,配置后逐一检查响应头。不要只依赖浏览器页面是否“看起来变快”。
Cloudflare 的默认行为包括:当响应含有 private、no-store、no-cache 或 max-age=0 时通常不缓存;响应含有 Set-Cookie 时也不缓存;非 GET 请求不会按普通 GET 资源缓存。若源站没有 Cache-Control,Cloudflare 仍可能根据状态码等条件判断缓存资格,因此必须结合实际响应头验证。
如果你正在处理源站连接、跨区域访问或办公网络延迟,建议先用 Cloudflare CDN 接入与缓存验证指南 确认 DNS、源站和代理链路,再修改规则。
Cloudflare CDN 缓存规则的控制台设置步骤
- 进入入口:登录 Cloudflare Dashboard,打开目标站点,进入 Cache Rules 页面,选择 Create rule。官方当前控制台流程是进入 Cache Rules、创建规则、填写名称、设置匹配条件和缓存动作,然后部署或保存草稿。
- 填写规则名称:建议使用能说明范围的名字,例如
cache-static-assets、bypass-admin或cache-public-html,避免以后无法判断多条规则的作用。 - 选择匹配范围:全部请求使用 All incoming requests;只处理特定路径、主机名或请求属性时,选择 Custom filter expression。控制台可以通过 Field、Operator 和 Value 组成表达式;如果匹配主机名,先确认该主机名对应的 DNS 记录可被代理。
- 选择缓存资格:需要排除的内容选择 Bypass cache;确认可以进入 CDN 缓存的公开内容选择 Eligible for cache。注意 Eligible for cache 只是允许 Cloudflare 尝试缓存,并不代表每次响应一定会命中缓存,源站响应头仍可能影响结果。
- 设置缓存选项:只有在确认内容可公开复用时,再配置 Edge Cache TTL 或 Browser TTL。Edge Cache TTL 影响边缘缓存对象的保留策略;Browser TTL 影响访客浏览器侧的缓存行为。若不了解源站更新周期,先保留源站控制方式,避免把浏览器缓存设得过长。
- 安排规则顺序:把更需要保护的 Bypass 规则放在会覆盖缓存行为的位置,并在部署前检查是否存在多条规则同时命中。Cache Rules 可以叠加;同一设置发生冲突时,最后匹配的规则生效。
- 部署或回滚:先选择 Save as Draft 检查表达式;确认范围无误后再 Deploy。若出现页面内容错乱、登录状态异常或静态文件更新不生效,先停用或调整最近新增的规则,再清理受影响 URL 的缓存,不要一开始就清空整个站点缓存。
控制台字段和入口可能随账户界面调整而变化,具体以当前 Dashboard 显示为准。完整操作顺序可核对 Cloudflare 官方创建 Cache Rule 页面。
三个可照着改的规则思路
方案一:静态资源缓存
适合图片、样式表、脚本和字体。匹配条件可以从静态目录开始,例如 /assets/、/static/ 或由文件扩展名筛选。动作选择 Eligible for cache,再根据发布方式决定是否设置 Edge Cache TTL。若文件名没有内容哈希或版本号,更新文件后应准备按 URL 或路径清理缓存。
方案二:公开 HTML 页面缓存
只适合内容对所有访客相同、没有登录态或个性化数据的页面。建议限定主机名和公开路径,不要直接对整个域名启用 Cache Everything。配置后先用无痕窗口和未登录状态访问,再检查返回内容是否会因 Cookie、地区或账号而变化。
方案三:后台与动态接口绕过缓存
对后台、登录、个人中心、购物车、订单、支付和用户数据 API 建立 Bypass cache 规则。可以按主机名、路径、请求方法或业务 Cookie 进行匹配,但字段名称和可用运算符应以当前控制台的 Expression Builder 为准,不要照抄不适用于你账户的表达式。对 API 还应确认源站是否使用 Cache-Control: private、no-store 或 Set-Cookie。
回滚方法:如果公开页面被错误缓存,先将对应路径改为 Bypass cache 或停用缓存规则,再针对受影响 URL 执行清理。若使用了自定义 Cache Key,单文件清理可能还需要带上参与缓存键的请求属性;Cloudflare 文档说明,包含请求头、Cookie等属性的自定义缓存键可能无法直接使用 Dashboard 的单文件清理。
Edge Cache TTL、Browser TTL与源站头怎么选
| 设置 | 作用层级 | 适合先解决的问题 | 配置建议 |
|---|---|---|---|
| 源站 Cache-Control | 源站响应 | 统一表达内容是否可缓存及新鲜度 | 优先让源站对公开与私有内容表达清楚 |
| Edge Cache TTL | Cloudflare 边缘 | 需要明确控制 CDN 对象保留时间 | 仅对确定可复用的资源使用 |
| Browser TTL | 访客浏览器 | 减少重复下载静态文件 | 发布频繁的文件应配合版本号或哈希文件名 |
| Bypass cache | 规则动作 | 保护登录态和动态数据 | 优先覆盖后台、用户数据和交易路径 |
Cloudflare 官方文档指出,默认情况下会参考源站缓存头;但 Edge Cache TTL 规则可以覆盖源站头。因此,强制设置 TTL 前要确认源站内容更新方式、发布回滚方式和是否存在用户特定响应。不要把“浏览器能缓存”与“边缘 CDN 能缓存”混为一谈。
怎么验证规则真的生效
- 先用 Rules simulator:在 Cache Rules 的排错入口输入目标 URL,确认命中了哪条规则。若没有命中,检查主机名、路径、运算符、大小写和 DNS 代理状态。
- 再用 curl 看响应头:在终端执行
curl -sS -D - -o /dev/null https://example.com/assets/app.css,把域名和路径替换成自己的测试地址。 - 重点看这些字段:
CF-Cache-Status、Cache-Control、Pragma、Expires、Last-Modified和s-maxage。不要只看到一个 MISS 就认定规则失败,因为首次请求、源站头、对象类型和请求条件都可能影响结果。 - 对动态页面做安全验证:分别用未登录窗口、已登录窗口和不同测试账号访问,确认不会显示另一用户的数据。若页面内容与身份有关,应立即恢复 Bypass cache。
- 检查更新后的回源结果:修改静态文件或公开页面后,使用带新版本路径的测试 URL验证;若必须清理缓存,优先按文件、主机名或路径处理,避免无差别清除全部缓存。
Cloudflare 的排错资料建议使用 curl 检查缓存相关响应头,并将 CF-Cache-Status 等字段与源站头一起分析;可参考 官方站点排错资料。
规则冲突、缓存未更新与误缓存的排查顺序
- 规则没有命中:先检查 DNS 记录是否为代理状态,再用 Rules simulator 检查表达式。Cache Rules 只有在请求经过 Cloudflare 时才有机会生效。
- 规则命中但仍未缓存:检查响应是否含有
Set-Cookie、private、no-store、no-cache或max-age=0,并确认请求是 GET。Eligible for cache 不会自动消除所有源站限制。 - 新内容没有显示:先确认客户端浏览器缓存,再检查 Cloudflare 的缓存状态和源站版本;必要时只清理受影响 URL或路径。若使用自定义 Cache Key,要考虑查询字符串、Cookie或请求头是否参与了缓存键。
- 登录后看到异常内容:立即将登录、后台、用户中心和相关 API 改为 Bypass cache,清理可能受影响的缓存对象,并检查是否有一条更晚匹配的 Eligible for cache 规则覆盖了排除规则。
- 多条规则互相覆盖:Cache Rules 是可叠加的,同一设置冲突时最后匹配的规则生效;Cache Rules 也会优先于同路径上的 Page Rules。调整顺序后重新用 simulator 和 curl 验证。
规则顺序的官方说明见 Cache Rules Order and priority。如果仍无法定位,可同时记录目标 URL、时间、响应头和 CF-RAY,不要上传包含 Token、Cookie、密码或隐私数据的 HAR 文件。
常见问题 FAQ
Cloudflare CDN 默认会缓存 HTML 吗?
通常不会。Cloudflare 官方入门资料将 HTML 页面归为默认不缓存的动态内容,但可以通过 Cache Rules 让确定公开、可复用的 HTML 具备缓存资格。是否最终缓存仍要结合源站响应头和请求条件判断。
Cache Rules 里的 Eligible for cache 是不是强制缓存?
不是。它表示匹配请求具备缓存资格,Cloudflare 仍会参考源站 Cache-Control、Set-Cookie、请求方法和其他缓存条件。配置后应通过 Rules simulator 和响应头验证,而不是只看控制台开关。
登录页能不能设置 Cache Everything?
不建议。登录页、后台、个人中心、购物车、订单、支付和带用户数据的 API 应优先使用 Bypass cache,除非你能证明响应完全不包含用户特定数据,并且已经完成多用户验证。
为什么规则设置了却一直 MISS?
可能是首次请求、源站禁止缓存、响应含 Set-Cookie、请求不是 GET、DNS 未代理,或者规则表达式没有命中。按“DNS代理状态—Rules simulator—响应头—源站日志”的顺序排查。
修改网站后需要多久才能看到新内容?
不要用固定时间判断。缓存是否更新取决于缓存对象、TTL、源站头、请求条件和是否执行清理。应通过响应头、版本化 URL或针对性清理来确认实际状态。
规则顺序应该怎么排?
先列出必须绕过缓存的后台、登录和用户数据路径,再安排公开静态资源和公开页面规则,并检查是否存在后匹配规则覆盖前面的设置。官方规则说明是:多条 Cache Rules 可以叠加,同一设置冲突时最后匹配的规则生效。
常见问题
Cloudflare CDN 默认会缓存 HTML 吗?
通常不会。HTML 默认不缓存,但公开且不含用户数据的页面可以通过 Cache Rules 允许缓存;最终结果仍需结合源站响应头和实际响应状态验证。
Eligible for cache 是不是强制缓存?
不是。它只是让匹配请求具备缓存资格,源站 Cache-Control、Set-Cookie、请求方法和其他条件仍可能使响应不缓存。
登录页和后台能不能缓存?
一般应使用 Bypass cache。登录、后台、个人中心、购物车、订单、支付及用户数据 API 不应直接套用全站缓存规则。
为什么规则命中后仍然是 MISS?
先检查 DNS 是否经过代理,再用 Rules simulator确认表达式是否命中,随后检查 CF-Cache-Status、Cache-Control、Set-Cookie 和请求方法。MISS 不一定表示规则失效。
修改页面后是否要清空全部缓存?
不建议默认清空全部缓存。优先按文件、主机名或路径清理,并结合版本化 URL和响应头验证;使用自定义 Cache Key 时还要检查其包含的请求属性。
相关阅读
- Cloudflare CDN 接入与缓存验证指南
- Cloudflare DNS 设置与代理状态排查
- Cloudflare DNS 解析不生效排查
- Cloudflare 403 拦截与 WAF 排查
- Cloudflare 连接失败分层排查