自定义列表

自定义列表包含一个或多个相同类型的项目（例如 IP 地址、主机名或 ASN），您可以在规则表达式中按名称整体引用它们。

Cloudflare 支持以下自定义列表类型：

每种类型都有其自身的属性和 CSV 文件格式。详情请参阅以下各节。

有关由 Cloudflare 管理的列表（例如 Managed IP Lists）的更多信息，请参阅 Managed Lists。

创建自定义列表

在规则表达式中，使用 in 运算符以及自定义列表所支持的字段来使用自定义列表：

<FIELD> in $<LIST_NAME>

可使用的字段因列表项目类型而异：

列表项目类型	可用字段
IP 地址	Fields reference 中列出的类型为 `IP address` 的字段
主机名	`http.host`
ASN	`ip.src.asnum`

有关更多信息和示例，请参阅在表达式中使用列表。

包含 IP 地址的自定义列表中的列表项目必须采用以下格式之一：

同一列表可以同时包含单个地址和 CIDR 范围。

列表中的 IPv6 地址可以使用大写或小写字符。但是，保存列表时，大写字符会转换为小写。

CSV 文件格式

通过 CSV 文件向包含 IP 地址的自定义列表上传项目时，请使用以下文件格式（每行输入一个项目）：

<IP_ADDRESS_1>,<DESCRIPTION>
<IP_ADDRESS_2>

<DESCRIPTION> 字段为可选。

包含主机名的自定义列表中的列表项目必须是完全限定域名 (FQDN)。项目可以包含 * 前缀/子域通配符，其后必须跟一个 .（句点）。项目不能包含方案（例如 https://）或 URL 路径。

例如，以下条目对于包含主机名的自定义列表是有效的：

但是，example.com/path/subfolder 不是有效条目。

您可以将任何有效主机名（有效的 FQDN）添加到包含主机名的自定义列表中。这些主机名不必属于当前的 Cloudflare 账户。

CSV 文件格式

通过 CSV 文件向包含主机名的自定义列表上传项目时，请使用以下文件格式：

<HOSTNAME_1>,<DESCRIPTION>
<HOSTNAME_2>

<DESCRIPTION> 字段为可选。

包含自治系统编号 (ASN) 的自定义列表中的列表项目必须为整数值。

例如，以下条目对于包含 ASN 的列表是有效的：

CSV 文件格式

通过 CSV 文件向包含 ASN 的自定义列表上传项目时，请使用以下文件格式：

<ASN_1>,<DESCRIPTION>
<ASN_2>

<DESCRIPTION> 字段为可选。