类型

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

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

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

配置方式

表示如何指定名单中的条目。该配置有以下选项：

• 域名配置：表示在 "Referer 黑白名单" 的配置中指定名单中的条目。

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

规则内容

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

• 常规名单：表示名单中的每个条目是一个 IP 地址或者域名。

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

• 空 Referer：表示 "空 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 校验

表示在尝试使用名单中条目匹配 Referer 头部前，CDN 是否校验 Referer 头部的合法性。

• 如果您勾选该选项，CDN 不会校验 Referer 头部的合法性。
• 如果您不勾选该选项，CDN 会校验 Referer 头部的合法性。如果一个请求的 Referer 头部不合法，无论您配置的是黑名单还是白名单，CDN 都会拒绝该请求。
  

关于 Referer 头部合法性
一个合法的 Referer 头部必须符合 HTTP 协议规范。规范要求 URL 必须是以下格式之一：

• scheme://host:port/path

• scheme://host:port/

• scheme://host:port

• scheme://host/path

• scheme://host/

• scheme://host

正则名单（输入框）

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

当 CDN 尝试使用正则表达式来匹配 Referer 头部时，匹配过程是大小写不敏感的，并且不会校验 Referer 头部的合法性。

• www.test.com

• 1.1.1.1

• 2001:0db8:3c4d:0015:0000:0000:1a2f:1a2b

• *.test.com

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

是

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

www.test.com

见匹配逻辑说明

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

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