CrowdSec delante de todo, con el plugin de Traefik
Cómo instalé CrowdSec en Dokploy para leer los logs de Traefik, y el plugin bouncer que bloquea direcciones maliciosas antes de que lleguen a cualquier aplicación.
A los pocos minutos de abrir los puertos 80 y 443, los logs de Traefik se llenaron de visitas que no eran personas: bots buscando /wp-login.php, /.env, paneles de administración de todo tipo. Ninguna iba a encontrar nada, pero no me gustaba que llegaran a las aplicaciones. Para eso instalé CrowdSec.
Qué es CrowdSec
CrowdSec tiene dos partes:
- El motor (agente + API local): lee logs, detecta comportamientos sospechosos con escenarios predefinidos (escaneo de rutas, fuerza bruta, explotación de vulnerabilidades conocidas) y decide bloquear direcciones IP. Además recibe una lista comunitaria de IPs maliciosas detectadas por otros usuarios.
- Los bouncers: componentes que aplican las decisiones. Hay bouncers para firewall, nginx, Cloudflare y Traefik, entre otros.
En mi caso, el motor lee el log de acceso de Traefik y el bouncer es un plugin de Traefik que corta las peticiones de IPs bloqueadas con un 403.
Paso 1: que Traefik escriba un log de acceso
En la configuración estática de Traefik (en Dokploy, /etc/dokploy/traefik/traefik.yml) agregué el log de acceso en formato JSON:
accessLog:
filePath: /etc/dokploy/traefik/dynamic/access.log
format: json
Lo puse dentro de la carpeta dynamic porque ya está montada en el contenedor de Traefik y es fácil montarla también en el de CrowdSec. Conviene configurar rotación de ese archivo, porque crece.
Paso 2: CrowdSec como Docker Compose
En Dokploy creé un servicio Docker Compose con la imagen oficial crowdsecurity/crowdsec, montando el log de Traefik en modo lectura y con la colección de Traefik:
services:
crowdsec:
image: crowdsecurity/crowdsec:latest
restart: unless-stopped
environment:
COLLECTIONS: "crowdsecurity/traefik crowdsecurity/http-cve"
TZ: America/Argentina/Buenos_Aires
volumes:
- /etc/dokploy/traefik/dynamic/access.log:/var/log/traefik/access.log:ro
- crowdsec-db:/var/lib/crowdsec/data
- crowdsec-config:/etc/crowdsec
configs:
- source: acquis
target: /etc/crowdsec/acquis.yaml
networks: [dokploy-network]
configs:
acquis:
content: |
filenames:
- /var/log/traefik/access.log
labels:
type: traefik
volumes:
crowdsec-db:
crowdsec-config:
networks:
dokploy-network:
external: true
Está en dokploy-network para que Traefik pueda hablar con su API local por nombre. En producción, fijá la versión de la imagen en lugar de latest.
Una vez arriba, registré el bouncer:
docker exec -it <contenedor-crowdsec> cscli bouncers add traefik-bouncer
Eso imprime una clave. Guardala: se muestra una sola vez.
Paso 3: el plugin bouncer en Traefik
En la configuración estática, declarar el plugin:
experimental:
plugins:
bouncer:
moduleName: github.com/maxlerebourg/crowdsec-bouncer-traefik-plugin
version: v1.7.1
(es la versión que uso; revisá si hay una más nueva). Y aplicar el middleware a los dos puntos de entrada, para que cubra todo:
entryPoints:
web:
address: :80
http:
middlewares: [crowdsec@file]
websecure:
address: :443
http:
middlewares: [crowdsec@file]
En la configuración dinámica, un archivo en /etc/dokploy/traefik/dynamic/crowdsec.yml:
http:
middlewares:
crowdsec:
plugin:
bouncer:
enabled: true
crowdsecMode: stream
crowdsecLapiHost: crowdsec:8080
crowdsecLapiKey: LA_CLAVE_DEL_BOUNCER
updateMaxFailure: -1
clientTrustedIPs:
- 10.20.30.0/24
- 192.168.50.0/24
Este archivo tiene la clave, así que chmod 600. Traefik recarga la configuración dinámica solo; para la estática hay que reiniciar el contenedor de Traefik.
Las tres opciones que importan
crowdsecMode: stream: el plugin baja la lista de decisiones periódicamente y la guarda en memoria. Cada petición se resuelve localmente, sin consultar a CrowdSec. Es el modo más rápido.updateMaxFailure: -1: si CrowdSec se cae, el plugin sigue dejando pasar el tráfico en lugar de bloquear todo. Prefiero perder el filtro un rato a que se caigan todos los sitios.clientTrustedIPs: direcciones que nunca se bloquean. Puse las redes locales y, después de un susto, la IP de un lugar desde donde trabajo: CrowdSec la bloqueó porque una de mis herramientas hacía muchas peticiones seguidas y parecía un escaneo.
Probar
Bloqueá tu propia IP (desde otra red, para no quedarte afuera):
docker exec <contenedor-crowdsec> cscli decisions add --ip 203.0.113.7 --duration 5m
En menos de un minuto, esa IP debería recibir 403 en cualquier sitio. Para levantar el bloqueo:
docker exec <contenedor-crowdsec> cscli decisions delete --ip 203.0.113.7
Y para ver qué está bloqueando:
docker exec <contenedor-crowdsec> cscli decisions list
docker exec <contenedor-crowdsec> cscli alerts list
Requisito previo
CrowdSec decide por IP. Si Traefik ve todas las visitas desde la misma dirección (la del router), bloquear una es bloquear a todos. Antes de instalarlo, asegurate de que Traefik ve la IP real del visitante: lo explico acá.