类型

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

• 白名单：指定一个白名单。如果用户请求中的 Referer 不匹配该清单，CDN 会拒绝请求。

• 黑名单：指定一个黑名单。如果用户请求中的 Referer 匹配该清单，CDN 会拒绝请求。

配置方式

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

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

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

规则内容

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

• 常规名单：名单中的每个条目是一个 IP 地址或者域名，用来对 Referer 中的 hostname 进行匹配校验。

• 正则名单：名单中的每个条目是一个正则表达式，用来对 Referer 中的完整 URL 进行匹配校验。要指定该选项，请 提交工单。

• 空 Referer：表示当用户请求不包含 Referer 头部时，CDN 处理请求的方式。该配置有以下选项：

  • 勾选：表示如果请求不包含 Referer 头部，则该请求被认为匹配您配置的名单。

  • 不勾选：表示如果请求不包含 Referer 头部，则该请求被认为不匹配您配置的名单。

常规名单（输入框）

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

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

如果您需要输入的条目数量超过 1,000，参考 全局配置。

关于泛域名和子域名

• 泛域名不匹配域名本身。例如：*.example.com 不匹配 example.com，但是匹配 www.example.com、a.a.example.com 等。

• 子域名的级别数量没有限制。例如，您可以在名单中指定 aaa.bbb.ccc.ddd.eee.fff.ggg.eee.example.com。

忽略 Scheme 校验

表示 CDN 是否对 Referer 中的 scheme 进行校验，也就是校验 Referer 是否包含 http:// 或者 https://。该配置有以下选项：

• 勾选：表示 CDN 不校验 Referer 是否包含 scheme。在这个情况下，无论 Referer 是否包含 scheme，CDN 都会将 Referer 与您配置的名单进行匹配校验。

• 不勾选：表示 CDN 会先校验 Referer 是否包含 scheme。只有 Referer 包含 scheme，CDN 才会将 Referer 与您配置的名单进行匹配校验。否则，CDN 判定请求与您配置的名单不匹配。

该配置对正则名单不生效，因为 CDN 依赖正则表达式来判断 Referer 是否匹配正则名单。

黑名单

https://www.eXampLe.com/file?p=v

勾选

N/A

拒绝请求

www.example.com/file?p=v

N/A

勾选

N/A

拒绝请求

https://www.example.com

N/A

接受请求