类型

表示名单的类型。该配置有以下选项：

• 白名单：当您只想 CDN 允许来自某些站点的请求时，可以配置 Referer 白名单。如果用户的请求不匹配白名单，CDN 拒绝请求并且响应 403 状态码。

• 黑名单：当您只想 CDN 阻止来自某些站点的请求时，可以配置 Referer 黑名单。如果用户的请求匹配了黑名单，CDN 拒绝请求并且响应 403 状态码。

配置方式

表示名单中条目的来源。该配置有以下选项：

• 策略配置：表示名单中的条目是在 常规名单 和 正则名单 中配置的。

• 全局配置：表示名单中的条目来自一个 全局配置。全局配置用来定义大量条目的。一个全局配置最多可以包含 4,000 个条目。要使用全局配置，请 提交工单。

规则内容

表示名单的配置选项，包含：

• 常规名单：表示一个名单。名单中的每个条目是一个 IP 地址或者域名，用来匹配用户请求中 Referer 头部的 hostname。

• 正则名单：表示一个名单。名单中的每个条目是一个正则表达式，用来匹配用户请求中的完整 Referer 头部。要指定该选项，请 提交工单。

• 空 Referer：表示 CDN 对包含 空 Referer" 的用户请求的处理方式。

  • 如果 类型 是 黑名单，勾选该选项表示 CDN 拒绝 Referer 为空的请求，不勾选该选项表示 CDN 接受 Referer 为空的请求。

  • 如果 类型 是 白名单，勾选该选项表示 CDN 接受 Referer 为空的请求，不勾选该选项表示 CDN 拒绝 Referer 为空的请求。

常规名单（输入框）

表示一个常规名单。如果您在 规则内容 处勾选了 常规名单，该输入框会出现。

输入要求
名单最多可以包含 1,000 个条目，总长度不能超过 30,000 个字符。您可以输入一个或者多个域名和 IP 地址。域名可以是泛域名。IP 地址可以是 IPv4 地址、IPv6 地址、IPv4 CIDR 地址或者 IPv6 CIDR 地址。多个条目之间使用分号（;）分隔或者每个条目一行。

关于泛域名和子域名

• 泛域名不包含域名本身。例如：*.example.com 不包含二级域名 example.com，但是包含 www.example.com、a.a.example.com 等。

• 子域名的级别数量没有限制。例如，您可以指定一个子域名为 aaa.bbb.ccc.ddd.eee.fff.ggg.eee.example.com。关于 Referer 名单的匹配逻辑，参见 Referer 匹配逻辑。

忽略 scheme 校验

表示 CDN 将用户请求中的 Referer 与您配置的常规名单匹配前，CDN 是否校验用户请求中的 Referer 头部。

• 如果您勾选该选项，CDN 不会校验 Referer 头部。
• 如果您不勾选该选项，CDN 会校验 Referer 头部是否符合 URL 规范。如果 Referer 头部不符合 URL 规范，CDN 会拒绝该请求。
  

符合 URL 规范的 Referer 头部
如果一个 Referer 头部是以下任意格式，该 Referer 头部就符合 URL 规范。

• scheme://host:port/path

• scheme://host:port/

• scheme://host:port

• scheme://host/path

• scheme://host/

• scheme://host

正则名单（输入框）

表示一个正则表达式的名单，用于匹配完整的 Referer 头部。您最多可以指定 100 个正则表达式，每个正则表达式一行。如果您在 规则内容 处勾选了 正则名单，该输入框会出现。

正则名单中的条目不区分大小写。

• www.test.com

• 198.51.100.25

• 2001:DB8::1

• *.test.com

http://www.test.com/test.js

是

Referer 头部中的域名匹配名单。

www.test.com

见匹配逻辑说明

• 如果未启用 忽略 scheme 校验，结果是不匹配。原因是 Referer 头部不符合 URL 规范。

• 如果启用了 忽略 scheme 校验，结果是匹配。