生效对象

表示一个或者多个匹配条件，用于对请求进行匹配。点击 添加 创建一个匹配条件，您最多可以创建 5 个匹配条件。如果您不添加任何匹配条件，表示所有请求都匹配这条规则。

在每个匹配条件中，您需要设置匹配类型、对比类型和匹配值。匹配值可以是多个。如果 匹配类型 是 客户端 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 个字符。