Cloudflare Workers

在 Cloudflare Worker 中检测机器人与 VPN

在您网站前部署一个 Worker,对每位访客分类:真人、真实的搜索引擎爬虫、GPTBot 等 AI 爬虫,以及通过 VPN 或数据中心访问的机器人。

速度

访客眨眼之前,判定已经完成。

每次检查在 50 到 100 毫秒内返回,您的页面和注册流程从不需要等待。

IPScanner 检查中位数,在您的边缘节点
约 85 毫秒
一次眨眼人眼
300 毫秒
一次快速页面加载Google 的“良好”标准
2.5 秒

简而言之

能识别什么

GPTBot、ClaudeBot 等 AI 爬虫、抓取程序、伪造的 Googlebot,以及通过 VPN、Tor 或数据中心访问的机器人。真人和真实的搜索引擎爬虫可以正常访问。

无需写代码

点击 Deploy to Cloudflare,粘贴 API 密钥和 Site ID,添加路由。大约 10 分钟。

按类别由您决定

每类访客可设为放行、标记或拦截。标记会放行访客并做记号,之后您可一键把该类别改为拦截。

费用

每月 10,000 次访客检查以内的监控不收费,无需绑卡。拦截使用预付额度:每次访客检查 1 额度,结果缓存 10 分钟,额度套餐 ¥148 起。开始时可免费领取 5,000 额度:需绑定银行卡,但在购买套餐前不会扣款,有效期 30 天。

谁能看到您的数据

服务器位于丹麦(欧盟)。对每位访客,我们接收 IP 地址、User-Agent 和少量请求头。安全与数据处理

已在使用 Cloudflare 的 AI 机器人设置?

可以继续使用。IPScanner 增加 VPN、Tor 和数据中心检查,在您拦截 Tor 和机器人脚本以外的流量之前,先展示每位访客。

快速上手

四步上线

  1. 1

    部署 Worker

    也可以使用上方的部署按钮。

    shell
    git clone https://github.com/ipscanner/ipscanner-cloudflare
    cd ipscanner-cloudflare
    npm install
    npx wrangler deploy
  2. 2

    添加 API 密钥

    shell
    npx wrangler secret put IPSCANNER_API_KEY
  3. 3

    创建站点并设置 SITE_ID

    在控制台的站点页面添加,可在那里查看其流量并管理策略。

    wrangler.jsonc
    "vars": {
      "SITE_ID": "site_4fQ8nZ2kLm7xR1vT9cBw"
    }
  4. 4

    将它置于网站之前

    使用自定义域名或 workers.dev 时,请改为将 ORIGIN_URL 设为您的后端地址。

    wrangler.jsonc
    "routes": [{
      "pattern": "example.com/*",
      "zone_name": "example.com"
    }]

部署后无需操心

部署一次,Worker 处理每个请求

策略变更无需重新部署即可到达边缘;如果我们偶尔变慢,请求会原样通过。

策略已更新已在边缘生效,无需重新部署
源站受保护只有被允许的流量能通过

工作原理

每个请求的处理过程

  1. 1

    Worker 读取访客的 IP、User-Agent,以及 Cloudflare 提供的 JA4。

  2. 2

    Agentscan 与 IP Detection 并行运行,按访客缓存,1.5 秒无响应即放行请求。

  3. 3

    monitor 模式向源服务器发送判定请求头。拦截模式还会对被拦截的访客返回 403。

  4. 4

    已验证的爬虫始终放行,客户端自行发送的 X-IPScanner-* 请求头会被移除。

请求头

源服务器收到的请求头

检查失败或被跳过时,仅设置 X-IPScanner-Status。

请求头示例
X-IPScanner-ClassAgentscanhuman
X-IPScanner-ActionAgentscanallow
X-IPScanner-ConfidenceAgentscan0.92
X-IPScanner-Network-ClassIP Detectionresidential_clean
X-IPScanner-Anonymized两者false
X-IPScanner-RiskIP Detection12
X-IPScanner-CountryIP DetectionDE
X-IPScanner-StatusWorkerok

配置

配置项

在 wrangler.jsonc 的 vars 块中设置。

变量默认值
MODEmonitor 添加请求头,enforce 还会拦截monitor
SITE_ID您的站点 id。设置后将应用控制台中的策略空
CHECK_AGENT运行 Agentscantrue
CHECK_IP运行 IP Detectiontrue
BLOCK_CLASSESenforce 模式下拦截的 Agentscan 类别malicious_automation
BLOCK_ANONYMIZEDenforce 模式下同时拦截 VPN、代理和 Torfalse
TIMEOUT_MS每次调用的时限,超时后放行请求1500
AGENT_TTLAgentscan 判定结果的缓存秒数600
IP_TTLIP 查询结果的缓存秒数3600
POLICY_TTL已获取策略的有效秒数30
SKIP_PATHS跳过检查的路径正则静态资源
ORIGIN_URL未配置路由时转发的后端地址空

常见问题

Cloudflare Worker 常见问题

每位未命中缓存的访客消耗 1 额度。缓存 TTL 内的重复访问不消耗额度。

从 monitor 模式开始

先观察一周请求头,再决定拦截什么。

    Cloudflare Worker 机器人与 VPN 检测 | IPScanner