Wat als de IPScanner API niet bereikbaar is?

De Worker laat het verzoek door: na 1,5 seconde of bij een fout, met X-IPScanner-Status op timeout of error.

Blokkeert hij Googlebot?

Nee. Zoekmachines en AI-crawlers die Agentscan verifieert, komen altijd door, ook in enforce-modus.

Werkt hij met gratis abonnementen?

Ja. Hij draait op het gratis abonnement van Cloudflare Workers, en het gratis IPScanner-abonnement bevat 30.000 verzoeken per maand.

IPScanner

Cloudflare Workers

Bot- en VPN-checks in een Cloudflare Worker

Eén Worker vóór je site checkt elke bezoeker en vertelt je originserver wat hij vond.

Deployen naar Cloudflare Bekijken op GitHub

Bezoeker203.0.113.24

IPScanner WorkerCloudflare-edge

Je originserver

X-IPScanner-Classhuman
X-IPScanner-Actionallow

Installatie

Live in drie stappen

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

Voeg je API-sleutel toe

shell

npx wrangler secret put IPSCANNER_API_KEY

3
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"
}]
```

Zo werkt het

Wat er bij elk verzoek gebeurt

1
De Worker leest het IP, de User-Agent en JA4 van de bezoeker, als Cloudflare JA4 levert.
2
Agentscan en IP Detection draaien parallel, met cache per bezoeker, en laten het verzoek na 1,5 seconde door.
3
In monitor-modus gaan oordeel-headers naar je originserver. In enforce-modus krijgt een geblokkeerde bezoeker ook een 403.
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.

Header	Bron	Voorbeeld
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-AnonymizedBeide	Beide	false
X-IPScanner-RiskIP Detection	IP Detection	12
X-IPScanner-CountryIP Detection	IP Detection	DE
X-IPScanner-StatusWorker	Worker	ok

Instellingen

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

Variabele	Standaard	Wat het doet
MODEmonitor zet headers, enforce blokkeert ook	monitor	monitor zet headers, enforce blokkeert ook
CHECK_AGENTVoert Agentscan uit	true	Voert Agentscan uit
CHECK_IPVoert IP Detection uit	true	Voert IP Detection uit
BLOCK_CLASSESAgentscan-klassen die enforce-modus blokkeert	malicious_automation	Agentscan-klassen die enforce-modus blokkeert
BLOCK_ANONYMIZEDBlokkeert in enforce-modus ook VPN, proxy en Tor	false	Blokkeert in enforce-modus ook VPN, proxy en Tor
TIMEOUT_MSPer aanroep, daarna gaat het verzoek door	1500	Per aanroep, daarna gaat het verzoek door
AGENT_TTLSeconden dat een Agentscan-oordeel in de cache blijft	600	Seconden dat een Agentscan-oordeel in de cache blijft
IP_TTLSeconden dat een IP-lookup in de cache blijft	3600	Seconden dat een IP-lookup in de cache blijft
SKIP_PATHSPad-regex die de check overslaat	Statische assets	Pad-regex die de check overslaat
ORIGIN_URLBackend om naar door te sturen zonder route	Leeg	Backend om naar door te sturen zonder route

Vragen

FAQ over de Cloudflare Worker

Eén verzoek per ingeschakelde check voor elke bezoeker die niet in de cache staat, dus twee met beide checks aan. Herhaalbezoeken binnen de cache-TTL kosten niets.

Begin in monitor-modus

Bekijk de headers een week voordat je iets blokkeert.

Maak een gratis API-sleutel aan