请求条件

表示一个或者多个匹配条件，最多 50 个，用于对用户请求进行匹配。点击 添加 创建一个匹配条件。


您可以指定这些匹配条件之间的关系，默认是 或。


您可以选择的匹配对象有：

• 文件全路径
• 文件目录
• 文件后缀
• 客户端 IP
• 用户网络运营商
• 请求 Query：表示请求 URL 中的某个查询参数。
• 请求 FullQuery：表示请求 URL 中的所有查询参数。
• 自定义请求头部：表示请求中的某个头部。

关于各匹配对象所对应的匹配类型，以及匹配值的输入要求和示例，参见 附录一。

源站模式

表示源站的模式，该配置有以下可选项：

• 主源
• 备源

您可以设置的主源站和备源站的总数不能超过 50 个。

源站类型

表示源站的类型，该配置有以下可选项：

• IP：表示源站是 IP 地址。
• 域名：表示源站是域名。
• TOS：表示源站是存储桶，存储桶来自火山引擎对象存储（TOS）。存储桶通过服务授权的方式访问。
• TOS 固定密钥：表示源站是 TOS 存储桶，通过火山引擎用户的 AccessKey 访问。该方式适用于以下场景：
  • 精细化访问控制：通过 AccessKey 实现存储桶的访问控制。
  • 跨账号访问：访问另一个火山引擎账号下的存储桶。
• 阿里云 OSS：表示源站是存储桶，存储桶来自阿里云对象存储（OSS）。
• 腾讯云 COS：表示源站是存储桶，存储桶来自腾讯云对象存储（COS）。
• Amazon S3：表示源站是存储桶，存储桶来自 AWS S3 或者使用 S3 兼容鉴权方式的对象存储服务。该类型对应常规源站配置中 Amazon S3 下的 厂商默认域名 类型，不推荐使用。
• AWS S3 兼容：对应常规源站配置中 Amazon S3 下的 自定义域名 类型，输入的桶域名无格式限制。您既可以输入云厂商分配的桶域名，也可以输入您为存储桶设置的自定义域名。

地址权重

参见 源站配置 中的说明。

回源地址

私有桶

回源 Host

HTTP 端口

HTTPS 端口

AccessKey ID

AccessKey Secret

文件全路径

• 等于、不等于
• 正则匹配、正则不匹配

• 必须以斜杠（/）开头。
• 可以包含通配符 *，但不能仅仅是 *。
• 总长度不能超过 1,024 个字符。
• 多个路径之间以分号（;）分隔，总长度不能超过 1,024 个字符。
• 不能包含以下字符：
  • 双斜杠（//）、空格、美元符号（$）、问号（?）。

/www/img/my*image.png;/docs/file

请求 FullQuery

• 正则匹配、正则不匹配

• 总长度不能超过 1,024 个字符。
• 多个正则表达式之间以分号（;）分隔。

^a{1,2}b(.*)g=val[1-3]

文件目录

• 等于、不等于

• 必须以斜杠（/）开头和结尾。
• 总长度不能超过 1,024 个字符。
• 多个目录之间以分号（;）分隔。
• 不能包含以下字符：
  • 双斜杠（//）、空格、美元符号（$）、问号（?）。

/www/img/;/docs/folder/

文件后缀

• 等于、不等于

• 只能包含字母和数字。
• 总长度不能超过 1,024 个字符。
• 不能以句点（.）开头。
• 多个后缀之间以分号（;）分隔。

png;jpg

客户端 IP

• 等于、不等于
• 属于、不属于：表示客户端 IP 地址是否归属于您指定的国家和地区。

对于 IP 地址：

• 数量不能超过 5 个。
• 仅支持输入 IPv4 地址和 IPv4 CIDR。
• 多个 IP 地址之间以分号（;）分隔。

xx.xx.xx.x;xxx.xxx.xxx.xx

用户网络运营商

• 属于、不属于

• 您可以指定一个或者多个网络运营商。

移动 联通 鹏博士

请求 Query

• 等于、不等于
• 正则匹配、正则不匹配
• 存在、不存在
• 为空、不为空

参数名称

• 每个匹配条件中只能指定一个参数名称。
• 长度不能超过 256 个字符。
• 只能包含数字、字母、下划线（_）、中划线（-）、句点（.）。

参数值

• 参数值可以是多个，以分号（;）分隔，总长度不能超过 1,024 个字符。

参数名称
param

参数值
p_value1;p_value2

自定义请求头部

• 匹配、不匹配
• 为空、不为空

头部名称

• 每个匹配条件中只能指定一个头部名称。
• 长度不能超过 1,024 个字符。
• 不能包含汉字、下划线（_）、空格、双引号（"）、冒号（:）。

头部值

• 头部值可以是多个，以竖线（|）分隔，数量不能超过 50 个。
• 总长度不能超过 1,024 个字符。
• 头部值可以以通配符 * 开头或结尾，但不能仅仅是 *。

头部名称
header

头部值
header_value1