Apps solo para mí, con una lista de IPs permitidas en Traefik
El middleware ipAllowList de Traefik para dejar herramientas internas accesibles por dominio y HTTPS solo desde lugares conocidos, y cómo convivir con una IP de casa que cambia.
Algunas cosas del laboratorio las quiero con dominio y HTTPS, pero no para todo el mundo: el panel de Dokploy, una herramienta interna, un tablero que solo uso yo. La opción más simple para eso es una lista de IPs permitidas en Traefik. Quien venga de otra dirección recibe un 403 y no llega ni a ver la pantalla de inicio de sesión.
El middleware
En Traefik v3, que es el que trae Dokploy, el middleware se llama ipAllowList (en Traefik v2 se llamaba ipWhiteList). Lo definí en un archivo de configuración dinámica, por ejemplo /etc/dokploy/traefik/dynamic/allowlist.yml:
http:
middlewares:
solo-conocidos:
ipAllowList:
sourceRange:
- 203.0.113.25/32 # oficina (IP fija)
- 198.51.100.40/32 # IP pública de casa
- 192.168.50.20/32 # PC por la red local
- 10.20.30.11/32 # nodo de Tailscale
- 172.18.0.1/32 # puerta de enlace de la red de Docker
Traefik detecta el archivo nuevo y lo carga sin reiniciar.
Aplicarlo a una aplicación
El middleware no hace nada hasta que un router lo usa. Cómo se conecta depende del tipo de despliegue:
- Docker Compose: con una etiqueta en el servicio:
labels:
- traefik.http.routers.mi-app.middlewares=solo-conocidos@file
- Application de Dokploy: Dokploy genera un archivo de configuración dinámica por aplicación, que se puede editar desde la pestaña Advanced → Traefik de la aplicación. Ahí, en el router de
websecure, agregássolo-conocidos@filea la lista demiddlewares. Después de cambiar dominios desde la interfaz, revisá que la línea siga estando: Dokploy regenera ese archivo.
El sufijo @file le dice a Traefik que el middleware está definido en el proveedor de archivos y no en etiquetas de Docker.
Qué direcciones poner, y por qué cada una
La lista parece obvia hasta que algo no anda. Lo que aprendí:
- La oficina: si tiene IP fija, es la entrada más fácil.
- La IP pública de casa: hace falta si algún proceso de la red de casa entra a la aplicación por su dominio público. Como esa IP cambia, la actualizo sola con el mismo script del DNS dinámico, que al final reemplaza la línea marcada con un comentario:
sed -i "s#- [0-9.]*/32\( *\# IP pública de casa\)#- $IP/32\1#" \
/etc/dokploy/traefik/dynamic/allowlist.yml
- La PC por la red local: si desde la red local entrás al dominio, el tráfico puede ir a la IP pública y volver (hairpin), y llega con la IP del router. Para que llegue con la IP de la PC, agregué en el archivo
hostsde la PC una línea que apunta el dominio a la IP interna del servidor. - La puerta de enlace de Docker: si un contenedor del mismo servidor llama a la aplicación por su dominio, Traefik lo ve viniendo desde la puerta de enlace de la red de Docker (como
172.18.0.1). Me pasó con una herramienta que se llama a sí misma. - El nodo de Tailscale: si entrás por Tailscale, Traefik ve la IP del subnet router, porque hace NAT. Lo explico en la guía de Tailscale.
Requisito: ver la IP real
Una lista de IPs permitidas solo funciona si Traefik ve la IP real del visitante. Si todas las conexiones llegan desde el router, o dejás entrar a todos o a nadie. Revisá primero esta guía.
Si delante de Traefik hubiera otro proxy (Cloudflare con la nube naranja, por ejemplo), la IP real viene en un encabezado y hay que configurar ipStrategy en el middleware para que la lea de ahí. En mi caso no hay nada delante, así que no hace falta.
Probar
Desde una IP permitida:
curl -I https://herramienta.ejemplo.com.ar # 200
Desde el celular con datos móviles:
curl -I https://herramienta.ejemplo.com.ar # 403
Lo que una allowlist no es
No reemplaza a la autenticación de la aplicación; es una capa más. Y tiene un punto débil: si alguien comparte tu IP (una red pública, un proveedor con CGNAT), comparte el permiso. Para acceso desde cualquier lado, una VPN como Tailscale es más sólida que ir agregando IPs a la lista.