跳转到内容
搜索文档

Cloudflare 过滤器 API

最后更新 查看 MarkdownAgent 设置

Cloudflare 过滤器 (Filters) 是防火墙规则的仅限 API 组件,用于设计复杂的条件,这些条件依赖于布尔运算符和其他逻辑来检查传入的 HTTP 流量并寻找匹配项。

例如,一个匹配以下内容的过滤器:

  • HTTP 用户代理 (user agent),并且
  • HTTP 路径,并且
  • 源 IP 地址

将过滤器与防火墙规则关联,以定义该规则的作用域。

在过滤器中使用 IP 列表,以统指一组 IP 地址。有关更多信息,请参考 列表 API (Lists API)

在开始使用 Cloudflare 过滤器 API 之前,请先熟悉规则 表达式。有关完整参考,请参考 规则语言 (Rules language)

与其他 Cloudflare API 的差异

防火墙规则 API 在以下两个方面与大多数 Cloudflare API 的行为不同:

  • API 调用接受并返回多个项目,并允许将数据更改应用于多个项目。
  • 尽管 API 调用返回 标准响应,但错误对象遵循 JSON API 标准,这样在出现错误情况时,就能清楚地知道是哪个项目产生了错误以及原因。

要开始使用,请查阅 什么是过滤器?,然后是 Cloudflare 过滤器 JSON 对象端点 (Endpoints)

这篇文档对您有帮助吗?