Chaque visiteur est vérifié au plus une fois toutes les 10 minutes, depuis un cache en mémoire et dans un budget de 1,5 seconde. Si IPScanner ne répond pas, la requête passe et les vérifications marquent une pause de 30 secondes.

Faut-il recharger Caddy après un changement de politique ?

Non. Avec site_id, le module relit la politique du site toutes les 30 secondes : un changement dans le tableau de bord arrive tout seul.

Fonctionne-t-il derrière Cloudflare ?

Oui. Déclarez les plages Cloudflare dans trusted_proxies et ajoutez client_ip_headers CF-Connecting-IP pour vérifier la vraie IP du visiteur.

Est-ce un plugin ou un module Caddy ?

Les deux : Caddy appelle ses plugins des modules. Vous l'ajoutez comme tout autre plugin, avec xcaddy ou depuis la page de téléchargement de caddyserver.com.

Caddy ou Traefik : lequel choisir ?

Celui que vous utilisez déjà. Le module Caddy et le plugin Traefik font la même vérification et suivent la même politique de site.

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

Module Caddy

Module Caddy pour bloquer bots, VPN et Tor

Ajoutez une directive ipscanner à un bloc de site et chaque visiteur est vérifié avant reverse_proxy. Le module démarre en mode monitor et ne bloque rien tant que vous ne basculez pas.

Voir sur GitHub Lire le guide d'installation

Gratuit, licence MITCaddy 2.8+

CaddyfileRechargé

1example.com {

2ipscanner {

3site_id site_4fQ8nZ2kLm7xR1vT9cBw

5reverse_proxy localhost:8080

Humain

ipscanner

:8080

Journal d'accès

84.128.0.1Humain200Autoriser
185.220.101.1Tor403Bloquer
66.249.66.1Robot vérifié200Autoriser

Classes de trafic

Ce qu'il peut bloquer

Chaque visiteur reçoit une classe. Bloquez une classe depuis le tableau de bord, ou indiquez-la dans block_classes.

Humainhuman
Robot vérifiéverified_botPasse toujours
Agent IAai_agent
Automatisation malveillantemalicious_automationPar défaut en enforce
Tortor
VPNvpn
Proxyproxy
Hébergementhosting
Relais privérelay

Installation

En ligne en quatre étapes

1
Obtenir une clé API
Caddy la lit dans IPSCANNER_API_KEY, ou dans api_key du Caddyfile.
Créer une clé API gratuite
shell
```
export IPSCANNER_API_KEY=<your API key>
```
2
Compiler Caddy avec le module
Avec xcaddy ou dans Docker. Caddy 2.8 ou plus récent.
```
xcaddy build --with github.com/ipscanner/ipscanner-caddy
./caddy list-modules | grep ipscanner
```
3
Ajouter un site dans le tableau de bord
Le site porte la politique et affiche le trafic. Copiez son Site ID.
Ajouter un site
example.comCaddyMonitor
Site ID
site_4fQ8nZ2kLm7xR1vT9cBw

Ajouter la directive

Pas de ligne order globale : elle s'exécute avant basic_auth et reverse_proxy.

Caddyfile

example.com {
	ipscanner {
		site_id site_4fQ8nZ2kLm7xR1vT9cBw
	}
	reverse_proxy localhost:8080
}

Sans site

Caddyfile ou JSON

Le mode et les classes bloquées se règlent dans la configuration. Un matcher comme ipscanner /app/* limite la vérification à certains chemins.

example.com {
	ipscanner {
		mode enforce
		block_classes malicious_automation tor
	}
	reverse_proxy localhost:8080
}

Placeholders

Le verdict dans les logs et les matchers

Définis par la directive, pour log_append, les matchers vars et les en-têtes.

Placeholder	Valeurs
`{http.vars.ipscanner.status}`ok, error, timeout, backoff, skipped	ok, error, timeout, backoff, skipped
`{http.vars.ipscanner.class}`Classe de trafic, définie si le statut est ok	Classe de trafic, définie si le statut est ok
`{http.vars.ipscanner.action}`allow, flag, block, would_flag, would_block	allow, flag, block, would_flag, would_block

Caddyfile

log_append ipscanner_class {http.vars.ipscanner.class}
log_append ipscanner_action {http.vars.ipscanner.action}

@flagged vars ipscanner.action flag
request_header @flagged X-Review 1

IP client

Derrière un load balancer ou un CDN

Le module vérifie l'IP client résolue par Caddy. Déclarez vos proxys de confiance, et trusted_proxies_strict empêche un visiteur d'ajouter un faux saut.

Caddyfile

{
	servers {
		trusted_proxies static 10.0.0.0/8
		trusted_proxies_strict
	}
}

Réglages

Sous-directives

Toutes facultatives. La configuration JSON reprend les mêmes noms.

Sous-directive	Par défaut	Rôle
`api_key`Clé API. Sans clé, chaque requête passe.	{env.IPSCANNER_API_KEY}	Clé API. Sans clé, chaque requête passe.
`site_id`Site du tableau de bord qui fixe mode et politique.	Vide	Site du tableau de bord qui fixe mode et politique.
`mode`Monitor ou enforce. Avec un site, seul monitor s'applique.	monitor	Monitor ou enforce. Avec un site, seul monitor s'applique.
`block_classes`Bloquées en mode enforce sans site.	malicious_automation	Bloquées en mode enforce sans site.
`timeout`Budget de temps par vérification.	1.5s	Budget de temps par vérification.
`cache_ttl`Durée de réutilisation d'un verdict par visiteur.	10m	Durée de réutilisation d'un verdict par visiteur.
`cache_size`Entrées du cache de verdicts.	10000	Entrées du cache de verdicts.
`policy_ttl`Durée de cache de la politique du site.	30s	Durée de cache de la politique du site.
`skip_paths`Regex des chemins jamais vérifiés.	Fichiers statiques	Regex des chemins jamais vérifiés.
`block_message`Texte de la page 403.	Blocked by IPScanner edge guard.	Texte de la page 403.
`debug`En-têtes de debug et une ligne de log par décision.	Désactivé	En-têtes de debug et une ligne de log par décision.
`api_url`URL de base de l'API.	https://ipscanner.io	URL de base de l'API.

Passe toujours

Ce qu'il ne bloque jamais

Les robots de recherche et d'IA vérifiés.
Les adresses privées et loopback, et les requêtes OPTIONS.
Les fichiers statiques et tout ce qui est dans skip_paths.
Toute requête, quand IPScanner est lent ou indisponible.

Questions

FAQ du module Caddy

Non. Le mode monitor marque la requête would_block et la laisse passer. Passez le site ou le Caddyfile en enforce quand le journal vous convient.

Commencez en mode monitor

Compilez Caddy avec le module, lisez une semaine de décisions, puis bloquez.

Créer une clé API gratuite Ajouter un site

Module Caddy pour bloquer bots, VPN et Tor

Ce qu'il peut bloquer

En ligne en quatre étapes

Obtenir une clé API

Compiler Caddy avec le module

Ajouter un site dans le tableau de bord

Ajouter la directive

Caddyfile ou JSON

Le verdict dans les logs et les matchers

Derrière un load balancer ou un CDN

Sous-directives

Ce qu'il ne bloque jamais

FAQ du module Caddy

Commencez en mode monitor