按单文件清除

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

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

1. 在 Cloudflare 仪表板中，前往 Configuration（配置） 页面。

   Go to 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 或其他请求属性的自定义缓存键，通过仪表板的单文件清除将无法使缓存资源失效。这是因为仪表板无法在清除请求中发送这些值。仅更改查询字符串处理方式（例如，忽略查询字符串）的自定义缓存键通常可与仪表板单文件清除配合使用。

替代方案：

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

如果您的 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）的规则，请使用按前缀清除、按标签清除或清除所有内容。

通过 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。