IPScanner

Cloudflare Workers

Détection des bots et VPN dans un Cloudflare Worker

Un Worker devant votre site trie chaque visiteur : les personnes, les vrais robots de recherche, les robots d'IA comme GPTBot et les bots passant par des VPN ou des data centers.

Vitesse

Décidé avant que votre visiteur ne cligne des yeux.

Chaque vérification répond en 50 à 100 ms : vos pages et vos inscriptions ne l’attendent jamais.

Vérification IPScannermédiane, en périphérie
~85 ms
Un clignement d’œilœil humain
300 ms
Un chargement de page rapideseuil « bon » de Google
2,5 s

En bref

Ce qu'il repère

Les robots d'IA comme GPTBot et ClaudeBot, les scrapers, les faux Googlebots et les bots passant par des VPN, Tor ou des data centers. Les personnes et les vrais robots de recherche passent.

Sans code

Cliquez sur Deploy to Cloudflare, collez votre clé API et votre Site ID, ajoutez une route. Environ 10 minutes.

Vous décidez par catégorie

Chaque type de visiteur est réglé sur Autoriser, Signaler ou Bloquer. Signaler le laisse passer et le marque, pour que vous puissiez bloquer cette catégorie plus tard en un clic.

Ce que ça coûte

La surveillance ne coûte rien jusqu’à 10 000 vérifications de visiteurs par mois, sans carte. Le blocage utilise des crédits prépayés : 1 par vérification de visiteur, gardée en cache 10 minutes, packs dès 19,99 €. Les 5 000 crédits offerts pour démarrer demandent une carte (aucun débit avant l’achat d’un pack) et sont valables 30 jours.

Qui voit vos données

Serveurs au Danemark (UE). Pour chaque visiteur, nous recevons l'adresse IP, le user agent et quelques en-têtes de requête. Sécurité et traitement des données

Vous utilisez déjà les réglages anti-robots IA de Cloudflare ?

Gardez-les. IPScanner ajoute les contrôles VPN, Tor et data center et montre chaque visiteur avant que vous ne bloquiez autre chose que Tor et les scripts de bots.

Installation

En ligne en quatre étapes

  1. 1

    Déployer le Worker

    Ou utilisez le bouton de déploiement ci-dessus.

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

    Ajouter votre clé API

    shell
    npx wrangler secret put IPSCANNER_API_KEY
  3. 3

    Créer un site et définir SITE_ID

    Ajoutez-le sous Sites dans votre tableau de bord, qui affiche son trafic et conserve sa politique.

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

    Le placer devant votre site

    Sur un domaine personnalisé ou workers.dev, faites plutôt pointer ORIGIN_URL vers votre backend.

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

Installez et oubliez

Déployez une fois, le Worker traite chaque requête

Les changements de politique atteignent l'edge sans redéploiement, et si nous sommes un jour lents, la requête passe intacte.

Politique mise à jourActive à l'edge, sans redéploiement
Origine protégéeSeul le trafic autorisé passe

Fonctionnement

Ce qui se passe à chaque requête

  1. 1

    Le Worker lit l'IP, le User-Agent et le JA4 du visiteur, quand Cloudflare le fournit.

  2. 2

    Agentscan et IP Detection tournent en parallèle, avec un cache par visiteur, et laissent passer la requête après 1,5 seconde.

  3. 3

    Le mode monitor envoie les en-têtes de verdict à votre serveur d'origine. Le mode Blocage répond en plus par un 403 au visiteur bloqué.

  4. 4

    Les crawlers vérifiés passent toujours, et les en-têtes X-IPScanner-* envoyés par le client sont supprimés.

En-têtes

Les en-têtes reçus par votre serveur d'origine

Si une vérification échoue ou est ignorée, seul X-IPScanner-Status est défini.

En-têteExemple
X-IPScanner-ClassAgentscanhuman
X-IPScanner-ActionAgentscanallow
X-IPScanner-ConfidenceAgentscan0.92
X-IPScanner-Network-ClassIP Detectionresidential_clean
X-IPScanner-AnonymizedLes deuxfalse
X-IPScanner-RiskIP Detection12
X-IPScanner-CountryIP DetectionDE
X-IPScanner-StatusWorkerok

Réglages

Réglages

Définissez-les dans le bloc vars de wrangler.jsonc.

VariablePar défaut
MODEmonitor ajoute les en-têtes, enforce bloque aussimonitor
SITE_IDL'id de votre site. S'il est défini, la politique du tableau de bord s'appliqueVide
CHECK_AGENTLance Agentscantrue
CHECK_IPLance IP Detectiontrue
BLOCK_CLASSESClasses Agentscan à bloquer en mode enforcemalicious_automation
BLOCK_ANONYMIZEDBloque aussi VPN, proxy et Tor en mode enforcefalse
TIMEOUT_MSPar appel, ensuite la requête passe1500
AGENT_TTLSecondes de cache pour un verdict Agentscan600
IP_TTLSecondes de cache pour une recherche IP3600
POLICY_TTLSecondes de validité d'une politique récupérée30
SKIP_PATHSRegex des chemins exclus du contrôleRessources statiques
ORIGIN_URLBackend de destination hors routeVide

Questions

FAQ du Cloudflare Worker

Un crédit pour chaque visiteur absent du cache. Les visites répétées pendant le TTL du cache ne coûtent rien.

Commencez en mode monitor

Observez les en-têtes pendant une semaine avant de bloquer quoi que ce soit.

    Cloudflare Worker pour détecter bots et VPN | IPScanner