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.

U16 3 min de lectura

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á.