Cloudflare 过滤器 (Filters) 是防火墙规则的仅限 API 组件,用于设计复杂的条件,这些条件依赖于布尔运算符和其他逻辑来检查传入的 HTTP 流量并寻找匹配项。
例如,一个匹配以下内容的过滤器:
- HTTP 用户代理 (user agent),并且
- HTTP 路径,并且
- 源 IP 地址
将过滤器与防火墙规则关联,以定义该规则的作用域。
在过滤器中使用 IP 列表,以统指一组 IP 地址。有关更多信息,请参考 列表 API (Lists API)。
在开始使用 Cloudflare 过滤器 API 之前,请先熟悉规则 表达式。有关完整参考,请参考 规则语言 (Rules language)。
防火墙规则 API 在以下两个方面与大多数 Cloudflare API 的行为不同:
- API 调用接受并返回多个项目,并允许将数据更改应用于多个项目。
- 尽管 API 调用返回 标准响应,但错误对象遵循 JSON API 标准 ↗,这样在出现错误情况时,就能清楚地知道是哪个项目产生了错误以及原因。
要开始使用,请查阅 什么是过滤器?,然后是 Cloudflare 过滤器 JSON 对象 和 端点 (Endpoints)。