Wat stuurt het naar IPScanner?

Het IP-adres, de user agent, methode en het pad van de bezoeker, een paar request-headers zoals Accept-Language en Sec-CH-UA, en je Site-ID. Nooit cookies of request-bodies.

Werkt het met Coolify en Dokploy?

Ja. Beide draaien Traefik met Docker-labels: declareer de plugin in de proxyconfiguratie en voeg de middleware-labels toe aan je app.

Werkt het alleen met Docker?

Nee. Traefik leest de middleware uit Docker-labels, Kubernetes-resources of een YAML-bestand, en de plugin werkt met alle drie hetzelfde.

Wat is het verschil met de CrowdSec-bouncer of een geoblock-plugin?

Een geoblock-plugin blokkeert per land, de CrowdSec-bouncer blokkeert IP's die opvallen in je logs of op gedeelde blocklists. Deze plugin geeft elke bezoeker een klasse (Tor, VPN, proxy, hosting, automatisering) en jij kiest de actie per klasse.

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

Traefik-plugin

Traefik-plugin die bots en VPN's blokkeert

Bots, Tor, VPN's en proxy's, per router gecontroleerd met één label. Start in monitor-modus en blokkeert niets tot je omschakelt.

Lees de installatiegids Bekijk op GitHub

Gratis, MIT-licentieGetest met Traefik v3.7

HTTP-routers/app@dockerEnforce

84.128.0.1GET /

Entrypoint

websecure:443

Router

app@dockerHost(`example.com`)

Middlewares

gzip@dockeripscanner@dockerMensToestaan

Service

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

Access-log

20084.128.0.1GET /Mens
403185.220.101.1GET /Tor

Verkeersklassen

Wat het controleert

Elke bezoeker krijgt één klasse. Je service ontvangt die als X-IPScanner-Class.

Menshuman
Geverifieerde botverified_bot
VPNvpn
Privé-relayrelay
Hostinghosting
Proxyproxy
Tortor
AI-agentai_agent
Kwaadaardige automatiseringmalicious_automation

Installatie

Vier stappen, eerst monitor-modus

1
Maak een API-sleutel
Zet hem in de omgeving van de Traefik-container. Elke ipscanner-middleware leest hem.
Maak een gratis API-sleutel
docker-compose.yml
```
environment:
  IPSCANNER_API_KEY: pk_live_...
```

Declareer de plugin

In de statische configuratie, of als twee CLI-flags. Herstart Traefik.

traefik.yml

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

3
Voeg een site toe en zet siteId
Modus en beleid komen dan uit het dashboard, zonder herladen.
Voeg een site toe in het dashboard
labels
```
traefik.http.middlewares.ipscanner.plugin.ipscanner.siteId=site_...
```
4
Koppel hem aan een router
Andere routers hergebruiken hem als ipscanner@docker.
labels
```
traefik.http.routers.app.middlewares=ipscanner
```

Jouw stack

Coolify, Compose of Kubernetes

Dezelfde plugin, waar Traefik zijn config ook leest.

Servers › je server › 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_...

Je app › Configuration › Container Labels

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

Eén middlewarenaam per app, toegevoegd aan elke router die Coolify heeft aangemaakt. Achter Cloudflare zet je ook trustedProxies=cloudflare en 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 en gewone Compose lezen dezelfde labels.

middleware.yml

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

Verwijs ernaar vanuit een IngressRoute of met de router.middlewares-annotatie op een Ingress.

dynamic.yml

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

De sleutel komt uit een gekoppeld Docker- of Kubernetes-secret.

Sites-dashboard

Pas het beleid aan zonder Traefik aan te raken

Sta elke klasse toe, markeer of blokkeer hem in het dashboard. De middleware neemt een wijziging binnen 30 seconden over.

Geverifieerde zoek- en AI-crawlers komen altijd door.
Monitor-modus blokkeert niets en laat zien wat hij geblokkeerd zou hebben.
Antwoordt IPScanner niet binnen 1,5 seconde, dan gaat het verzoek door.

example.comTraefik-pluginMonitorEnforce

Beleid

MensToestaan
Geverifieerde botToestaan
VPNMarkeren
TorBlokkeren
AI-agentMarkeren
Kwaadaardige automatiseringBlokkeren

185.220.101.1TorZou blokkeren

Opties

Middleware-opties

Zet ze op de middleware: als labels, in YAML of op de CRD.

Optie	Standaard	Wat het doet
`siteId`Je site in het dashboard; modus en beleid komen daarvandaan	Leeg	Je site in het dashboard; modus en beleid komen daarvandaan
`mode`monitor of enforce, als er geen `siteId` is	monitor	monitor of enforce, als er geen `siteId` is
`blockClasses`Klassen die zonder `siteId` in enforce-modus worden geblokkeerd	malicious_automation	Klassen die zonder `siteId` in enforce-modus worden geblokkeerd
`trustedProxies`Proxy's waarvan de IP-headers vertrouwd worden: CIDR's, private, cloudflare	Leeg	Proxy's waarvan de IP-headers vertrouwd worden: CIDR's, private, cloudflare
`ipHeaders`Headers die van een vertrouwde proxy worden gelezen, op volgorde	X-Forwarded-For	Headers die van een vertrouwde proxy worden gelezen, op volgorde
`timeout`Tijd voor één controle, daarna gaat het verzoek door	1500ms	Tijd voor één controle, daarna gaat het verzoek door
`cacheTTL`Verdict-cache per bezoeker	10m	Verdict-cache per bezoeker
`cacheSize`Bezoekers in de cache	10000	Bezoekers in de cache
`policyTTL`Hoe lang een opgehaald beleid geldig blijft	30s	Hoe lang een opgehaald beleid geldig blijft
`skipPaths`Pad-regex die de controle overslaat	Statische bestanden	Pad-regex die de controle overslaat
`apiKeyFile`Bestand met de API-sleutel, voor secrets	Leeg	Bestand met de API-sleutel, voor secrets
`debug`Zet de headers op responses en logt elke beslissing	false	Zet de headers op responses en logt elke beslissing

Vragen

FAQ over de Traefik-plugin

Elke bezoeker wordt hooguit eens per 10 minuten gecontroleerd en het oordeel staat in het geheugen, dus volgende verzoeken slaan de API over. Een controle krijgt 1,5 seconde, daarna gaat het verzoek door.

Begin in monitor-modus

Voeg de middleware toe, bekijk een week verkeer in het dashboard en blokkeer dan.

Maak een gratis API-sleutel Voeg een site toe

Traefik-plugin die bots en VPN's blokkeert

Wat het controleert

Vier stappen, eerst monitor-modus

Maak een API-sleutel

Declareer de plugin

Voeg een site toe en zet siteId

Koppel hem aan een router

Coolify, Compose of Kubernetes

Pas het beleid aan zonder Traefik aan te raken

Middleware-opties

FAQ over de Traefik-plugin

Begin in monitor-modus

Voeg een site toe en zet `siteId`