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

列表

最后更新 查看 MarkdownAgent 设置

列表允许您将 IP 地址、主机名或自治系统号 (ASN) 等项目分组,并在 Cloudflare 规则表达式 中按名称引用它们。无需在每条需要的规则中逐个添加项目,您只需定义一次分组,即可在规则和 zone 之间重复使用。

您可以创建自己的 自定义列表,或使用由 Cloudflare 维护的 托管列表(Managed Lists),例如提供威胁情报数据的托管 IP 列表。

列表具有以下优势:

  • 创建规则时,使用 list 比将一长串 IP 地址等项添加到规则表达式更简单且不易出错。
  • 更新针对同一 IP 地址(或主机名)组的规则时,使用 IP list(或 hostname list)比编辑多条规则更简单且不易出错。
  • List 更易读且信息更丰富,尤其是为 list 使用描述性名称时。

更新 list 内容时,使用该 list 的所有规则会自动更新,因此只需修改 list 一次,无需逐条修改规则。

Cloudflare 在账户级别存储 list。可在 Cloudflare 账户中不同 zone 的规则中使用同一 list。

支持的列表

Cloudflare 支持以下列表:

详情请参阅各页面。

您也可以在规则表达式中使用 内联列表。内联列表允许您直接在表达式中包含值,而无需先创建单独的列表。但是,对值的任何更改都需要编辑规则本身。

列表名称

列表名称必须符合以下要求:

  • 名称仅使用小写字母、数字和下划线 (_) 字符。有效名称满足此正则表达式:^[a-z0-9_]+$。
  • 列表名称的最大长度为 50 个字符。

使用列表

创建和编辑列表

您可以在 Cloudflare 仪表板中创建列表,或使用 Lists API(列表 API)。

创建列表后,您可以添加和删除列表中的项目,但不能更改列表名称或类型。

在表达式中使用列表

Cloudflare 仪表板和 Cloudflare API 均支持列表:

  • 要从 Cloudflare 仪表板在表达式中使用列表,请参阅在表达式中使用列表。
  • 要在 API 表达式中引用列表,请参阅规则语言参考中的 Lists。

搜索列表项目

您可以在仪表板中或通过 API 搜索列表项目。

对于 IP 列表,Cloudflare 会返回以您的搜索查询开头的 IP 地址或范围。例如,搜索 192.0.2 会匹配 192.0.2.1 和 192.0.2.0/24,但搜索 192.0.2.100 不会匹配包含该地址的 CIDR 范围(如 192.0.2.0/24)。

对于批量重定向列表(Bulk Redirect Lists),Cloudflare 会返回源 URL 或目标 URL 包含您的搜索查询的条目。

可用性

列表可用性因列表类型以及您的 Cloudflare 套餐和订阅而异。

Free(免费) 专业版 (Pro) 商业版 (Business) Enterprise(企业)
可用性 是 是 是 是
自定义列表数量(任意类型) 1 10 10 1,000
列表项数量上限(所有自定义列表合计) 10,000 10,000 10,000 500,000
IP 列表 是 是 是 是
其他自定义列表(主机名、ASN) 否 否 否 是
托管 IP 列表 否 否 否 是

说明:

  • 可用 custom list 数量取决于账户中的最高计划。任何至少有一个付费计划的账户都将获得最高配额。

  • Enterprise 计划客户最多可跨不同 list 类型创建 1,000 个 custom list。以下额外限制适用:

    • 最多 40 个 hostname list,所有 hostname list 合计最多 10,000 个 list 项。
    • 最多 40 个 ASN list,所有 ASN list 合计最多 30,000 个 list 项。
  • Enterprise 计划客户如需更多 custom list 或更大的 list 项上限,可联系账户团队。

  • 有关 Bulk Redirect List 可用性的详情,请参阅 Rules 文档。


用户角色要求

以下用户角色可以访问列表管理功能:

  • 超级管理员
  • 管理员
  • 防火墙

最后说明

只有在没有任何规则(无论启用或禁用)引用列表时,才能删除该列表。

当您向现有列表添加项目时(手动或通过 CSV 文件),Cloudflare 将应用以下规则:

  • 在更新/添加项目之前,不会删除任何现有列表项目。
  • 更新列表中已有的项目。
  • 添加列表中尚未存在的项目。

要一次性替换列表的全部内容,请将数据格式化为数组,并使用 Lists API 中的 Update all list items 操作。

Cloudflare 仪表板不支持将列表下载为 CSV 文件。要导出列表内容,请使用 Get list items API 操作。

这篇文档对您有帮助吗?