Qu'envoie-t-il à IPScanner ?

L'adresse IP du visiteur, son user agent, la méthode et le chemin, quelques en-têtes comme Accept-Language et Sec-CH-UA, et votre Site ID. Jamais de cookies ni de corps de requête.

Fonctionne-t-il avec Coolify et Dokploy ?

Oui. Les deux font tourner Traefik avec des labels Docker : déclarez le plugin dans la configuration du proxy, puis ajoutez les labels du middleware à votre app.

Fonctionne-t-il uniquement avec Docker ?

Non. Traefik lit le middleware depuis des labels Docker, des ressources Kubernetes ou un fichier YAML, et le plugin fonctionne de la même façon avec les trois.

Quelle différence avec le bouncer CrowdSec ou un plugin de géoblocage ?

Un plugin de géoblocage bloque par pays, et le bouncer CrowdSec bloque les IP repérées dans vos logs ou sur des listes partagées. Ce plugin attribue une classe à chaque visiteur (Tor, VPN, proxy, hébergement, automatisation) et vous choisissez l'action par classe.

Que comprend l'offre gratuite ?

30 000 requêtes par mois, jusqu'à 1 000 par jour. Chaque nouvelle vérification de visiteur en utilise 2. En Free, un site géré depuis le tableau de bord tourne en mode monitor ; le blocage commence avec Starter.

IPScanner

Produits

IP DetectionDétection VPN, proxy, Tor et hébergement sur toute IP AgentscanDistinguez humains, bots et agents IA ProvenanceVérification de localisation avec journal d'audit infalsifiable

Intégrations

Cloudflare Worker Extension WordPress Plugin Traefik Module Caddy nginx, Apache, HAProxy Gate de formulaire Serveur MCP Toutes les intégrations

Services de détectionDétection VPN Détection de proxy Géolocalisation Données ASN Infos WHOIS

Plugin Traefik

Plugin Traefik qui bloque bots et VPN

Bots, Tor, VPN et proxys, vérifiés routeur par routeur avec un seul label. Démarre en mode monitor et ne bloque rien tant que vous ne basculez pas.

Lire le guide d'installation Voir sur GitHub

Gratuit, licence MITTesté avec Traefik v3.7

Routeurs HTTP/app@dockerEnforce

84.128.0.1GET /

Entrypoint

websecure:443

Routeur

app@dockerHost(`example.com`)

Middlewares

gzip@dockeripscanner@dockerHumainAutoriser

Service

app@docker200X-IPScanner-Class: humanX-IPScanner-Action: allow

Journal d'accès

20084.128.0.1GET /Humain
403185.220.101.1GET /Tor

Classes de trafic

Ce qu'il vérifie

Chaque visiteur reçoit une classe. Votre service la reçoit dans X-IPScanner-Class.

Humainhuman
Robot vérifiéverified_bot
VPNvpn
Relais privérelay
Hébergementhosting
Proxyproxy
Tortor
Agent IAai_agent
Automatisation malveillantemalicious_automation

Installation

Quatre étapes, mode monitor d'abord

1
Créer une clé API
Placez-la dans l'environnement du conteneur Traefik. Chaque middleware ipscanner la lit.
Créer une clé API gratuite
docker-compose.yml
```
environment:
  IPSCANNER_API_KEY: pk_live_...
```

Déclarer le plugin

Dans la configuration statique, ou avec deux flags CLI. Redémarrez Traefik.

traefik.yml

experimental:
  plugins:
    ipscanner:
      moduleName: github.com/ipscanner/ipscanner-traefik
      version: v0.1.0

3
Ajouter un site et définir siteId
Le mode et la politique viennent alors du tableau de bord, sans rechargement.
Ajouter un site dans le tableau de bord
labels
```
traefik.http.middlewares.ipscanner.plugin.ipscanner.siteId=site_...
```
4
L'attacher à un routeur
Les autres routeurs le réutilisent sous ipscanner@docker.
labels
```
traefik.http.routers.app.middlewares=ipscanner
```

Votre stack

Coolify, Compose ou Kubernetes

Le même plugin, où que Traefik lise sa configuration.

Servers › votre serveur › Proxy

command:
  # ...the flags Coolify set
  - '--experimental.plugins.ipscanner.modulename=github.com/ipscanner/ipscanner-traefik'
  - '--experimental.plugins.ipscanner.version=v0.1.0'
environment:
  - IPSCANNER_API_KEY=pk_live_...

Votre app › Configuration › Container Labels

traefik.http.middlewares.ipscanner-myapp.plugin.ipscanner.siteId=site_...
traefik.http.routers.https-0-<uuid>.middlewares=gzip,ipscanner-myapp

Un nom de middleware par app, ajouté à chaque routeur généré par Coolify. Derrière Cloudflare, définissez aussi trustedProxies=cloudflare et ipHeaders=CF-Connecting-IP.

docker-compose.yml

services:
  traefik:
    image: traefik:v3.7
    command:
      - --providers.docker=true
      - --entrypoints.web.address=:80
      - --experimental.plugins.ipscanner.modulename=github.com/ipscanner/ipscanner-traefik
      - --experimental.plugins.ipscanner.version=v0.1.0
    environment:
      IPSCANNER_API_KEY: ${IPSCANNER_API_KEY}
    ports: ["80:80"]
    volumes: ["/var/run/docker.sock:/var/run/docker.sock:ro"]

  app:
    image: traefik/whoami:v1.11.0
    labels:
      - traefik.enable=true
      - traefik.http.routers.app.rule=Host(`example.com`)
      - traefik.http.routers.app.middlewares=ipscanner
      - traefik.http.middlewares.ipscanner.plugin.ipscanner.siteId=site_...

Dokploy et Compose seul lisent les mêmes labels.

middleware.yml

apiVersion: traefik.io/v1alpha1
kind: Middleware
metadata:
  name: ipscanner
spec:
  plugin:
    ipscanner:
      apiKey: urn:k8s:secret:ipscanner:apiKey
      siteId: site_...

Référencez-le depuis une IngressRoute ou avec l'annotation router.middlewares sur un Ingress.

dynamic.yml

http:
  middlewares:
    ipscanner:
      plugin:
        ipscanner:
          apiKeyFile: /run/secrets/ipscanner_api_key
          siteId: site_...

La clé vient d'un secret Docker ou Kubernetes monté.

Tableau de bord Sites

Changez la politique sans toucher à Traefik

Autorisez, signalez ou bloquez chaque classe depuis le tableau de bord. Le middleware applique un changement en 30 secondes.

Les robots de recherche et d'IA vérifiés passent toujours.
Le mode monitor ne bloque rien et montre ce qu'il aurait bloqué.
Si IPScanner ne répond pas en 1,5 seconde, la requête passe.

example.comPlugin TraefikMonitorEnforce

Politique

HumainAutoriser
Robot vérifiéAutoriser
VPNSignaler
TorBloquer
Agent IASignaler
Automatisation malveillanteBloquer

185.220.101.1TorSerait bloqué

Options

Options du middleware

Définissez-les sur le middleware : en labels, en YAML ou dans la CRD.

Option	Par défaut	Rôle
`siteId`Votre site dans le tableau de bord ; mode et politique en viennent	Vide	Votre site dans le tableau de bord ; mode et politique en viennent
`mode`monitor ou enforce, sans `siteId`	monitor	monitor ou enforce, sans `siteId`
`blockClasses`Classes bloquées en mode enforce sans `siteId`	malicious_automation	Classes bloquées en mode enforce sans `siteId`
`trustedProxies`Proxys dont les en-têtes IP sont fiables : CIDR, private, cloudflare	Vide	Proxys dont les en-têtes IP sont fiables : CIDR, private, cloudflare
`ipHeaders`En-têtes lus depuis un proxy de confiance, dans l'ordre	X-Forwarded-For	En-têtes lus depuis un proxy de confiance, dans l'ordre
`timeout`Délai d'une vérification, puis la requête passe	1500ms	Délai d'une vérification, puis la requête passe
`cacheTTL`Cache des verdicts par visiteur	10m	Cache des verdicts par visiteur
`cacheSize`Visiteurs gardés en cache	10000	Visiteurs gardés en cache
`policyTTL`Durée de validité d'une politique chargée	30s	Durée de validité d'une politique chargée
`skipPaths`Regex de chemin qui saute la vérification	Fichiers statiques	Regex de chemin qui saute la vérification
`apiKeyFile`Fichier contenant la clé API, pour les secrets	Vide	Fichier contenant la clé API, pour les secrets
`debug`Ajoute les en-têtes aux réponses et journalise chaque décision	false	Ajoute les en-têtes aux réponses et journalise chaque décision

Questions

FAQ du plugin Traefik

Chaque visiteur est vérifié au plus une fois toutes les 10 minutes et le verdict reste en mémoire, donc les requêtes suivantes ne passent pas par l'API. Une vérification dispose de 1,5 seconde, ensuite la requête passe.

Commencez en mode monitor

Ajoutez le middleware, lisez une semaine de trafic dans le tableau de bord, puis bloquez.

Créer une clé API gratuite Ajouter un site

Plugin Traefik qui bloque bots et VPN

Ce qu'il vérifie

Quatre étapes, mode monitor d'abord

Créer une clé API

Déclarer le plugin

Ajouter un site et définir siteId

L'attacher à un routeur

Coolify, Compose ou Kubernetes

Changez la politique sans toucher à Traefik

Options du middleware

FAQ du plugin Traefik

Commencez en mode monitor

Ajouter un site et définir `siteId`