内容刷新

CDN Pro 内容管理提供了缓存刷新功能，供您快速更新CDN Pro上的缓存文件。当您的 Web 服务器（源站）上的资源内容有更新，并且您希望 CDN Pro 也可以立即使用新文件内容响应用户的时候，就可以使用该功能来刷新CDN Pro的缓存文件。典型的内容刷新场景如下：

• 业务迭代发版时，更新了资源内容，但是源站内容缓存过期时间设置为1周，您希望在源站版本升级后也同步更新CDN Pro上的资源。
• 网站新闻发布时，Web服务期更新了资源，您希望立即将最新发布的消息推送给您的用户。
• 业务内容违规，需要清理缓存资源以确保响应给用户的内容是合法的。
• 您可以在内容管理下执行缓存刷新操作。本文将为您介绍如何在CDN Pro控制台上进行内容刷新。

您可以在内容管理下执行缓存刷新操作。本文将为您介绍如何在CDN Pro控制台上进行内容刷新。

管理内容刷新任务

点击控制台左侧【内容管理】【刷新】菜单，进入内容刷新页面，页面关键元素和说明如下图示及表格：

创建刷新任务

1. 进入创建任务表单页。在内容刷新页面下，点击刷新任务列表左上方的“新建刷新任务”按钮，进入创建刷新任务表单页。

2. 填写任务信息。您需填写的表单信息及字段说明如下图及表格所示：

字段	说明
目标环境	选择需要执行文件刷新的目标环境，为生产环境或者演练环境。系统默认选择演练环境。
刷新方式	选择文件内容刷新方式，是直接删除内容还是使其过期无效。 ●删除：从CDN Pro边缘节点服务器中删除缓存对象。缓存删除之后，当边缘服务器收到本次删除内容文件的请求时，由于CDN Pro上已没有对应的缓存，无法直接响应文件给用户，此时便会直接回源的源站服务器检索文件。 ●强制过期：将CDN Pro边缘节点服务器中的缓存对象标记为过期，但是不会删除节点上的缓存内容。缓存强制过期后，当边缘服务器收到本次强制过期内容文件的请求时，会对比源站对应文件的版本，若源站文件版本比节点缓存文件版本更新时，CDN Pro节点才会回源站服务器检索该文件；如果源站无法访问，则CDN Pro 边缘服务器可以继续为您的终端用户提供旧的缓存文件内容。系统默认选择强制过期的刷新方式。
刷新类型	选择要刷新类型，可以是单文件刷新、通配符匹配刷新多个缓存内容、正则表达式匹配刷新指定内容。默认类型为文件刷新。其中： ●文件：指定单个文件刷新，一个文件对应一条URL。注意：如果一个文件由于配置了自定义缓存健（Cache Key ）而存在多个缓存版本，请使用请选择目录刷新。 ●目录：指定刷新某个目录下的文件/目录，支持输入通配符来指定刷新的内容。当您需要删除目录文件时可以采用此刷新类型。详见：目录（通配符）刷新。 ●正则：指的是采用正则表达式来搜索匹配刷新内容。当文件刷新和目录刷新无法满足您的需求时，可采用此刷新类型。详见：正则刷新。
添加要刷新的文件	填写指定刷新的文件内容URL信息。您可以直接在输入框按照指定格式填写刷新内容，也可以在txt文件中填写完成后直接拖拽导入填写框。其中： ●当选择 “刷新类型” = “文件” 时，请输入要刷新的文件的完整 URL（例如：http://test.domain1.com/1.txt 、http://test.domain2.com/2.txt?q1=1&q2=3）。需要刷新多个则输入多个URL，以回车键分隔。 ●当选择 “刷新类型” = “目录” 时，请按照指定的通配符语法格式输入指定刷新文件。CDN Pro支持基于URL前缀的刷新、支持制定刷新目录及其子目录，详见：目录（通配符）刷新。 ●当选择 “刷新类型” = “正则” 时，请按照指定的正则表达式语法格式输入指定刷新文件。详见：正则刷新。
添加文件刷新请求头	当选择 “刷新类型” = “文件” 时，可选填写此部分信息。若您要刷新的文件URL设置了通过请求头来区分缓存键（Cache key），可以在此处添加HTTP请求头来指定需要刷新的缓存版本。您可点击“添加”按钮新增一条HTTP头部配置，若您想移除对应的配置，可以点击操作类的删除（）按钮来移除请求头配置。 ●示例：某个文件URL，当自定义了一个请求头X-Version，值为1或者2，并且您根据该头部设置了不同版本的响应文件内容。此时，您想刷新版本2的文件内容，则可以添加一个名称为“X-Version”、值为“2”的文件刷新请求头信息。

3. 提交刷新。表单页左下角“开始刷新”按钮，提交内容刷新任务。

4. 查看刷新结果。刷新任务提交完成后，您可返回刷新任务列表页查看任务刷新结果。您还可以查看刷新任务详情或重新提交刷新。

温馨说明：CDN Pro会动态控制加速节点服务器文件/目录刷新并发数，以进行节点自保，保障加速加速性能优先。您在创建刷新任务的时候可以在控制台上看到当前可刷新的文件额度/目录额度。当任务下发执行完成后，CDN Pro会逐渐自动释放刷新额度。其中：

• 每日初始额度：文件10000个；目录/正则共40个；
• 每日最大可释放额度：文件5000个；目录/正则共20个。
• 单次任务可提交额度：文件1000个；目录20个；正则2个。

目录（通配符）刷新

CDN Pro 允许您通过指定目录的方式来刷新整个目录下的文件。您可以在 URL 中输入通配符以制定刷新的目录。基本规则如下：

• 子目录结尾以单个星号（*）结束，仅刷新本目录层级下的所有文件。
• 目录结尾以两个星号（*）结束，将刷新本目录层级和子目录层级下的所有文件。
• URL结尾以拓展名结束（*.ext），则刷新所有具有指定扩展名的文件。
• 刷新 URL 中包含百分比字符号（%），则将需要将其进行编码转换为 %25 。

注意： 如果您在边缘逻辑中配置了自定义缓存键（Cache Key），或者通过配置Vary头部等方式来区分缓存，那么同一个 URL 文件可能会存在多个不同的缓存文件版本，例如： /pictures/ 或 /picture.jpg 均会缓存多个版本文件。因此，如果您执行不带星号的目录刷新，则会刷新掉除该目录下的所有文件版本，但是不刷新其子目录下的文件；如。如果您配置了 /pictures/、/pictures/* 和 /pictures/** 的目录刷新任务，将会得到不同的刷新结果。

下表是目录刷新的配置示例：

正则刷新

CDN Pro 允许您通过正则表达式来匹配缓存键，以此指定要您要刷新的文件内容。基本规则如下：

• 正则表达式必须以 {scheme}://{hostname} 开头，其中 {scheme} 是指 http、https 或其他请求协议类型。例如：https://test.domain.com/my.*\.(jpg|png)\?q= 。
• hostname后面的正则表达式长度应小于 126字符。
• 最多可以包含两个无限量词（“*”、“+”或",}")
• 任何量词的上限不能超过59。

查看刷新任务详细信息

1、在控制台内容刷新页面下，点击所选刷新任务的任务ID字段，进入刷新任务详情页。

2、刷新任务详细信息的图示及说明如下：