Cloudflare Workers
Ein Worker vor Ihrer Website sortiert jeden Besucher: Menschen, echte Such-Crawler, KI-Crawler wie GPTBot und Bots über VPNs oder Rechenzentren.
Geschwindigkeit
Jede Prüfung antwortet in 50 bis 100 ms. Ihre Seiten und Anmeldungen warten nie darauf.
KI-Crawler wie GPTBot und ClaudeBot, Scraper, gefälschte Googlebots und Bots über VPNs, Tor oder Rechenzentren. Menschen und echte Such-Crawler kommen durch.
Auf Deploy to Cloudflare klicken, API-Schlüssel und Site-ID einfügen, eine Route anlegen. Etwa 10 Minuten.
Jede Art von Besucher steht auf Zulassen, Markieren oder Blockieren. Markieren lässt den Besucher durch und kennzeichnet ihn, damit Sie die Klasse später mit einem Klick blockieren können.
Das Monitoring kostet bis 10.000 Besucherprüfungen pro Monat nichts, ohne Karte. Blockieren läuft über Prepaid-Credits: 1 pro Besucherprüfung, 10 Minuten zwischengespeichert, Pakete ab 19,99 €. Die 5.000 Gratis-Credits zum Start brauchen eine Karte (abgebucht wird erst, wenn Sie ein Paket kaufen) und gelten 30 Tage.
Server in Dänemark (EU). Pro Besucher erhalten wir die IP-Adresse, den User-Agent und einige Request-Header. Sicherheit und Datenverarbeitung
Behalten Sie sie. IPScanner ergänzt VPN-, Tor- und Rechenzentrums-Prüfungen und zeigt jeden Besucher, bevor Sie mehr als Tor und Bot-Skripte blockieren.
Einrichtung
Oder nutzen Sie den Button oben.
git clone https://github.com/ipscanner/ipscanner-cloudflare
cd ipscanner-cloudflare
npm install
npx wrangler deploynpx wrangler secret put IPSCANNER_API_KEYLegen Sie sie im Dashboard unter Websites an. Dort sehen Sie ihren Verkehr und ihre Richtlinie.
"vars": {
"SITE_ID": "site_4fQ8nZ2kLm7xR1vT9cBw"
}Auf einer eigenen Domain oder workers.dev setzen Sie stattdessen ORIGIN_URL auf Ihr Backend.
"routes": [{
"pattern": "example.com/*",
"zone_name": "example.com"
}]Einrichten und vergessen
Richtlinienänderungen erreichen die Edge ohne neues Deployment, und wenn wir einmal langsam sind, geht die Anfrage unverändert durch.

So funktioniert es
Der Worker liest IP, User-Agent und JA4 des Besuchers, sofern Cloudflare JA4 liefert.
Agentscan und IP Detection laufen parallel, mit Cache pro Besucher, und lassen die Anfrage nach 1,5 Sekunden durch.
Im Monitor-Modus gehen Urteils-Header an Ihren Ursprungsserver. Im Blockier-Modus bekommen blockierte Besucher zusätzlich ein 403.
Verifizierte Crawler kommen immer durch, und vom Client gesendete X-IPScanner-*-Header werden entfernt.
Header
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 |
| SITE_IDIhre Website-ID. Ist sie gesetzt, gilt die Richtlinie aus dem Dashboard | Leer | Ihre Website-ID. Ist sie gesetzt, gilt die Richtlinie aus dem Dashboard |
| 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 |
| POLICY_TTLSekunden, die eine abgerufene Richtlinie gültig bleibt | 30 | Sekunden, die eine abgerufene Richtlinie gültig 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
Beobachten Sie die Header eine Woche lang, bevor Sie etwas blockieren.