Cloudflare Workers

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

Ein Worker vor Ihrer Website sortiert jeden Besucher: Menschen, echte Such-Crawler, KI-Crawler wie GPTBot und Bots über VPNs oder Rechenzentren.

Geschwindigkeit

Entschieden, bevor Ihr Besucher blinzelt.

Jede Prüfung antwortet in 50 bis 100 ms. Ihre Seiten und Anmeldungen warten nie darauf.

IPScanner-PrüfungMedian, an Ihrem Edge
~85 ms
Ein Lidschlagmenschliches Auge
300 ms
Ein schneller SeitenaufbauGoogles Grenze für „gut“
2,5 s

Kurz gesagt

Was es erkennt

KI-Crawler wie GPTBot und ClaudeBot, Scraper, gefälschte Googlebots und Bots über VPNs, Tor oder Rechenzentren. Menschen und echte Such-Crawler kommen durch.

Ohne Code

Auf Deploy to Cloudflare klicken, API-Schlüssel und Site-ID einfügen, eine Route anlegen. Etwa 10 Minuten.

Sie entscheiden pro Klasse

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.

Was es kostet

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.

Wer Ihre Daten sieht

Server in Dänemark (EU). Pro Besucher erhalten wir die IP-Adresse, den User-Agent und einige Request-Header. Sicherheit und Datenverarbeitung

Sie nutzen schon die KI-Bot-Einstellungen von Cloudflare?

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

In vier Schritten live

  1. 1

    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
  2. 2

    API-Schlüssel hinzufügen

    shell
    npx wrangler secret put IPSCANNER_API_KEY
  3. 3

    Website anlegen und SITE_ID setzen

    Legen Sie sie im Dashboard unter Websites an. Dort sehen Sie ihren Verkehr und ihre Richtlinie.

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

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

Einrichten und vergessen

Einmal deployen, der Worker übernimmt jede Anfrage

Richtlinienänderungen erreichen die Edge ohne neues Deployment, und wenn wir einmal langsam sind, geht die Anfrage unverändert durch.

Richtlinie aktualisiertLive an der Edge, ohne neues Deployment
Origin geschütztNur erlaubter Traffic kommt durch

So funktioniert es

Was bei jeder Anfrage passiert

  1. 1

    Der Worker liest IP, User-Agent und JA4 des Besuchers, sofern Cloudflare JA4 liefert.

  2. 2

    Agentscan und IP Detection laufen parallel, mit Cache pro Besucher, und lassen die Anfrage nach 1,5 Sekunden durch.

  3. 3

    Im Monitor-Modus gehen Urteils-Header an Ihren Ursprungsserver. Im Blockier-Modus bekommen blockierte Besucher zusätzlich ein 403.

  4. 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.

HeaderBeispiel
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

Einstellungen

Einstellungen

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

VariableStandard
MODEmonitor setzt Header, enforce blockiert zusätzlichmonitor
SITE_IDIhre Website-ID. Ist sie gesetzt, gilt die Richtlinie aus dem DashboardLeer
CHECK_AGENTFührt Agentscan austrue
CHECK_IPFührt IP Detection austrue
BLOCK_CLASSESAgentscan-Klassen, die im Enforce-Modus blockiert werdenmalicious_automation
BLOCK_ANONYMIZEDBlockiert im Enforce-Modus auch VPN, Proxy und Torfalse
TIMEOUT_MSPro Aufruf, danach geht die Anfrage durch1500
AGENT_TTLSekunden, die ein Agentscan-Urteil im Cache bleibt600
IP_TTLSekunden, die ein IP-Lookup im Cache bleibt3600
POLICY_TTLSekunden, die eine abgerufene Richtlinie gültig bleibt30
SKIP_PATHSPfad-Regex, bei der die Prüfung entfälltStatische Assets
ORIGIN_URLBackend als Ziel, wenn keine Route greiftLeer

Fragen

FAQ zum Cloudflare Worker

Ein Credit pro nicht gecachtem Besucher. Wiederholte Besuche innerhalb der Cache-TTL kosten nichts.

Starten Sie im Monitor-Modus

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

    Cloudflare Worker für Bot- und VPN-Prüfung | IPScanner