Was passiert, wenn die IPScanner API ausfällt?

Der Worker lässt die Anfrage durch: nach 1,5 Sekunden oder bei einem Fehler, mit X-IPScanner-Status auf timeout oder error.

Blockiert er Googlebot?

Nein. Suchmaschinen und KI-Crawler, die Agentscan verifiziert, kommen immer durch, auch im Enforce-Modus.

Funktioniert er mit kostenlosen Tarifen?

Ja. Er läuft im kostenlosen Tarif von Cloudflare Workers, und der kostenlose IPScanner-Tarif enthält 30.000 Anfragen pro Monat.

IPScanner

Cloudflare Workers

Bot- und VPN-Prüfung in einem Cloudflare Worker

Ein Worker vor Ihrer Website prüft jeden Besucher und meldet Ihrem Ursprungsserver das Ergebnis.

Auf Cloudflare bereitstellen Auf GitHub ansehen

Besucher203.0.113.24

IPScanner WorkerCloudflare Edge

Ihr Ursprungsserver

X-IPScanner-Classhuman
X-IPScanner-Actionallow

Einrichtung

In drei Schritten live

Worker bereitstellen

Oder nutzen Sie den Button oben.

shell

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

API-Schlüssel hinzufügen

shell

npx wrangler secret put IPSCANNER_API_KEY

3
Vor Ihre Website schalten
Auf einer eigenen Domain oder workers.dev setzen Sie stattdessen ORIGIN_URL auf Ihr Backend.
wrangler.jsonc
```
"routes": [{
  "pattern": "example.com/*",
  "zone_name": "example.com"
}]
```

So funktioniert es

Was bei jeder Anfrage passiert

1
Der Worker liest IP, User-Agent und JA4 des Besuchers, sofern Cloudflare JA4 liefert.
2
Agentscan und IP Detection laufen parallel, mit Cache pro Besucher, und lassen die Anfrage nach 1,5 Sekunden durch.
3
Im Monitor-Modus gehen Urteils-Header an Ihren Ursprungsserver. Im Enforce-Modus bekommen blockierte Besucher zusätzlich ein 403.
4
Verifizierte Crawler kommen immer durch, und vom Client gesendete X-IPScanner-*-Header werden entfernt.

Header

Header, die Ihr Ursprungsserver erhält

Schlägt eine Prüfung fehl oder wird sie übersprungen, ist nur X-IPScanner-Status gesetzt.

Header	Quelle	Beispiel
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

Einstellungen

Legen Sie diese im vars-Block von wrangler.jsonc fest.

Variable	Standard	Wirkung
MODEmonitor setzt Header, enforce blockiert zusätzlich	monitor	monitor setzt Header, enforce blockiert zusätzlich
CHECK_AGENTFührt Agentscan aus	true	Führt Agentscan aus
CHECK_IPFührt IP Detection aus	true	Führt IP Detection aus
BLOCK_CLASSESAgentscan-Klassen, die im Enforce-Modus blockiert werden	malicious_automation	Agentscan-Klassen, die im Enforce-Modus blockiert werden
BLOCK_ANONYMIZEDBlockiert im Enforce-Modus auch VPN, Proxy und Tor	false	Blockiert im Enforce-Modus auch VPN, Proxy und Tor
TIMEOUT_MSPro Aufruf, danach geht die Anfrage durch	1500	Pro Aufruf, danach geht die Anfrage durch
AGENT_TTLSekunden, die ein Agentscan-Urteil im Cache bleibt	600	Sekunden, die ein Agentscan-Urteil im Cache bleibt
IP_TTLSekunden, die ein IP-Lookup im Cache bleibt	3600	Sekunden, die ein IP-Lookup im Cache bleibt
SKIP_PATHSPfad-Regex, bei der die Prüfung entfällt	Statische Assets	Pfad-Regex, bei der die Prüfung entfällt
ORIGIN_URLBackend als Ziel, wenn keine Route greift	Leer	Backend als Ziel, wenn keine Route greift

Fragen

FAQ zum Cloudflare Worker

Eine Anfrage pro aktiver Prüfung und nicht gecachtem Besucher, mit beiden Prüfungen also zwei. Wiederholte Besuche innerhalb der Cache-TTL kosten nichts.

Starten Sie im Monitor-Modus

Beobachten Sie die Header eine Woche lang, bevor Sie etwas blockieren.

Kostenlosen API-Schlüssel erstellen