Repolode
Enviar
jittering

jittering/traefik-kop

Agente de descubrimiento que lee las etiquetas de contenedores Docker en hosts remotos y las publica en Redis para que una instancia de Traefik enrute servicios en varios nodos Docker.

Ver en GitHub
Estrellas
526
Forks
29
Issues abiertos
1
Último commit
hace 24 días

¿Qué es?

traefik-kop es un agente de descubrimiento para ejecutar un clúster Docker con varios hosts, sin Swarm ni Kubernetes, detrás de una única instancia de Traefik expuesta a Internet. Cada nodo worker ejecuta traefik-kop, que lee las etiquetas de los contenedores de su daemon local de Docker con la misma lógica que el provider de Docker de Traefik y publica la configuración de enrutamiento resultante en una instancia compartida de Redis. El nodo principal de Traefik se configura con un provider de Redis que apunta a esa misma instancia, por lo que obtiene las rutas de los servicios de todos los nodos.

El agente gestiona los detalles necesarios para que funcione el enrutamiento entre hosts. Sustituye las IP internas de los contenedores por una bind IP accesible, que se configura mediante un flag, una variable de entorno, una interfaz o una etiqueta por servicio, y obtiene los puertos de los servicios a partir de los puertos publicados en el host. Admite namespaces para seleccionar subconjuntos de contenedores, combinar load balancers entre nodos, expiración basada en TTL de Redis con renovación periódica, Redis Sentinel y TLS con autenticación mutua opcional. Supervisa los eventos de Docker en tiempo real, con una alternativa configurable basada en polling.

Funciones clave

  • 01Publica en un Redis compartido la configuración de enrutamiento del provider de Docker de Traefik desde cada nodo.
  • 02Selecciona las bind IP mediante una etiqueta, un flag, una interfaz de red o detección automática.
  • 03Filtra contenedores mediante namespaces, incluidos varios namespaces separados por comas.
  • 04Combina las entradas de los load balancers para servicios que se ejecutan en varios nodos.
  • 05Admite expiración por TTL de Redis, Redis Sentinel y TLS con autenticación mutua.

Casos de uso

  • Servir varios hosts Docker independientes a través de un único punto de entrada público de Traefik, sin Swarm ni Kubernetes.
  • Ejecutar en paralelo instancias independientes de Traefik y traefik-kop mediante prefijos de etiquetas.
  • Mantener una tabla de enrutamiento respaldada por Redis que elimine las entradas obsoletas cuando desaparece un nodo.

Inicio rápido

  1. 1

    Configura el nodo de Traefik para que use el proveedor de Redis (traefik.yml).

  2. 2

    Ejecuta traefik-kop con docker-compose en cada uno de los demás nodos Docker y configura REDIS_ADDR y BIND_IP.

  3. 3

    Añade las etiquetas de traefik y una asignación de puerto al servicio de destino.

Antes de usarlo

  • Se necesita una instancia de Redis en ejecución a la que puedan acceder tanto Traefik como traefik-kop.
  • Solo se conecta a Docker mediante un socket unix; no se admiten conexiones de Docker por SSH ni HTTP(S).
  • La combinación del balanceador de carga está desactivada de forma predeterminada y puede dejar IP obsoletas si cambia la IP de un nodo.

En colecciones

Frameworks de microservicios e infraestructura de servicios

Temas

#docker#traefik#redis#reverse-proxy#service-discovery#multi-host#load-balancing#traefik-docker

Preguntas frecuentes

¿Qué es traefik-kop?
Agente de descubrimiento que lee las etiquetas de contenedores Docker en hosts remotos y las publica en Redis para que una instancia de Traefik enrute servicios en varios nodos Docker. traefik-kop es un agente de descubrimiento para ejecutar un clúster Docker con varios hosts, sin Swarm ni Kubernetes, detrás de una única instancia de Traefik expuesta a Internet. Cada nodo worker ejecuta traefik-kop, que lee las etiquetas de los contenedores de su daemon local de Docker con la misma lógica que el provider de Docker de Traefik y publica la configuración de enrutamiento resultante en una instancia compartida de Redis. El nodo principal de Traefik se configura con un provider de Redis que apunta a esa misma instancia, por lo que obtiene las rutas de los servicios de todos los nodos.
¿traefik-kop es gratuito? ¿Qué licencia tiene?
traefik-kop es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿traefik-kop sigue mantenido?
Mantenimiento activo. El último commit de traefik-kop fue el 13 oct 2026.
¿Para qué puedo usar traefik-kop?
Servir varios hosts Docker independientes a través de un único punto de entrada público de Traefik, sin Swarm ni Kubernetes. Ejecutar en paralelo instancias independientes de Traefik y traefik-kop mediante prefijos de etiquetas. Mantener una tabla de enrutamiento respaldada por Redis que elimine las entradas obsoletas cuando desaparece un nodo.
¿Cómo se instala traefik-kop?
Configura el nodo de Traefik para que use el proveedor de Redis (traefik.yml). Ejecuta traefik-kop con docker-compose en cada uno de los demás nodos Docker y configura REDIS_ADDR y BIND_IP. Añade las etiquetas de traefik y una asignación de puerto al servicio de destino.
¿Dónde consigo traefik-kop?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/jittering/traefik-kop

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados