内容分发网络 缓存刷新 - 配置指南

功能介绍

内容分发网络（CDN）提供基础缓存配置能力，可根据指定业务类型、目录、具体 URL 等各类规则设置缓存过期时间，来达到定期清理节点缓存资源，回源站重新拉取最新资源重新缓存的目的。

除此之外，CDN 提供了缓存刷新的能力，可批量指定 URL 或目录进行刷新操作：

• 刷新 URL：删除 CDN 所有节点上对应资源的缓存。
• 刷新目录：选择 “刷新变更资源” 模式，当用户访问匹配目录下资源时，会回源获取资源的 Last-Modify 信息，若与当前缓存资源一致，则直接返回已缓存资源，若不一致，回源拉取资源并重新缓存；选择 “刷新全部资源” 时，当用户访问匹配目录下资源时，直接回源拉取新资源返回给用户，并重新缓存新资源。

说明：

刷新成功执行后，节点上对应资源无有效缓存，当用户再次发起访问时，节点回源站拉取所需资源，并重新缓存在节点上。因此提交大量的刷新任务，会清空较多缓存，从而导致回源请求突增，源站会产生较大压力。

适用场景

新资源发布

在源站点将新资源覆盖至同名旧资源后，为避免全网用户受节点缓存影响仍访问到旧的资源上，可通过提交对应资源的 URL/目录进行刷新，清空全网缓存后，全网用户可直接访问到最新资源。

违规资源清理

当站点上存在违规资源（如涉黄、涉毒、涉赌）被发现时，删除源站资源后，由于节点缓存资源仍可被访问到，为维护网络环境，可通过 URL 刷新删除缓存资源，保证及时清理。

操作指南

使用方式

登录 CDN 控制台，单击左侧目录的【刷新预热】，进入后可按需提交【URL 刷新】及【目录刷新】：

说明：

开启 urlencode 功能后，URL 刷新和目录刷新将自动对中文字符进行编码转换。

在【操作记录】部分，可指定时间周期、关键字、刷新任务类型进行查询，关键字仅支持指定域名查询，或指定完整的刷新 URL / 目录查询：

说明：

控制台最多可一次性返回 10000 条操作记录，并支持导出为完整的 excel 形式，若您的刷新任务较多，请分段批量查询导出。

注意事项

URL 刷新：

• 每一个账号每日 URL 刷新限额为10000条，每次可提交的 URL 刷新限额为1000条。开通了境外加速的客户，境外每日 URL 刷新限额为10000条，与境内配额相互独立。
• 刷新任务提交时需要携带http://或https://协议标识。
• 不支持刷新 http://*.test.com/格式 URL ，即使接入的是泛域名做加速服务，在刷新时也需要提交对应的子域名进行刷新。
• 刷新提交时 URL 中域名需要接入加速服务，否则会导致提交失败。
• 默认按照提交刷新 URL 任务时，URL 中域名加速区域进行全区域刷新。

目录刷新：

• 每一个账号每日目录刷新限额为100条，每次可提交的目录刷新限额为20条。开通了境外加速的客户，境外每日目录刷新限额为100条，与境内配额相互独立。
• 刷新任务提交时需要携带http://或https://协议标识。
• 不支持刷新http://*.test.com/格式目录，即使接入的是泛域名做加速服务，在刷新时也需要提交对应的子域名进行刷新。
• 刷新提交时 URL 中域名需要接入加速服务，否则会导致提交失败。

子用户权限配置：

• 刷新目录、刷新 URL、查询刷新记录目前已经接入最新的权限系统，支持资源（域名）维度权限配置。
• 分配方式请参见 权限配置。

使用案例

目录刷新-刷新变更资源

加速域名为：purge-test-1251991073.file.myqcloud.com，源站为腾讯云对象存储（COS），源站资源如下：

1. 分别发起请求访问资源 1.txt 与 2.txt，根据 X-Cache-Lookup: Hit From Distank3 与 Server: NWS_SPMid 可以判定命中节点， 由节点直接返回资源：
   
   
2. 在源站替换掉同名文件 1.txt，文件修改时间发生改变，2.txt 保持不变：
   
   
3. 此时再发起请求，由于缓存尚未过期，访问资源 1.txt 仍为旧的内容：
   
4. 提交目录刷新，选择【刷新变更资源】，等待刷新完成：
   
5. 刷新完成后，由于文件 1.txt Last-Modified 发生变更，请求直接回源，而文件 2.txt 由于未做变更，即使提交目录刷新，仍被节点命中返回：