缓存刷新--内容分发网络-火山引擎

文档中心

导航

缓存刷新

最近更新时间：2024.05.15 16:37:46首次发布时间：2021.08.12 16:35:16

缓存刷新概述

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

工作原理

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

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

适用场景

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

站点上有关键文件被更新了。此时，您需要用户能获取最新的文件。如果您站点上文件的更新频率是可预知的，建议您为站点文件配置缓存规则。
源站上的特定文件由于某些原因需要被删除。然而，这些文件可能已被内容分发网络缓存了。您不希望用户访问这些文件。

最佳实践

内容分发网络可以与火山引擎函数服务配合使用，以实现以下功能：

如果您的源站包含火山引擎对象存储 TOS 中的存储桶，您可以使用函数服务实现在某些文件在 TOS 上发生变更时，自动触发内容分发网络对这些文件的刷新操作。详情参见使用函数实现 TOS 触发 CDN 刷新预热。
使用函数服务实现定时触发内容分发网络对特定文件的刷新操作。详情参见使用函数服务定时触发 CDN 刷新预热。

注意事项

"缓存刷新"可以确保用户获取最新版本的文件。但是当您对一个文件提交刷新任务并且该任务成功执行后，该文件的第一次访问是无法获得加速的。如果您需要该文件的第一次访问能被加速，在刷新任务成功执行后，您可以使用文件预热功能。关于如何了解任务的执行状态，参见操作记录。
在您提交刷新任务后，生效时间大约是 5 分钟。
在您对大量文件提交刷新任务后，这些文件的首次请求都会触发回源请求。因此您的源站可能会在短期内承受流量压力，特别是在文件体积较大的时候。
您不能直接对泛域名下的文件和目录执行刷新操作。参见如何对泛域名下的文件和目录执行刷新、预热、封禁和解封操作。

刷新配额

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

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

说明

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

操作步骤

登录火山引擎内容分发网络控制台。
在左侧导航栏，点击 刷新预热。
在 刷新预热 页面，点击 缓存刷新 标签页。
按照配置说明进行操作。
点击提交。

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。
上传文件：表示上传一个 .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