跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

自定义列表

最后更新 查看 MarkdownAgent 设置

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

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

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

有关由 Cloudflare 管理的列表(例如 Managed IP Lists)的更多信息,请参阅 Managed Lists。

创建自定义列表

请参阅 在仪表板中创建列表 或 Lists API 页面。

使用自定义列表

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

<FIELD> in $<LIST_NAME>

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

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

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


自定义列表类型

包含 IP 地址的列表(IP 列表)

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

  • 单个 IPv4 地址
  • 单个 IPv6 地址
  • 前缀为 /8 到 /32 的 IPv4 CIDR 范围
  • 前缀为 /12 到 /128 的 IPv6 CIDR 范围

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

Cloudflare 会规范化列表中的 IPv6 地址。保存列表时,Cloudflare 会将大写字符转换为小写,并删除每个分段中的前导零。例如,2400:d400:0011:19::2 会存储为 2400:d400:11:19::2。搜索列表项时,请使用列表中显示的规范化形式。

CSV 文件格式

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

<IP_ADDRESS_1>,<DESCRIPTION>
<IP_ADDRESS_2>

<DESCRIPTION> 字段为可选。

包含主机名的列表

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

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

  • example.com
  • api.example.com
  • *.example.com

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

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

CSV 文件格式

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

<HOSTNAME_1>,<DESCRIPTION>
<HOSTNAME_2>

<DESCRIPTION> 字段为可选。

包含 ASN 的列表

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

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

  • 1
  • 13335
  • 64512

CSV 文件格式

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

<ASN_1>,<DESCRIPTION>
<ASN_2>

<DESCRIPTION> 字段为可选。

这篇文档对您有帮助吗?