Cloudflare Workers
在您网站前部署一个 Worker,对每位访客分类:真人、真实的搜索引擎爬虫、GPTBot 等 AI 爬虫,以及通过 VPN 或数据中心访问的机器人。
速度
每次检查在 50 到 100 毫秒内返回,您的页面和注册流程从不需要等待。
GPTBot、ClaudeBot 等 AI 爬虫、抓取程序、伪造的 Googlebot,以及通过 VPN、Tor 或数据中心访问的机器人。真人和真实的搜索引擎爬虫可以正常访问。
点击 Deploy to Cloudflare,粘贴 API 密钥和 Site ID,添加路由。大约 10 分钟。
每类访客可设为放行、标记或拦截。标记会放行访客并做记号,之后您可一键把该类别改为拦截。
每月 10,000 次访客检查以内的监控不收费,无需绑卡。拦截使用预付额度:每次访客检查 1 额度,结果缓存 10 分钟,额度套餐 ¥148 起。开始时可免费领取 5,000 额度:需绑定银行卡,但在购买套餐前不会扣款,有效期 30 天。
服务器位于丹麦(欧盟)。对每位访客,我们接收 IP 地址、User-Agent 和少量请求头。安全与数据处理
可以继续使用。IPScanner 增加 VPN、Tor 和数据中心检查,在您拦截 Tor 和机器人脚本以外的流量之前,先展示每位访客。
快速上手
也可以使用上方的部署按钮。
git clone https://github.com/ipscanner/ipscanner-cloudflare
cd ipscanner-cloudflare
npm install
npx wrangler deploynpx wrangler secret put IPSCANNER_API_KEY在控制台的站点页面添加,可在那里查看其流量并管理策略。
"vars": {
"SITE_ID": "site_4fQ8nZ2kLm7xR1vT9cBw"
}使用自定义域名或 workers.dev 时,请改为将 ORIGIN_URL 设为您的后端地址。
"routes": [{
"pattern": "example.com/*",
"zone_name": "example.com"
}]
工作原理
Worker 读取访客的 IP、User-Agent,以及 Cloudflare 提供的 JA4。
Agentscan 与 IP Detection 并行运行,按访客缓存,1.5 秒无响应即放行请求。
monitor 模式向源服务器发送判定请求头。拦截模式还会对被拦截的访客返回 403。
已验证的爬虫始终放行,客户端自行发送的 X-IPScanner-* 请求头会被移除。
请求头
检查失败或被跳过时,仅设置 X-IPScanner-Status。
| 请求头 | 来源 | 示例 |
|---|---|---|
| X-IPScanner-ClassAgentscan | Agentscan | human |
| X-IPScanner-ActionAgentscan | Agentscan | allow |
| X-IPScanner-ConfidenceAgentscan | Agentscan | 0.92 |
| X-IPScanner-Network-ClassIP Detection | IP Detection | residential_clean |
| X-IPScanner-Anonymized两者 | 两者 | false |
| X-IPScanner-RiskIP Detection | IP Detection | 12 |
| X-IPScanner-CountryIP Detection | IP Detection | DE |
| X-IPScanner-StatusWorker | Worker | ok |
配置
在 wrangler.jsonc 的 vars 块中设置。
| 变量 | 默认值 | 作用 |
|---|---|---|
| MODEmonitor 添加请求头,enforce 还会拦截 | monitor | monitor 添加请求头,enforce 还会拦截 |
| SITE_ID您的站点 id。设置后将应用控制台中的策略 | 空 | 您的站点 id。设置后将应用控制台中的策略 |
| CHECK_AGENT运行 Agentscan | true | 运行 Agentscan |
| CHECK_IP运行 IP Detection | true | 运行 IP Detection |
| BLOCK_CLASSESenforce 模式下拦截的 Agentscan 类别 | malicious_automation | enforce 模式下拦截的 Agentscan 类别 |
| BLOCK_ANONYMIZEDenforce 模式下同时拦截 VPN、代理和 Tor | false | enforce 模式下同时拦截 VPN、代理和 Tor |
| TIMEOUT_MS每次调用的时限,超时后放行请求 | 1500 | 每次调用的时限,超时后放行请求 |
| AGENT_TTLAgentscan 判定结果的缓存秒数 | 600 | Agentscan 判定结果的缓存秒数 |
| IP_TTLIP 查询结果的缓存秒数 | 3600 | IP 查询结果的缓存秒数 |
| POLICY_TTL已获取策略的有效秒数 | 30 | 已获取策略的有效秒数 |
| SKIP_PATHS跳过检查的路径正则 | 静态资源 | 跳过检查的路径正则 |
| ORIGIN_URL未配置路由时转发的后端地址 | 空 | 未配置路由时转发的后端地址 |
常见问题