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 分鐘,額度套裝 HK$158 起。開始時可免費領取 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未設定路由時轉發的後端位址 | 空白 | 未設定路由時轉發的後端位址 |
常見問題