跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

按单文件清除

最后更新 查看 MarkdownAgent 设置

使用按单文件清除,缓存资源会立即从所有数据中心的 CDN 存储资源中移除。被清除资源的新请求从源站 Web 服务器获取最新版本,并在提供请求的特定 Cloudflare 数据中心将其添加回 CDN 缓存。

有关单文件清除速率限制的信息,请参阅限制部分。

如何清除单个文件

  1. 在 Cloudflare 仪表板中,前往 Configuration(配置) 页面。

    前往 Configuration(配置) ↗
  2. 在 Purge Cache(清除缓存) 下,选择 Custom Purge(自定义清除)。Custom Purge(自定义清除) 窗口将出现。

  3. 在 Purge by(按以下方式清除) 下,选择 URL。

  4. 使用示例中显示的格式在文本字段中输入适当的值。请注意,URL 的主机部分不区分大小写,意味着根据 RFC 标准将始终转换为小写。但是,路径部分区分大小写。例如,https://EXAMPLE.com/helloHI 将被视为 https://example.com/helloHI。

  5. 执行任何其他说明以完成表单。

  6. 查看您的条目。

  7. 选择 Purge(清除)。

限制和替代方案

单文件清除适用于大多数资源,但在某些情况下无法清除缓存内容。本节说明单文件清除何时不起作用以及应使用什么替代方案。

自定义缓存键

如果使用 Cache Rules 设置包含请求头、Cookie 或其他请求属性的自定义缓存键,通过仪表板按单个文件清除缓存时,将无法移除该缓存资源。这是因为仪表板无法在清除请求中发送这些值。例外情况是设备类型和国家/地区:Enterprise zone 在按 URL 清除缓存时,可在 Advanced (Purging with custom cache keys) 下设置这些值。仅改变查询字符串处理方式的自定义缓存键(例如忽略查询字符串)通常可与仪表板的单文件清除功能配合使用。

替代方案:

  • 使用 API 按 URL 清除文件,包括自定义缓存键中的所有标头和 cookie。如果清除请求中缺少任何标头或 cookie,Cloudflare 在缓存键中将其视为空值。
  • 使用按前缀清除(按前缀清除)清除 URL 路径下的所有资源。
  • 使用按标签清除(按标签清除),如果您的资源已标记。
  • 使用清除所有内容(清除所有内容)清除 zone 的所有缓存资源。

匹配请求属性的 Cache Rules

如果您的 Cache Rules 仅匹配 GET 请求,或匹配清除期间不存在的属性,单文件清除也可能无法按预期工作。例如,表达式为 (http.host eq "example.com" and http.request.method eq "GET") 的 Cache Rule 在单文件清除期间不会匹配。

替代方案:

更新 Cache Rule 表达式以同时匹配 PURGE 方法,例如 (http.host eq "example.com" and (http.request.method eq "GET" or http.request.method eq "PURGE"))。这允许规则应用于客户端请求和清除请求。

对于匹配清除期间无法评估的字段(如 cf.bot_management.score)的规则,请使用按前缀清除、按标签清除或清除所有内容。

重定向响应

如果要清除的 URL 返回重定向(301 或 302),按单个文件清除会移除缓存的重定向响应,而不会移除重定向目标位置的内容。目标 URL 的资源仍保留在缓存中。

要清除目标位置的内容,请直接清除最终目标 URL。你可以沿重定向链找到其终点:

curl -Ls -o /dev/null -w "%{url_effective}
" https://example.com/redirecting-path

此命令会输出所有重定向完成后的最终 URL。请在清除缓存请求中使用该 URL。

具有特殊标头的资源

通过 Cloudflare 仪表板执行的单文件清除不会清除包含以下任何内容的资源:

  • Origin 标头 ↗
  • 以下任何请求标头:
    • X-Forwarded-Host
    • X-Host
    • X-Forwarded-Scheme
    • X-Original-URL
    • X-Rewrite-URL
    • Forwarded

您可以使用 API 调用按 URL 清除文件来清除具有这些特征的对象。在请求正文的 headers 对象中,包含与缓存资源 cache key 中使用的标头值匹配的标头值。

其他说明

结果缓存状态

按单文件清除会删除资源,导致后续请求的 CF-Cache-Status 标头设置为 MISS。

这篇文档对您有帮助吗?