Por qué un visor de logs Docker en el navegador
El flujo de trabajo estándar en línea de comandos de Docker —docker ps, y luego docker logs -f <container>— sirve para un contenedor en un solo servidor. Muestra sus límites en cuanto usted ejecuta varios contenedores, necesita correlacionar los logs entre servicios o quiere dar a un compañero visibilidad de solo lectura sin confiarle una clave SSH. Dozzle resuelve esos tres puntos: una sola pestaña del navegador muestra todos los contenedores del host, usted hace clic para seguir en directo cualquiera de ellos, y la búsqueda en tiempo real filtra el flujo sin salir de la página. Como Dozzle se limita a leer el socket Docker y nunca escribe en disco, no hay nada que mantener, ninguna base de datos que respaldar y ningún coste de almacenamiento.
Lo que le aporta Dozzle
- Transmisión de logs en directo por WebSocket: sin polling, sin retardo, seguimiento instantáneo de cualquier contenedor.
- Búsqueda de texto completo y filtrado por regex directamente en el flujo de logs, contenedor por contenedor.
- Vista dividida multicontenedor: fije varios contenedores lado a lado para correlacionar los eventos en tiempo real.
- Acceso de solo lectura al socket Docker: Dozzle no puede iniciar, detener ni modificar ningún contenedor.
- Menos de 10 MB de RAM en reposo: una huella insignificante, que puede añadir sin riesgo a cualquier VPS en servicio.
- Modo agente multihost opcional: un único hub Dozzle agrega los logs de varios hosts Docker.
- Autenticación básica integrada y compatibilidad con OIDC para restringir el acceso a los usuarios autorizados.
Requisitos previos
Un VPS con Ubuntu 22.04 (o Debian 12) y Docker ya instalado. Dozzle necesita menos de 10 MB de RAM y nada de espacio en disco: no guarda ningún estado. No hace falta ningún nombre de dominio: Dozzle es accesible en el puerto 8080 a través de la IP de su servidor. Si quiere HTTPS y un subdominio personalizado (logs.su-dominio.com), coloque delante un reverse proxy Caddy o Nginx.
Desplegar Dozzle en su VPS
Descargar e iniciar Dozzle
Conéctese por SSH y ejecute un solo comando Docker:
docker run -d --restart=always -p 8080:8080 -v /var/run/docker.sock:/var/run/docker.sock:ro --name dozzle amir20/dozzle:latest. La bandera:romonta el socket en modo de solo lectura: Dozzle solo puede leer los logs, no gobernar los contenedores. La imagen pesa unos 20 MB en la primera descarga. Dozzle arranca de inmediato, sin ninguna configuración inicial.Abrir la consola de logs
Vaya a
http://<your-server-ip>:8080. La barra lateral izquierda lista por nombre todos los contenedores en ejecución. Haga clic en cualquier contenedor para seguir sus logs en directo. Use la barra de búsqueda superior para filtrar por palabra clave, o pegue una regex para un filtrado avanzado.Activar la autenticación
Por defecto, Dozzle está abierto a cualquiera que pueda alcanzar el puerto 8080. Añada autenticación básica pasando variables de entorno:
--env DOZZLE_USERNAME=admin --env DOZZLE_PASSWORD=<strong-password>. Para un despliegue en equipo, configure OIDC creando un archivo de configuracióndozzle.ymly montándolo en/data/config.yamldentro del contenedor. Como mínimo, restrinja el puerto 8080 a su IP:ufw allow from <your-ip> to any port 8080.Opcional: HTTPS con Caddy
Para servir Dozzle por HTTPS en
logs.su-dominio.com, instale Caddy (apt install caddy) y cree/etc/caddy/Caddyfilecon:logs.su-dominio.com { reverse_proxy localhost:8080 }. Ejecutesystemctl reload caddyy Caddy emite automáticamente un certificado Let’s Encrypt. Antes, apunte el registro DNS A delogs.su-dominio.coma la IP de su VPS.Opcional: agentes multihost
Para supervisar los contenedores de varios servidores, ejecute Dozzle en modo agente en cada host remoto:
docker run -d --restart=always -p 7007:7007 -v /var/run/docker.sock:/var/run/docker.sock:ro --name dozzle-agent amir20/dozzle:latest agent. En su instancia principal de Dozzle, añada--env DOZZLE_REMOTE_AGENT=<agent-ip>:7007por cada host remoto. Todos los hosts aparecen entonces como nodos distintos en la barra lateral izquierda.Conectarse por primera vez
Dozzle se abre directamente sobre los registros de sus contenedores, sin ninguna credencial. Considere esa dirección como confidencial y protéjala antes de compartirla.
Combine Dozzle con Beszel para una visibilidad completa de sus contenedores
Dozzle le muestra *lo que* imprime su contenedor. Beszel le muestra *cuánta* CPU, RAM y disco consume, con gráficos históricos y alertas. Despliegue ambos en el mismo VPS —Dozzle para depurar los logs en directo, Beszel para seguir las tendencias de consumo— y obtendrá una pila de observabilidad de contenedores completa y autoalojada, por menos de 60 MB de RAM en total.
