Precursor 是一种基于会话的客户端验证系统。它会持续评估访问者行为,而不是依赖单次质询(Challenge)事件。这有助于检测在单个请求中看似合法、但在整个会话中表现出非人类模式的自动化。
Precursor 作为持续的客户端验证循环运行:
- 将客户端脚本注入页面
- 脚本持续收集信号并执行验证
- 每次执行产生由 Cloudflare 评估的信号
- 在 Armed 模式下,结果可更新存储在
cf_clearancecookie 中的会话状态 - 该过程在整个会话中重复进行
这使得 Cloudflare 能够随着时间的推移持续评估会话行为。
所选模式控制 Precursor 如何使用其信号:
| 模式 | 行为 |
|---|---|
| Off | Precursor 不运行。 |
| Monitor | Precursor 收集信号。其信号不会改变机器人分数(bot score)或质询 clearance。 |
| Armed | Precursor 信号可影响机器人分数和质询 clearance。 |
Precursor Interstitial 是在访问者继续访问站点之前显示的轻量级质询。它会建立已验证的 Precursor 会话,并在访问者尚无 clearance 时授予质询 clearance。
为你的 zone 配置 Precursor:
-
在 Cloudflare 仪表板中,选择你的 zone,然后前往 Security(安全性) > Settings(设置)。
前往 Settings(设置) ↗ -
按 Bot traffic 或 Precursor 筛选,以找到 Precursor。
-
从 Status(状态) 下拉菜单中选择 Monitor 或 Arm。
-
在 Precursor 卡片中,选择设置图标,以设置全站默认的 Precursor Interstitial 行为。Precursor 为 Off 时,此设置不可用。
-
Show Interstitial On(显示 Interstitial):当访问者没有已验证会话时,显示插页式质询。这会在访问者继续之前建立有效会话,但可能增加摩擦。
-
Show Interstitial Off(不显示 Interstitial):在后台建立会话状态。这可减少中断,但无法保证每个会话都经过完全验证。
-
添加 Interstitial Rules(Interstitial 规则),针对特定请求自定义全站插页默认行为。例如,站点大部分页面不显示插页式质询,但在
/checkout上要求显示,以便在购买前强制建立有效会话。
-
如果你的 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 模式继续评估。
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 的检测结果。
有关更多信息,请参考 安全分析。