类型

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

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

规则内容

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

• 常规名单：表示名单中的每个条目是一个 IP 地址或者域名。
• 空 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

• www.example.com
• 192.0.2.0
• 2001:0db8:3c4d:0015:0000:0000:1a2f:1a2b
• *.example.com

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

是

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

www.example.com

见匹配逻辑说明

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