Dokploy en LXC devuelve 502, y el ajuste que lo arregla

Por qué las aplicaciones desplegadas en Dokploy dentro de un contenedor LXC dan error 502 en Traefik, qué tiene que ver la VIP de Docker Swarm, y cómo resolverlo con el modo dnsrr.

U10 3 min de lectura

Esta es la guía que me hubiera gustado encontrar el día que desplegué mi primera aplicación en Dokploy. El despliegue terminaba bien, el contenedor estaba corriendo, los logs no mostraban errores, pero el navegador devolvía 502 Bad Gateway. Pasé un buen rato revisando puertos hasta entender que el problema no era la aplicación.

El síntoma

  • Dokploy corre dentro de un contenedor LXC de Proxmox.
  • Desplegás una aplicación de tipo Application (desde Git, Dockerfile o archivo comprimido).
  • El build termina bien y el contenedor queda en ejecución.
  • El dominio responde con 502.
  • Las aplicaciones de tipo Docker Compose funcionan sin problema.

Esa última pista es la clave.

Qué está pasando

Dokploy despliega las aplicaciones de tipo Application como servicios de Docker Swarm. Por defecto, Swarm le asigna a cada servicio una IP virtual (VIP). Traefik se conecta a esa IP, y Swarm reparte el tráfico entre las réplicas usando IPVS, el balanceador de carga del kernel de Linux.

Dentro de un contenedor LXC sin privilegios, Docker no puede manejar IPVS como necesita: el kernel es el del host y el contenedor no tiene permiso para configurar esas tablas. Resultado: la VIP existe, pero no lleva a ningún lado. Traefik intenta conectarse, no obtiene respuesta y devuelve 502.

Los Compose no tienen el problema porque Dokploy los levanta como contenedores comunes, sin pasar por la VIP de un servicio Swarm.

La solución: modo de endpoint dnsrr

Swarm tiene un segundo modo de exponer servicios: dnsrr (DNS round-robin). En lugar de una IP virtual, el nombre del servicio resuelve directamente a las IPs de los contenedores. Traefik se conecta al contenedor sin intermediarios y IPVS deja de importar.

En Dokploy se configura por aplicación:

  1. Entrá a la aplicación → pestaña Advanced.
  2. Buscá la sección Swarm Settings y el campo Endpoint Spec.
  3. Poné:
{
  "Mode": "dnsrr"
}
  1. Guardá y volvé a desplegar.

Si preferís verlo con Docker directamente, es el equivalente a:

docker service update --endpoint-mode dnsrr nombre-del-servicio

La contra de dnsrr

El modo dnsrr no admite publicar puertos con el modo ingress de Swarm (el que expone un puerto en todos los nodos). En un despliegue con Dokploy no hace falta: Traefik llega a la aplicación por la red interna dokploy-network, sin puertos publicados. Si alguna vez publicás un puerto directo, tendría que ser en modo host.

También perdés el balanceo de la VIP, pero en un servidor de un solo nodo con una réplica por aplicación da exactamente igual.

Cómo confirmar el diagnóstico

Si querés estar seguro antes de cambiar nada, desde el contenedor de Dokploy:

docker service inspect nombre-del-servicio --format '{{json .Endpoint.Spec}}'

Si dice "Mode":"vip", es candidato. Después probá conectarte al servicio desde el contenedor de Traefik por el nombre del servicio y por la IP del contenedor (la ves con docker inspect). Si por la IP responde y por el nombre no, es la VIP.

Mi regla desde entonces

Cada aplicación nueva tipo Application en este Dokploy lleva {"Mode":"dnsrr"} desde el primer despliegue. Lo tengo anotado junto al procedimiento de alta, porque es fácil olvidarlo y el error no da pistas.

La alternativa de fondo sería mover Dokploy a una máquina virtual, donde Docker tiene su propio kernel y todo funciona como en la documentación. Si el servidor tuviera más RAM, probablemente lo haría. Con lo que hay, este ajuste resuelve el problema sin costo.