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 分鐘,額度套裝 HK$158 起。開始時可免費領取 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