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

Precursor

最后更新 查看 MarkdownAgent 设置

Precursor 是一种基于会话的客户端验证系统。它会持续评估访问者行为,而不是依赖单次质询(Challenge)事件。这有助于检测在单个请求中看似合法、但在整个会话中表现出非人类模式的自动化。

工作原理

Precursor 作为持续的客户端验证循环运行:

  • 将客户端脚本注入页面
  • 脚本持续收集信号并执行验证
  • 每次执行产生由 Cloudflare 评估的信号
  • 在 Armed 模式下,结果可更新存储在 cf_clearance cookie 中的会话状态
  • 该过程在整个会话中重复进行

这使得 Cloudflare 能够随着时间的推移持续评估会话行为。

Precursor 模式

所选模式控制 Precursor 如何使用其信号:

模式 行为
Off Precursor 不运行。
Monitor Precursor 收集信号。其信号不会改变机器人分数(bot score)或质询 clearance。
Armed Precursor 信号可影响机器人分数和质询 clearance。

Precursor Interstitial

Precursor Interstitial 是在访问者继续访问站点之前显示的轻量级质询。它会建立已验证的 Precursor 会话,并在访问者尚无 clearance 时授予质询 clearance。

开始使用

为你的 zone 配置 Precursor:

  1. 在 Cloudflare 仪表板中,选择你的 zone,然后前往 Security(安全性) > Settings(设置)。

    前往 Settings(设置) ↗
  2. 按 Bot traffic 或 Precursor 筛选,以找到 Precursor。

  3. 从 Status(状态) 下拉菜单中选择 Monitor 或 Arm。

  4. 在 Precursor 卡片中,选择设置图标,以设置全站默认的 Precursor Interstitial 行为。Precursor 为 Off 时,此设置不可用。

    • Show Interstitial On(显示 Interstitial):当访问者没有已验证会话时,显示插页式质询。这会在访问者继续之前建立有效会话,但可能增加摩擦。

    • Show Interstitial Off(不显示 Interstitial):在后台建立会话状态。这可减少中断,但无法保证每个会话都经过完全验证。

    • 添加 Interstitial Rules(Interstitial 规则),针对特定请求自定义全站插页默认行为。例如,站点大部分页面不显示插页式质询,但在 /checkout 上要求显示,以便在购买前强制建立有效会话。

将 Precursor 与 API 结合使用

如果你的 zone 同时服务浏览器页面和 API 端点,请使用 Interstitial Rules 针对 API 流量自定义全站 Show Interstitial 默认值。Monitor 和 Armed 模式下均可使用此设置。

当 Show Interstitial 开启时,没有已验证 Precursor 会话的访问者必须先完成插页式质询才能继续。这可能会影响:

  • 非浏览器客户端调用的 API 端点(例如 curl、移动端后端、服务器到服务器的作业)
  • 不发送 cookie 的浏览器 API 调用

对于混合的浏览器/API 流量,请使用以下模式之一:

  • 默认关闭 Show Interstitial,然后通过 Interstitial Rules 在敏感的浏览器页面或路径(例如 /checkout)上要求显示。
  • 默认开启 Show Interstitial,然后通过 Interstitial Rules 为 API 主机名或路径关闭它。

对于会显示插页式质询的端点上的浏览器 XHR/fetch 请求,请确保包含 cookie:

fetch("/api/search", {
	credentials: "include",
});
axios.get("/api/search", {
	withCredentials: true,
});

为 API 端点关闭 Interstitial 并不会关闭浏览器页面上的 Precursor。浏览器会话仍会按所选 Precursor 模式继续评估。

与 JavaScript 检测的关系

Precursor 取代了 JavaScript 检测(JSD)。两者都会收集客户端信号,但 Precursor 会在整个会话中持续评估,而不是只检查一次。

  • Precursor 从一次性执行转变为持续验证
  • Precursor 引入了基于会话的状态
  • Precursor 实现了动态运行时控制

当 JSD 或 Precursor 对机器人分数有贡献时,Cloudflare 会将该来源显示为 JavaScript Fingerprinting。在 Monitor 模式下,Precursor 信号不会贡献到机器人分数。

如果你已使用 JSD

在 Armed 模式下,Cloudflare 会禁用 JSD,以避免在同一流量上同时运行这两项功能。Precursor 包含原先由 JSD 覆盖的检测,由 JSD 驱动的 Security Rules 仍然适用。

在 Monitor 模式下,Cloudflare 会继续运行 JSD,因此你在测试 Precursor 时不会出现覆盖缺口。

如果你未使用 JSD

如果你在从未使用过 JSD 的情况下使用 Armed 模式,可能会看到更多机器人分数低于 30 的流量。

与质询的关系

Precursor 和 Challenges 扮演着不同的角色:

  • Challenges 提供时间点(point-in-time)验证
  • Precursor 提供持续的、会话级别的验证

在 Armed 模式下,Precursor 可通过以下方式强化 Challenges:

  • 确定何时需要额外的质询
  • 在访问者已经通过质询后重新评估他们
  • 识别随着时间的推移而出现的自动化

Precursor 与 cf_clearance 紧密集成。在 Armed 模式下:

  • 有效 clearance 可能会减少或失效
  • 可能会触发额外的质询
  • 访问者可能在同一会话期间被重新验证

安全分析中的可见性

一旦 Precursor 在一个 zone 上运行,它的检测结果就会出现在该 zone 的分析视图中。要打开它,请在 Cloudflare 仪表板中选择你的 zone,然后前往 Security(安全性) > Analytics(分析) > Traffic(流量) > Bot analysis(机器人分析)。机器人分数的分布和 WAF 规则匹配计数现在包括 Precursor 的检测结果。

有关更多信息,请参考 安全分析。

这篇文档对您有帮助吗?