匹配条件

表示匹配用户请求的条件，在 IF 下创建。匹配条件可以是单条件或者条件组。条件之间的关系由条件关系定义。

• 单条件：包含条件类型、运算符、匹配值。

• 条件组：包含多个条件以及这些条件之间的关系。

• 条件关系：连接最多 5 个条件。条件之间的关系可以是：

  • And：表示匹配的要求是满足所有条件。

  • Or：表示匹配的要求是满足任意条件。

单条子规则

遵循 IF ... ELSE ... 结构的处理逻辑，也就是说：

• 如果 IF 语句满足，CDN 执行 IF 下的动作。

• 否则，CDN 执行 ELSE 下的动作。

单条规则

在单条规则下：

• 如果规则下没有子规则，则遵循 IF ... ELSE ... 结构的处理逻辑。

• 如果规则下存在子规则，该规则的处理逻辑如下：

  • 如果外层 IF 语句满足，CDN 先执行外层 IF 下的动作，然后依次处理 IF 下的每条子规则。

  • 否则，CDN 先执行外层 ELSE 下的动作，然后依次处理 ELSE 下的每条子规则。

用户请求

• 请求路径
• URL（不含协议、host）
• 完整 URL
• 请求参数
• Referer 请求头
• 客户端 IP
• Origin 请求头
• UA 请求头
• HTTP 请求头
• 客户端区域
• 请求方法
• 请求时间
• 请求协议

• 拒绝访问
• 允许访问
• URL 重定向改写
• 协议强制跳转
• 客户端请求头设置
• 下载限速

收到客户端请求

• Range 回源
• 回源重定向跟随
• 回源 HTTP 超时
• 回源 TCP 超时
• HTTP 请求头设置

回源请求文件

• 节点缓存规则
• 视频拖拽
• 缓存键值
• 智能压缩

缓存源站响应

源站响应

• 源站响应头
• 源站响应状态码

HTTP 响应头设置

响应用户请求

请求路径

表示用户请求 URL 中的路径。

等于、不等于、前缀匹配、前缀不匹配、后缀匹配、后缀不匹配、正则匹配、正则不匹配

等于/不等于 说明

• 这两个运算符使用字符串精确匹配。

前缀匹配/前缀不匹配/后缀匹配/后缀不匹配 说明

• 前缀匹配/前缀不匹配：表示如果匹配对象的值是以您指定的前缀开头，则视为匹配。

• 后缀匹配/后缀不匹配：表示如果匹配对象的值是以您指定的前缀结尾，则视为匹配。

如果您勾选了 忽略大小写，表示 CDN 在将条件与用户请求或者源站响应匹配时，匹配过程是大小写不敏感的。

请求参数

表示用户请求 URL 中的查询参数。

等于、不等于、存在、不存在、正则匹配、正则不匹配

"正则匹配" 说明
如果对象值中包含指定正则表达式匹配的字符串，则该对象值与正则表达式视为匹配。

例如：对象值是 abc123a45。您指定的正则表达式是 [0-9]{1,}a{1,3}，与对象值中的 123a 匹配。这个情况下，该对象值与正则表达式视为匹配。

要使用 "正则匹配"，也请 提交工单。

客户端 IP

表示发送用户请求的客户端 IP 地址。

匹配、不匹配

N/A

请求时间

表示 CDN 收到用户请求的时间。

该条件类型有以下选项：

• 每日时间段：表示每天的一个固定时间段。

• 星期：表示每星期中的固定几天。

• 特定时间段：表示一个时间段。您需要指定该时间段的开始时间和结束时间，精确到秒。

URL 重定向改写

收到客户端请求

参见文档

针对客户端请求的特征，制定更细化的黑白名单策略，并自定义 CDN 的响应状态码。

请求特征涵盖：

• 请求头，包含 User-Agent、Referer、Origin 等

• 客户端 IP 地址

• 请求 URL

• 客户端所在地区

• 请求方法等

• ... ...

针对客户端请求的特征，设置相应的缓存时间，以制定更细化的缓存策略。

请求特征涵盖：

• 请求头，包含 User-Agent、Referer、Origin 等

• 客户端 IP 地址

• 请求 URL

• 客户端所在地区

• 请求方法等

• ... ...

除了 scheme 是 HTTP/HTTPS 的请求，额外来自微信小程序的请求进行跨域校验（验证 URL 格式），并返回客户端预期的 Access-Control-Allow-Origin 头部值。

设置要求：

• 默认删除 Access-Control-Allow-Origin 头部。

• 如果跨域校验通过，则将响应中 Access-Control-Allow-Origin 头部设置为请求中 Origin 头部值。

请求路径

每个路径必须以 / 开头，长度不能超过 300 个字符，不能包含以下字符：

• %、空格

每个路径之间以回车分隔，最多 100 个路径。

URL（不含协议、host）

每个 URL 必须以 / 开头，长度不能超过 300 个字符，不能包含以下字符：

• %、空格

每个 URL 之间以回车分隔，最多 100 个 URL。

完整 URL

每个 URL 必须以 https:// 或者 http:// 开头，长度不能超过 300 个字符，不能包含以下字符：

• %、空格

每个 URL 之间以回车分隔，最多 100 个请求 URL。

请求参数

请求参数的名称不能超过 30 个字符。

每个参数值不能超过 100 个字符，不能包含以下字符：

• %、空格

每个参数值之间以回车分隔，最多 100 个参数值。