You need to enable JavaScript to run this app.
导航
内容分发网络
  • 文档首页
    • /
  • 内容分发网络

缓存刷新

最近更新时间：2024.04.11 19:54:55

首次发布时间：2021.08.12 16:35:16

我的收藏

缓存刷新概述

在火山引擎内容分发网络中，每个被缓存的文件都有一个缓存过期时间。如果一个文件在缓存中未过期，但是源站上该文件已被更新，内容分发网络还是会将缓存的文件发送给用户。此时，如果您需要用户能获取源站上更新后的该文件，您可以使用内容分发网络提供的"缓存刷新"功能。

工作原理

您使用"缓存刷新"为特定文件或者目录提交刷新任务。

  • 对于文件刷新，内容分发网络会删除缓存中指定的文件。之后，当收到这些文件的请求时，内容分发网络会向源站请求文件。
  • 对于目录刷新，内容分发网络会将指定目录下已缓存的文件标记为已过期。当收到这些文件的请求时，内容分发网络会向源站发送文件校验请求。关于文件校验的流程，参见 缓存规则。

适用场景

"缓存刷新"适用于以下场景：

  • 站点上有关键文件被更新了。此时，您需要用户能获取最新的文件。如果您站点上文件的更新频率是可预知的，建议您为站点文件 配置缓存规则。

  • 源站上的特定文件由于某些原因需要被删除。然而，这些文件可能已被内容分发网络缓存了。您不希望用户访问这些文件。

注意事项

  • "缓存刷新"可以确保用户获取最新版本的文件。但是当您对一个文件提交刷新任务并且该任务成功执行后，该文件的第一次访问是无法获得加速的。如果您需要该文件的第一次访问能被加速，在刷新任务成功执行后，您可以使用 文件预热 功能。关于如何了解任务的执行状态，参见 操作记录。

  • 在您提交刷新任务后，生效时间大约是 5 分钟。

  • 在您对大量文件提交刷新任务后，这些文件的首次请求都会触发回源请求。因此您的源站可能会在短期内承受流量压力，特别是在文件体积较大的时候。

  • 您不能直接对泛域名下的文件和目录执行刷新操作。参见 如何对泛域名下的文件和目录执行刷新、预热、封禁和解封操作。

刷新配额

您账号每日刷新配额如下：

  • 如果您刷新的是 URL，您每天最多可以刷新 1,000 个 URL。每个刷新任务中最多可以包含 100 个 URL。如果您需要调整这些额度，参见 配额管理。

  • 如果您刷新的是目录，您每天最多可以刷新 50 个目录。内容分发网络会刷新所有指定目录下的文件，包括子目录下的文件。

说明

刷新配额是主账号和子账号共用的。

操作步骤

  1. 登录 火山引擎内容分发网络控制台。

  2. 在左侧导航栏，点击 刷新预热。

  3. 在 刷新预热 页面，点击 缓存刷新 标签页。

  4. 按照 配置说明 进行操作。

  5. 点击 提交。

alt

配置说明

配置说明

任务类型

表示任务的类型。该配置有以下取值：

  • URL 刷新：表示刷新的对象是一个或者多个文件。

  • 目录刷新：表示刷新的对象是一个或者多个目录。

您账号下每天可刷新的文件和目录的数量是有限额的。参见 刷新配额。

前缀刷新表示是否开启前缀刷新。该配置仅当 任务类型 是 目录刷新 时才会出现，默认是关闭。

URL

表示需要刷新的 URL。该配置有以下取值：

  • 手动输入：表示手动输入那些需要刷新的 URL。

  • 上传文件：表示上传一个 .txt 文本文件。需要刷新的 URL 包含在该文本文件中。

URL 必须满足以下条件：

  • 如果 任务类型 是 URL 刷新，您可以指定最多 1,000 个文件的 URL。文件 URL 必须满足以下条件：

    • 文件 URL 必须 以 https:// 或者 http:// 开头。

    • 多个文件 URL 以换行分隔。

    • 您一次最多可以提交 1,000 个 URL。

  • 如果 任务类型 是 目录刷新 时，有以下说明：

    • 如果 前缀刷新 未开启，您可以指定最多 100 个目录的 URL。目录 URL 必须满足以下条件：

      • 目录 URL 必须 以 https:// 或者 http:// 开头，并且以 / 结尾。

      • 多个目录 URL 以换行分隔。

    • 如果 前缀刷新 已开启，您可以指定最多 100 个用于匹配目录 URL 的前缀。例如 http://example.com/im 可用于匹配 http://example.com/image/ 和 http://example.com/imece。

白名单功能

您可以提交工单启用以下功能：

  • 强制删除

  • 正则刷新

强制删除

当 任务类型 是 目录刷新 时，该配置会出现，用以指定是否删除已缓存的文件。

  • 默认情况下，当您提交缓存刷新任务时，内容分发网络会将缓存中相应的文件标记为过期，而不是删除。当收到这些文件的请求时，内容分发网络会向源站发送文件校验请求，而不是直接向源站请求文件。参见 回源校验。
  • 开启 强制删除 后，刷新任务会删除缓存中相应的文件。当收到这些文件的请求时，内容分发网络会直接向源站请求文件。

正则刷新

在您指定文件 URL 时，您可以在 URL 中使用正则表达式来匹配需要刷新的文件。您可以输入一个或者多个 URL，多个 URL 使用换行分隔。每个 URL 不能超过 256 个字符。正则表达式在匹配时是区分大小写的。

您账号下每天可刷新 20 个包含正则表达式的 URL。您一次最多可以提交 10 个 URL。

在 URL 中，您可以指定的正则表达式有以下限制：

  • 正则表达式匹配的是文件路径和查询字符串，但不包含路径开头的 /。也就是说，URL 的格式只能是 http://host/regex 或者 https://host/regex。host 表示加速域名，regex 表示正则表达式。

  • 正则表达式中只能包含以下元字符：

    • [0-9]

    • [a-z]

    • [A-Z]

    • [a-zA-Z]

    • [^/]*

    • .*

    • +

    • [,?]

    • ?

注意事项

在您构建的包含正则表达式的文件 URL 中，除了路径开头的 /，整个路径都被认为是正则表达式。因此，只要正则表达式匹配了某个实际文件的 URL 中的部分路径，该文件就会被认为是匹配，从而被内容分发网络刷新。

例如 https://www.example.com/dir2/.*\.js 可以匹配以下文件的 URL：

  • http://www.example.com/dir2/img1.js

  • http://www.example.com/dir2/img1.js?size=small

  • http://www.example.com/dir1/dir2/img1.js

  • http://www.example.com/dir1/dir2/img1.jsp

alt