Traefik v3 con Docker: LB dinámico, rate limit y SSL wildcard
Traefik v3 ha consolidado su posición como uno de los reverse proxies más elegantes para entornos contenedorizados. A diferencia de Nginx o HAProxy, donde cada cambio en un servicio implica tocar un fichero de configuración y recargar el demonio, Traefik descubre los contenedores Docker mediante su socket y genera rutas en caliente. En este artículo vamos a montar una instancia funcional con tres piezas clave: balanceo dinámico, middlewares de rate limit y certificados SSL wildcard emitidos por Let's Encrypt.
Por qué Traefik v3 y no otra cosa
La versión 3 introduce cambios relevantes respecto a la 2.x: la sintaxis de los proveedores, la consolidación del CRD de Kubernetes y, sobre todo, una API más limpia para definir middlewares. Si vienes de la v2, muchos ejemplos de internet no te servirán tal cual. Por eso conviene partir de un docker-compose.yml actualizado. La gran ventaja sigue siendo la misma: declaras etiquetas (labels) en tus servicios y Traefik hace el resto.
Estructura base del despliegue
Necesitamos una red externa compartida entre Traefik y los servicios que queremos publicar. También un fichero de configuración estática para los parámetros globales (puertos, proveedor Docker, entrypoints) y otro dinámico opcional para middlewares reutilizables.
# docker-compose.yml
services:
traefik:
image: traefik:v3.0
container_name: traefik
restart: unless-stopped
ports:
- "80:80"
- "443:443"
volumes:
- /var/run/docker.sock:/var/run/docker.sock:ro
- ./traefik.yml:/etc/traefik/traefik.yml:ro
- ./dynamic:/etc/traefik/dynamic:ro
- ./acme.json:/acme.json
networks:
- web
networks:
web:
external: true
El fichero acme.json debe tener permisos 600; si no, Traefik se negará a escribir en él. Es un detalle que arruina muchas primeras instalaciones.
Configuración estática: traefik.yml
Aquí definimos los entrypoints, el proveedor Docker y el resolver ACME con el reto DNS o TLS. Usaremos TLS challenge con wildcard, lo que obliga a configurar DNS-01. Para este ejemplo, Cloudflare:
# traefik.yml
entryPoints:
web:
address: ":80"
http:
redirections:
entryPoint:
to: websecure
scheme: https
websecure:
address: ":443"
providers:
docker:
exposedByDefault: false
network: web
file:
directory: /etc/traefik/dynamic
watch: true
certificatesResolvers:
letsencrypt:
acme:
email: admin@ejemplo.com
storage: /acme.json
dnsChallenge:
provider: cloudflare
resolvers:
- "1.1.1.1:53"
Con exposedByDefault: false evitamos que cualquier contenedor se publique por accidente. Solo los que llevan traefik.enable=true saldrán a internet.
Balanceo dinámico entre réplicas
Cuando escalas un servicio con docker compose up --scale app=3, Traefik detecta las tres instancias y reparte el tráfico automáticamente por round-robin. No hay que declarar upstreams ni pesos. Las etiquetas básicas del servicio serían:
labels:
- "traefik.enable=true"
- "traefik.http.routers.app.rule=Host(`app.ejemplo.com`)"
- "traefik.http.routers.app.entrypoints=websecure"
- "traefik.http.routers.app.tls.certresolver=letsencrypt"
- "traefik.http.services.app.loadbalancer.server.port=3000"
- "traefik.http.services.app.loadbalancer.healthcheck.path=/health"
- "traefik.http.services.app.loadbalancer.healthcheck.interval=10s"
El healthcheck es importante: si una réplica deja de responder, Traefik la saca del pool sin intervención manual. Eso es balanceo dinámico de verdad.
Middleware de rate limit
El middleware rateLimit de Traefik v3 permite limitar peticiones por segundo y ráfagas. Podemos declararlo en el fichero dinámico y reutilizarlo:
# dynamic/middlewares.yml
http:
middlewares:
limit-global:
rateLimit:
average: 100
burst: 50
period: 1s
limit-login:
rateLimit:
average: 5
burst: 10
sourceCriterion:
requestHeaderName: X-Real-IP
Y referenciarlo desde el router:
- "traefik.http.routers.app.middlewares=limit-global@file"
- "traefik.http.routers.login.middlewares=limit-login@file"
El sufijo @file indica que el middleware viene del proveedor de fichero, no de Docker. Es un error frecuente olvidarlo. Para endpoints sensibles como /login o /api/token, un límite de 5 req/s con burst 10 es razonable. Si tu app está detrás de otro proxy, ajusta sourceCriterion para no limitar a todos los usuarios como si fueran uno solo.
SSL wildcard con DNS-01
El certificado wildcard permite cubrir *.ejemplo.com con un único certificado, evitando emitir uno por subdominio. Requiere validación DNS, porque Let's Encrypt no acepta HTTP-01 para wildcards. Con Cloudflare, define las variables de entorno en el contenedor:
environment:
- CF_API_EMAIL=admin@ejemplo.com
- CF_API_KEY=tu_api_token
Idealmente usa CF_DNS_API_TOKEN con permisos limitados a Zone:DNS:Edit sobre el dominio concreto. Nunca la clave global. Después, en las etiquetas del router, solicita el dominio wildcard:
- "traefik.http.routers.app.tls.domains[0].main=ejemplo.com"
- "traefik.http.routers.app.tls.domains[0].sans=*.ejemplo.com"
Traefik guardará el certificado en acme.json y lo renovará automáticamente. Si usas varios dominios, repite los índices [1], [2] y así sucesivamente. Recuerda hacer backup cifrado de ese fichero: contiene las claves privadas.
Errores típicos y cómo evitarlos
- Permisos de acme.json: debe ser
600y propiedad del usuario que ejecuta Traefik. - Sufijo de middleware olvidado: sin
@fileo@docker, el router no encuentra el middleware. - Red incorrecta: si Traefik y el servicio no comparten red, no hay descubrimiento.
- DNS-01 lento: usa resolvers públicos como
1.1.1.1para acelerar la propagación. - Rate limit demasiado agresivo: en desarrollo puede bloquear tu propio navegador; ajusta según entorno.
Consideraciones finales
Traefik v3 con Docker ofrece una experiencia muy cercana a "configurar y olvidar". El descubrimiento automático reduce el trabajo operativo, los middlewares de rate limit protegen endpoints sensibles sin tocar el código de la aplicación y los certificados wildcard simplifican la gestión TLS cuando manejas muchos subdominios. La contrapartida es que la curva de aprendizaje inicial con etiquetas y sufijos puede confundir, pero una vez montado el esqueleto que hemos descrito, añadir un nuevo servicio se reduce a un puñado de labels. Para un administrador de sistemas que gestiona decenas de contenedores, la inversión merece la pena.