生效对象

表示一个或者多个过滤条件，用于对请求进行过滤。点击 添加 创建一个过滤条件，您最多可以创建 5 个过滤条件。如果您不添加任何过滤条件，CDN 会拦截所有请求。

在每个过滤条件中，您需要设置过滤类型、对比类型和过滤值。过滤值可以是多个。如果 过滤类型 是 客户端 UA，多个过滤值之间以竖线（|）分隔。如果 过滤类型 不是 客户端 UA，多个过滤值之间以分号（;）分隔。多个过滤值之间的关系是 "或"。

过滤类型的说明如下：

• 文件全路径：表示请求 URL 中的路径。

• 文件目录：表示路径中的目录。

• 文件后缀：表示路径末尾的扩展名。

• 全路径正则：表示请求 URL 中的路径，通过正则表达式匹配。

• 请求 FullQuery：表示请求 URL 中的查询字符串。

• 请求 Query：表示请求 URL 中的查询参数。

• 客户端 IP：表示客户端的 IP 地址。

• 客户端 UA：表示请求中 User-Agent 头部值。

• 自定义请求头部：表示请求中的自定义头部和头部值。

如果过滤类型是 全路径正则 或 请求 FullQuery，过滤值是正则表达式。要使用这两个过滤类型，请 提交工单。

关于对比类型，需要留意的是：

• 等于、匹配： 表示如果请求匹配任何过滤值，该请求就符合过滤条件。

• 不等于、不匹配： 表示如果请求不匹配所有过滤值，该请求才符合过滤条件。

• 属于/属于全局名单：仅适用于 请求 Query，表示一个类型是 "通用列表" 的全局配置。"通用列表" 用来定义大量过滤值。全局配置是一个白名单功能，要使用该功能，请 提交工单。

拦截方式

表示 CDN 如何拦截符合过滤条件的请求。该配置的可选值有：

• 4xx 错误：表示 CDN 响应一个 4xx 的错误码。

• 重定向：表示 CDN 将请求重定向到另一个 URL。

如果您计划创建多条规则，每条规则中指定的拦截方式必须相同。

响应 Body

表示响应正文中包含的内容。该配置有以下选项：

• 系统默认：表示 CDN 使用 4xx 错误码的标准响应正文。

• 自定义：表示 CDN 使用一个自定义响应页面。您可以在 响应页面 下拉列表中选择一个自定义页面。下拉列表中的页面来自 全局配置 页面下的 自定义响应页面 标签页。需要留意的是，"全局配置" 是一个白名单功能。要使用该功能，请 提交工单。

生效对象

生效对象中，过滤值的输入要求如下：

• 如果过滤类型是 文件全路径，每个过滤值表示一个文件路径。每个文件路径必须以斜杠（/）开头。您可以在路径中使用一个或者多个星号（*），每个星号表示一个或者多个字符。例如：/www/img/my*image.png。

• 如果过滤类型是 文件目录，过滤值中的每个目录必须以斜杠（/）开头和结尾。例如：/www/img/。

• 如果过滤类型是 文件后缀，过滤值中的每个后缀无需以句点（.）开头。例如：png;txt。

• 如果过滤类型是 文件全路径、文件目录、文件后缀，过滤值的总长度不能超过 1,024 个字符，不能包含以下字符：

  • 连续斜杠（//）、空格、美元符号（$）、问号（?）、Delete（ASCII code 127）。

• 如果过滤类型是 请求 Query，参数名称和过滤值的有以下要求：

  • 您只能指定一个参数名称，也只能指定一个参数值作为过滤值。

  • 参数名称和过滤值的长度都不能超过 256 个字符。

  • 参数名称和过滤值可以包含数字、字母、百分号（%）、下划线（_）、中划线（-）。

• 如果过滤类型是 客户端 IP，过滤值有以下要求：

  • 总长度不能超过 30,000 个字符。

  • IP 地址的数量不能超过 50 个。

  • IP 地址可以是 IPv4 地址、IPv4 CIDR 地址、IPv6 地址或 IPv6 CIDR 地址。

• 如果过滤类型是 自定义头部 或 客户端 UA 时，过滤值有以下要求：

  • 总长度不能超过 1,024 个字符。除了开头和结尾，过滤值不能包含 *。* 表示一个或者多个任意字符。

  • 过滤值的数量不能超过 50 个。

• 如果过滤类型是 全路径正则 或 请求 FullQuery 时，每个过滤值都是一个正则表达式，总长度不能超过 1,024 个字符。