Cloudflare Workers

Bot- en VPN-checks in een Cloudflare Worker

Eén Worker voor je site sorteert elke bezoeker: mensen, echte zoekcrawlers, AI-crawlers zoals GPTBot en bots via VPN's of datacenters.

Snelheid

Beslist voordat je bezoeker knippert.

Elke check antwoordt binnen 50 tot 100 ms, dus je pagina’s en aanmeldingen wachten er nooit op.

IPScanner-checkmediaan, aan je edge
~85 ms
Een knipperingmenselijk oog
300 ms
Een snelle paginaladingGoogles grens voor ‘goed’
2,5 s

Kort gezegd

Wat het herkent

AI-crawlers zoals GPTBot en ClaudeBot, scrapers, nep-Googlebots en bots via VPN's, Tor of datacenters. Mensen en echte zoekcrawlers komen erdoor.

Zonder code

Klik op Deploy to Cloudflare, plak je API-sleutel en Site ID, voeg een route toe. Ongeveer 10 minuten.

Jij beslist per klasse

Elk soort bezoeker staat op Toestaan, Markeren of Blokkeren. Markeren laat de bezoeker door en markeert hem, zodat je die klasse later met één klik blokkeert.

Wat het kost

Monitoren kost niets tot 10.000 bezoekerschecks per maand, zonder kaart. Blokkeren werkt met prepaid credits: 1 per bezoekerscheck, 10 minuten bewaard, packs vanaf € 19,99. Voor de 5.000 gratis credits om te starten is een kaart nodig (er wordt pas iets afgeschreven als je een pack koopt) en ze zijn 30 dagen geldig.

Wie je gegevens ziet

Servers in Denemarken (EU). Per bezoeker ontvangen we het IP-adres, de user agent en een paar request headers. Beveiliging en gegevensverwerking

Gebruik je al de AI-botinstellingen van Cloudflare?

Houd ze aan. IPScanner voegt VPN-, Tor- en datacentercontroles toe en toont elke bezoeker voordat je meer blokkeert dan Tor en botscripts.

Installatie

Live in vier stappen

  1. 1

    Deploy de Worker

    Of gebruik de Deploy-knop hierboven.

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

    Voeg je API-sleutel toe

    shell
    npx wrangler secret put IPSCANNER_API_KEY
  3. 3

    Maak een site aan en zet SITE_ID

    Voeg hem toe onder Sites in je dashboard. Daar zie je het verkeer en staat het beleid.

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

    Zet hem vóór je site

    Op een eigen domein of workers.dev zet je ORIGIN_URL in plaats daarvan op je backend.

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

Instellen en vergeten

Eén keer deployen, de Worker doet elk request

Policywijzigingen bereiken de edge zonder redeploy, en als wij ooit traag zijn, gaat het request onaangeroerd door.

Policy bijgewerktLive op de edge, zonder redeploy
Origin beschermdAlleen toegestaan verkeer komt erdoor

Zo werkt het

Wat er bij elk verzoek gebeurt

  1. 1

    De Worker leest het IP, de User-Agent en JA4 van de bezoeker, als Cloudflare JA4 levert.

  2. 2

    Agentscan en IP Detection draaien parallel, met cache per bezoeker, en laten het verzoek na 1,5 seconde door.

  3. 3

    In monitor-modus gaan oordeel-headers naar je originserver. In de modus Blokkeren krijgt een geblokkeerde bezoeker ook een 403.

  4. 4

    Geverifieerde crawlers komen altijd door, en X-IPScanner-*-headers die de client meestuurt, worden verwijderd.

Headers

Headers die je originserver ontvangt

Als een check mislukt of wordt overgeslagen, is alleen X-IPScanner-Status gezet.

HeaderVoorbeeld
X-IPScanner-ClassAgentscanhuman
X-IPScanner-ActionAgentscanallow
X-IPScanner-ConfidenceAgentscan0.92
X-IPScanner-Network-ClassIP Detectionresidential_clean
X-IPScanner-AnonymizedBeidefalse
X-IPScanner-RiskIP Detection12
X-IPScanner-CountryIP DetectionDE
X-IPScanner-StatusWorkerok

Instellingen

Instellingen

Stel deze in via het vars-blok van wrangler.jsonc.

VariabeleStandaard
MODEmonitor zet headers, enforce blokkeert ookmonitor
SITE_IDJe site-id. Zet hem en het beleid uit het dashboard geldtLeeg
CHECK_AGENTVoert Agentscan uittrue
CHECK_IPVoert IP Detection uittrue
BLOCK_CLASSESAgentscan-klassen die enforce-modus blokkeertmalicious_automation
BLOCK_ANONYMIZEDBlokkeert in enforce-modus ook VPN, proxy en Torfalse
TIMEOUT_MSPer aanroep, daarna gaat het verzoek door1500
AGENT_TTLSeconden dat een Agentscan-oordeel in de cache blijft600
IP_TTLSeconden dat een IP-lookup in de cache blijft3600
POLICY_TTLSeconden dat een opgehaald beleid geldig blijft30
SKIP_PATHSPad-regex die de check overslaatStatische assets
ORIGIN_URLBackend om naar door te sturen zonder routeLeeg

Vragen

FAQ over de Cloudflare Worker

Eén credit voor elke bezoeker die niet in de cache staat. Herhaalbezoeken binnen de cache-TTL kosten niets.

Begin in monitor-modus

Bekijk de headers een week voordat je iets blokkeert.

    Cloudflare Worker voor bot- en VPN-checks | IPScanner