Skip to main content

whoami

image.png

`traefik whoami` es un servidor web sencillo y ligero basado en Go que se utiliza para probar y demostrar las capacidades de enrutamiento y balanceo de carga de Traefik Proxy. Al acceder a ella, imprime información sobre el sistema operativo y las cabeceras de las solicitudes HTTP recibidas, lo que ayuda a verificar que Traefik intercepta y reenvía el tráfico correctamente.

Propósito principal:

  • Pruebas de enrutamiento: Permite a los usuarios confirmar que su configuración de Traefik (por ejemplo, reglas de host, prefijos de ruta, puntos de entrada) dirige correctamente el tráfico entrante al servicio backend correspondiente.
  • Depuración de cabeceras de solicitud: Al mostrar las cabeceras HTTP recibidas (como `X-Forwarded-For` y `X-Forwarded-Host`), ayuda a depurar cómo se modifican las solicitudes al pasar por Traefik.
  • Ejemplo de aplicación simple: La documentación de Traefik utiliza con frecuencia el servicio `whoami` en sus guías de inicio y ejemplos para Docker, Docker Compose, Kubernetes y Docker Swarm.
  • Demostración de balanceo de carga: Cuando se implementan varias réplicas de whoami, se puede demostrar el balanceo de carga de Traefik entre diferentes instancias mostrando el contenedor específico que maneja cada solicitud.

Enlaces

GitHub - traefik/whoami: Tiny Go server that prints os information and HTTP request to output

Requisitos

Portainer

Add a new stack – Portainer Documentation

Web editor

En Portainer «Stack» agregamos nuevo usando el editor WEB pegando el contenido del fichero «docker-compose.yml» y el contenido del fichero de variables2.15-docker_add_stack_web_editor.gif

Fichero de variables

TZ=Europe/Madrid
PUID=1000
PGID=1000

Fichero docker-compose

services:
# Whoami application
  whoami:
    image: traefik/whoami
    container_name: whoami
    restart: unless-stopped
    networks:
      - proxy

networks:
  proxy:
    name: proxy

En este punto ya puedes ir a http://my.docker.ip.address

Publicando detrás de un proxy

Crear registro DNS

En el proveedor que aloja el servidor DNS público, crear un registro DNS que resuelva la IP pública que llega al Proxy hacia un nombre del estilo "host.domain.com"

NGINX proxy

image.png

Para publicar el contenedor detrás de NGINX proxy, como el stack está en la red proxy solo deberás crear un nuevo host

Crear un nuevo "proxy host"

Añade un nuevo proxy host con el nombre de dominio creado en el paso anterior redirigido hacia el nombre del contenedor y el puerto que use:

image.png

Traefik

traefik-concepts-1.webp

Para publicar el contenedor detrás del proxy Traefik, deberás añadir al fichero docker-compose.yaml las siguientes etiquetas al servicio app

    labels:
      - traefik.enable=true
      - traefik.http.routers.app.rule=Host(`app.dominio.com`)
      - traefik.http.routers.app.tls=true
      - traefik.http.routers.app.tls.certresolver=letsencrypt
      - traefik.http.services.app.loadbalancer.server.port=80
Solo IPs Privadas

Para permitir el acceso solo desde redes privadas, modifica en la sección de «labels» del fichero docker-compose.yml, para añadir la siguiente linea y configurar el «middleware» «privateIPs@file»

- traefik.http.routers.app.middlewares=privateIPs@file

Back to top