文档中心

内容分发网络

规则引擎

条件列表

条件列表

在规则引擎中，匹配条件用于定义拦截和处理客户端请求的规则逻辑。本文详细列出了规则引擎支持的所有条件类型及其配置说明。

条件列表

下表列出了所有可用的条件类型和说明。

条件类型	说明	可指定的运算符	忽略大小写
全部（任意请求）	对任何用户请求都生效。	N/A	N/A
请求路径	用户请求 URL 中的路径，不包含查询字符串。	等于、不等于、前缀匹配、前缀不匹配、后缀匹配、后缀不匹配、正则匹配、正则不匹配、属于全局名单、不属于全局名单	支持
URL（不含协议、host）	用户请求 URL 中的路径和查询字符串。
完整 URL	完整的用户请求 URL。
请求参数	用户请求 URL 中的查询参数。	等于、不等于、存在、不存在、正则匹配、正则不匹配、属于全局名单、不属于全局名单
Origin 请求头	用户请求中的 `Origin` 头部。
Referer 请求头	用户请求中的 `Referer` 头部。
UA 请求头	用户请求中的 `User-Agent` 头部。
HTTP 请求头	用户请求中的指定头部。
HTTP 响应头	CDN 响应用户请求时的指定头部。
客户端 IP	发送用户请求的客户端 IP 地址。	匹配、不匹配、属于全局名单、不属于全局名单	N/A
请求时间	CDN 收到用户请求的时间，可选项有每日、每周或特定时间段。特定时间段精确到秒。	匹配、不匹配	N/A
客户端区域	客户端 IP 地址所在的国家或地区。
HTTP 响应状态码	CDN 响应用户请求的 HTTP 状态码。
请求方法	用户请求使用的 HTTP 方法。	等于、不等于
请求协议	用户请求使用的协议，可以是 HTTP 或者 HTTPS。	等于、不等于
客户端证书信息	客户端证书的指定字段，用于在访问双向认证场景下基于证书内容进行匹配。支持的字段包括： CN（通用名） SN（序列号） C（国家） L（城市/地区） O（组织/公司） OU（部门/组织单位）说明使用 "客户端证书信息" 条件的前提是域名已启用访问双向认证。	匹配、不匹配	支持

说明

需要额外说明的运算符：
- 等于/不等于：进行精确的字符串匹配。
- 前缀/后缀匹配：判断字符串是否以指定的前缀开头或者以指定的后缀结尾。
- 正则匹配：判断字符串是否匹配指定的正则表达式。例如，对于字符串 abc123a45，正则表达式 [0-9]{1,}a{1,3} 会匹配到 123a，因此视为匹配成功。要使用 正则匹配，请提交工单。
- 属于全局名单：判断字符串是否属于指定的全局配置。参见全局配置。
多个匹配值的逻辑：
- 对于“等于”、“前缀匹配”、“后缀匹配”、“正则匹配”，多个匹配值之间的关系是 “或”。
- 对于“不等于”、“前缀不匹配”、“后缀不匹配”、“正则不匹配”，多个匹配值之间的关系是“且”。

附录：匹配值输入要求

条件类型	输入要求
请求路径	以 `/` 开头长度不超过 300 字符不能包含 `%` 和空格最多 100 个，以回车分隔
URL（不含协议、host）	以 `/` 开头长度不超过 300 字符不能包含 `%` 和空格最多 100 个，以回车分隔
完整 URL	以 `http://` 或 `https://` 开头长度不超过 300 字符不能包含 `%` 和空格最多 100 个，以回车分隔
请求参数	名称不超过 30 字符每个值不超过 100 字符，不能包含 `%` 和空格最多 100 个值，以回车分隔
Origin 请求头	每个头部值长度不超过 200 字符最多 100 个，以回车分隔
Referer 请求头	每个头部值长度不超过 200 字符最多 100 个，以回车分隔
UA 请求头	每个头部值长度不超过 200 字符最多 100 个，以回车分隔
HTTP 请求头	名称不超过 100 字符每个值不超过 200 字符最多 100 个值，以回车分隔
HTTP 响应头	名称不超过 100 字符每个值不超过 200 字符最多 100 个值，以回车分隔
客户端 IP	支持 IPv4、IPv6、CIDR 格式最多 100 个，以回车分隔
客户端证书信息	单个匹配值长度不超过 64 字符最多 100 个，以回车分隔支持精确匹配，以及使用 `` 作为前缀（如 `value`，表示以 `value` 结尾）或后缀（如 `value`，表示以 `value` 开头）的通配匹配不支持首尾同时使用 ``（如 `value`）

最近更新时间：2026.09.18 17:49:52

这个页面对您有帮助吗？

有用

有用

无用

无用