Maakt het Caddy trager?

Elke bezoeker wordt hooguit eens per 10 minuten gecontroleerd, uit een in-memory cache en binnen 1,5 seconde. Antwoordt IPScanner niet, dan komt het verzoek door en pauzeren de controles 30 seconden.

Moet Caddy herladen na een policy-wijziging?

Nee. Met site_id haalt de module de policy elke 30 seconden opnieuw op, dus een wijziging in het dashboard komt vanzelf bij Caddy aan.

Werkt het achter Cloudflare?

Ja. Vertrouw de Cloudflare-ranges in trusted_proxies en voeg client_ip_headers CF-Connecting-IP toe, zodat het echte IP van de bezoeker wordt gecontroleerd.

Is het een Caddy-plugin of een module?

Allebei: Caddy noemt zijn plugins modules. Je voegt deze toe zoals elke andere plugin, met xcaddy of via de downloadpagina van caddyserver.com.

Caddy of Traefik: welke moet ik kiezen?

De proxy die je al draait. De Caddy-module en de Traefik-plugin doen dezelfde check en volgen hetzelfde sitebeleid.

Wat zit er in het gratis plan?

30.000 requests per maand, tot 1.000 per dag. Elke nieuwe bezoekerscontrole kost er 2. Op Free draait een site die je vanuit het dashboard beheert in monitor-modus; blokkeren kan vanaf Starter.

IPScanner

Producten

IP DetectionVPN-, proxy-, Tor- en hostingchecks op elk IP AgentscanOnderscheid mensen, bots en AI-agents ProvenanceLocatiechecks met een fraudebestendig auditlog

Integraties

Cloudflare Worker WordPress-plugin Traefik-plugin Caddy-module nginx, Apache, HAProxy Formulier-gate MCP-server Alle integraties

DetectiedienstenVPN-detectie Proxydetectie Geolocatie ASN-gegevens WHOIS-info

Caddy-module

Caddy-module die bots, VPN's en Tor blokkeert

Zet één ipscanner-directive in een site-blok en elke bezoeker wordt gecontroleerd vóór reverse_proxy. De module start in monitor-modus en blokkeert niets tot je omschakelt.

Bekijk op GitHub Lees de installatiegids

Gratis, MIT-licentieCaddy 2.8+

CaddyfileHerladen

1example.com {

2ipscanner {

3site_id site_4fQ8nZ2kLm7xR1vT9cBw

5reverse_proxy localhost:8080

Mens

ipscanner

:8080

Access-log

84.128.0.1Mens200Toestaan
185.220.101.1Tor403Blokkeren
66.249.66.1Geverifieerde bot200Toestaan

Verkeersklassen

Wat het kan blokkeren

Elke bezoeker krijgt één klasse. Blokkeer een klasse in het dashboard, of zet hem in block_classes.

Menshuman
Geverifieerde botverified_botKomt altijd door
AI-agentai_agent
Kwaadaardige automatiseringmalicious_automationStandaard bij enforce
Tortor
VPNvpn
Proxyproxy
Hostinghosting
Privé-relayrelay

Installatie

Live in vier stappen

1
Haal een API-sleutel
Caddy leest hem uit IPSCANNER_API_KEY, of uit api_key in de Caddyfile.
Maak een gratis API-sleutel
shell
```
export IPSCANNER_API_KEY=<your API key>
```
2
Bouw Caddy met de module
Met xcaddy of in Docker. Vereist Caddy 2.8 of nieuwer.
```
xcaddy build --with github.com/ipscanner/ipscanner-caddy
./caddy list-modules | grep ipscanner
```
3
Voeg een site toe in het dashboard
De site bewaart de policy en toont het verkeer. Kopieer de Site ID.
Voeg een site toe
example.comCaddyMonitor
Site ID
site_4fQ8nZ2kLm7xR1vT9cBw
4
Voeg de directive toe
Geen globale order-regel nodig: hij draait vóór basic_auth en reverse_proxy.
Caddyfile
```
example.com {
	ipscanner {
		site_id site_4fQ8nZ2kLm7xR1vT9cBw
	}
	reverse_proxy localhost:8080
}
```

Zonder site

Caddyfile of JSON

Zet de modus en de geblokkeerde klassen in de config. Een matcher zoals ipscanner /app/* beperkt de controle tot bepaalde paden.

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

Placeholders

Gebruik het oordeel in logs en matchers

Gezet door de directive, voor log_append, vars-matchers en headers.

Placeholder	Waarden
`{http.vars.ipscanner.status}`ok, error, timeout, backoff, skipped	ok, error, timeout, backoff, skipped
`{http.vars.ipscanner.class}`Verkeersklasse, gezet bij status ok	Verkeersklasse, gezet bij status 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

Client-IP

Achter een load balancer of CDN

De module controleert het client-IP dat Caddy heeft bepaald. Vertrouw je proxy's, en trusted_proxies_strict voorkomt dat een bezoeker een nep-hop toevoegt.

Caddyfile

{
	servers {
		trusted_proxies static 10.0.0.0/8
		trusted_proxies_strict
	}
}

Instellingen

Subdirectives

Allemaal optioneel. De JSON-config gebruikt dezelfde namen.

Subdirective	Standaard	Wat het doet
`api_key`API-sleutel. Zonder sleutel komt elk verzoek door.	{env.IPSCANNER_API_KEY}	API-sleutel. Zonder sleutel komt elk verzoek door.
`site_id`Site in het dashboard die modus en policy bepaalt.	Leeg	Site in het dashboard die modus en policy bepaalt.
`mode`Monitor of enforce. Met een site werkt alleen monitor.	monitor	Monitor of enforce. Met een site werkt alleen monitor.
`block_classes`Geblokkeerd in enforce-modus zonder site.	malicious_automation	Geblokkeerd in enforce-modus zonder site.
`timeout`Tijdsbudget voor één controle.	1.5s	Tijdsbudget voor één controle.
`cache_ttl`Hoe lang een oordeel per bezoeker geldt.	10m	Hoe lang een oordeel per bezoeker geldt.
`cache_size`Items in de oordeel-cache.	10000	Items in de oordeel-cache.
`policy_ttl`Hoe lang de site-policy in de cache blijft.	30s	Hoe lang de site-policy in de cache blijft.
`skip_paths`Regex van paden die nooit worden gecontroleerd.	Statische bestanden	Regex van paden die nooit worden gecontroleerd.
`block_message`Tekst van de 403-pagina.	Blocked by IPScanner edge guard.	Tekst van de 403-pagina.
`debug`Debug-headers en één logregel per beslissing.	Uit	Debug-headers en één logregel per beslissing.
`api_url`Basis-URL van de API.	https://ipscanner.io	Basis-URL van de API.

Komt altijd door

Wat het nooit blokkeert

Geverifieerde zoek- en AI-crawlers.
Privé- en loopback-adressen, en OPTIONS-verzoeken.
Statische bestanden en alles in skip_paths.
Elk verzoek, als IPScanner traag is of plat ligt.

Vragen

FAQ over de Caddy-module

Nee. Monitor-modus markeert een verzoek als would_block en laat het door. Zet de site of de Caddyfile op enforce als de log klopt.

Begin in monitor-modus

Bouw Caddy met de module, lees een week aan beslissingen en blokkeer dan.

Maak een gratis API-sleutel Voeg een site toe