Cloudflare 缓存怎么清除?按 URL、域名或全部清理的步骤
简答:Cloudflare 缓存怎么清除?先在源站确认新内容已上线,再进入 Cloudflare 控制台的 Configuration → Purge Cache;只改一个页面、CSS、JS 或图片时优先按 URL 清除,整站缓存异常才考虑 Purge Everything。清除后用 curl -I 查看 CF-Cache-Status,MISS 或 EXPIRED 通常表示请求已重新回源;如果仍是旧内容,还要继续检查浏览器、源站、CMS 插件、其他 CDN、Cache Key 或 Workers Cache。
定义:Cloudflare 缓存清除,也叫 Purge,是从 Cloudflare 边缘缓存中删除指定 URL、主机名、路径前缀、标签或整个区域的已缓存内容,使后续请求重新获取或重新验证源站内容。
先试这一步:按修改范围选择最小清除方式
如果你刚修改了网页、CSS、JS 或图片,不建议一开始就清空整个站点。先确认源站文件已经更新,再按影响范围选择清除方式。Cloudflare 官方建议优先使用按单个 URL 清除,而不是无必要地执行全量清除。Cloudflare 官方 Purge Everything 说明
| 修改场景 | 优先选择 | 操作对象 | 注意事项 |
|---|---|---|---|
| 只修改一篇文章、一个 HTML 页面 | URL | 输入完整 URL | 路径部分区分大小写,需填写实际地址 |
| 只修改一个 CSS、JS 或图片 | URL | 输入资源完整 URL | 若 URL 带版本参数或自定义 Cache Key,要按实际缓存键核对 |
| 一个子域名下的多个资源都已更新 | Hostname | 输入主机名,例如 static.example.com | 会影响该主机名下匹配的缓存资源 |
| 某个目录或路径前缀下的内容更新 | Prefix | 输入主机名加路径前缀 | 不要把协议、查询字符串或片段写入前缀 |
| 通过 Cache-Tag 管理的一组资源更新 | Tag | 输入缓存标签 | 必须确认源站或应用确实设置了对应标签 |
| 整站缓存内容都必须重新获取 | Purge Everything | 清空当前区域缓存 | 可能让大量请求同时回源,先确认源站承载能力 |
最短回退路径:如果误用了全量清除,通常不能恢复被删除的边缘缓存,只能让请求重新回源并重新建立缓存;因此操作前先确认源站已发布正确版本,并保留可回滚的源站文件。
控制台清除指定 URL、Hostname 或路径缓存
- 入口:登录 Cloudflare 控制台并选择目标区域,进入 Configuration 页面。不同语言或界面版本可能显示为缓存配置相关菜单,找不到时搜索 Purge Cache 或 Custom Purge。
- 动作:在 Purge Cache 区域选择 Custom Purge,再按需要选择 URL、Hostname、Prefix 或 Tag。
- 填写对象:按 URL 清除时填写完整 URL,例如
https://www.example.com/assets/app.css;按 Hostname 时每行填写一个主机名,官方文档说明一次最多可处理 100 个主机名。按 Hostname 清除的官方步骤 - 执行:检查输入内容后选择 Purge,不要把多个不同选择器混在一个不支持的请求中。
- 验证:用无痕窗口访问目标 URL,或执行
curl -I https://www.example.com/assets/app.css,查看响应头中的CF-Cache-Status。
按单文件清除时,主机名部分不区分大小写,但 URL 路径部分区分大小写。例如,/helloHI 与 /hellohi 可能对应不同资源;输入 URL 前应从浏览器地址栏或页面源代码复制准确地址。按单个文件清除的官方说明
预期结果:清除后首次请求通常需要重新从源站取得资源。按 Hostname 清除后,Cloudflare 文档说明后续请求可能出现 MISS;如果启用了 Tiered Cache,也可能看到 EXPIRED。Cloudflare 关于 MISS 与 EXPIRED 的说明
Cloudflare 缓存全部清除怎么操作?
- 先更新源站:确认 HTML、CSS、JS、图片或接口返回内容已经是正确版本。否则清除后第一次回源仍会取得旧文件,旧内容又可能重新进入缓存。
- 进入入口:在目标区域的 Configuration 页面找到 Purge Cache。
- 选择范围:选择 Purge Everything,阅读警告后确认执行。
- 验证结果:访问首页和关键静态资源,使用
curl -I或浏览器开发者工具查看响应头与页面内容。
全量清除会删除该区域的缓存资源,后续请求需要重新从源站获取并重新缓存。Cloudflare 明确提醒,高流量站点或资源较多的站点可能因此出现源站请求量上升、页面变慢甚至源站压力增大的情况,所以通常应优先按 URL、Prefix、Tag 或 Hostname 精确清除。Cloudflare 全量清除及源站负载说明
如果你的目标只是让资源重新检查是否更新,可以了解 Invalidation。它会把缓存标记为过期,在下一次请求时向源站重新验证;如果源站返回 304 Not Modified,Cloudflare 可能继续使用原缓存。Purge 则是删除匹配内容,后续请求重新获取完整响应。Purge 与 Invalidation 的官方区别
清除后仍显示旧内容:按缓存层排查
Cloudflare 清除成功,不代表访问链路上的所有缓存都被清除。建议按下面顺序排查:
- 浏览器缓存:使用无痕窗口访问,或在开发者工具中勾选禁用缓存后重新加载。Cloudflare 的 Purge 不会删除访客设备上的浏览器缓存。
- 源站内容:直接检查源站文件、CMS 后台预览、服务器响应或部署产物,确认不是源站本身仍返回旧版本。
- CMS 或页面缓存插件:如果使用了 WordPress、框架级页面缓存或服务器缓存,还要在对应系统中清理页面缓存;这不属于 Cloudflare 边缘缓存。
- 其他 CDN 或反向代理:如果域名还经过另一层 CDN、网关或企业代理,需要在对应平台继续检查。
- 响应头:执行
curl -I https://example.com/page,重点看CF-Cache-Status、Age、ETag、Last-Modified和Cache-Control。Cloudflare 将HIT定义为从缓存提供,MISS表示当时没有命中缓存,EXPIRED表示缓存已过期并从源站取得内容,BYPASS表示响应最终未被缓存。Cloudflare CF-Cache-Status 官方说明 - 特殊缓存键:如果缓存键包含请求头、设备类型、国家或语言,仅清除普通 URL 可能不足,还要按实际缓存键提供对应请求头。
- Workers Cache:普通控制台清除或区域级 API 清除不会影响 Worker 自己管理的 Workers Cache,需要按照 Worker 的缓存逻辑处理。Cloudflare Workers Cache 清除限制
若页面内容已更新但静态文件仍旧,较稳妥的长期方案是给 CSS、JS 和图片使用内容版本号或文件名指纹,例如 app.20261110.css。这属于发布策略,不是 Cloudflare Purge 的替代品;对于已缓存的旧 URL,仍需根据实际缓存规则决定是否清除。
用 API 清除:最小示例与权限风险
需要自动化部署时,可以调用 Cloudflare Cache API。下面示例只清除一个完整 URL;将 ZONE_ID 和 CLOUDFLARE_API_TOKEN 放在环境变量中,不要把真实 Token 写入网页、公开仓库或日志。
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/purge_cache" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
-d '{"files":["https://www.example.com/assets/app.css"]}'API 也支持 files、hosts、prefixes、tags 或 purge_everything 等选择器。全量清除时,purge_everything 必须是请求中的唯一字段,不能和文件、标签、主机名或前缀同时提交;官方 API 示例还展示了达到速率限制时的错误响应。Cloudflare Purge Cache API 官方参考
失败分支:如果返回权限错误,先确认 Token 的区域范围与缓存清除权限;如果返回速率限制,降低调用频率并避免部署脚本重复提交;如果 API 返回成功但页面仍旧,回到浏览器、源站、其他 CDN、缓存键和 Workers Cache 分层检查。权限名称和可用范围可能随账户角色、产品配置或控制台版本变化,实际创建 Token 时应以当前官方页面为准。
常见问题
Cloudflare 清除缓存会删除源站文件吗?
不会。Purge 处理的是 Cloudflare 边缘缓存,不会删除源站上的 HTML、CSS、JS、图片或数据库内容。但清除后请求可能重新访问源站,所以应先确认源站文件已经发布正确版本。
只修改一个 CSS 文件,应该清除全部缓存吗?
通常不需要。优先按完整 CSS URL 清除;如果 CSS 使用了自定义 Cache Key、设备或语言维度,需按实际缓存键核对。长期发布可使用带版本号或文件指纹的资源 URL。
为什么清除后 CF-Cache-Status 还是 HIT?
可能访问的不是刚清除的 URL,或者请求经过了浏览器、其他 CDN、自定义 Cache Key、Workers Cache 等其他缓存层。先复制准确 URL,再检查响应头、源站返回内容和 Worker 缓存逻辑。
Purge 和 Invalidation 有什么区别?
Purge 会删除匹配的缓存内容,后续请求重新获取响应;Invalidation 会把内容标记为过期并在下一次请求时重新验证,源站返回 304 时仍可能复用缓存。必须阻止旧内容继续提供时优先考虑 Purge。
Cloudflare 缓存清除后网站变慢怎么办?
先确认是否执行了全量清除。Purge Everything 后大量请求会重新回源,可能暂时增加源站压力;检查源站负载和错误日志,后续尽量改用 URL、Prefix、Tag 或 Hostname 的精确清除。
相关阅读
- 查看 Cloudflare CDN 从接入到缓存验证的完整流程
- 继续学习 Cloudflare API Token 创建与调用排错
- 如果域名仍未指向正确站点,先检查 Cloudflare DNS 设置
- 清缓存后仍无法访问时,按错误代码排查连接问题