nginx-webui
Interfaz web ligera para gestionar proxies inversos de nginx sin base de datos. Utiliza Flask + Docker con un agente host para control remoto, permitiendo edición de config, TLS y logs.
Ficha actualizada 22 sept 2026, 16:14 · upstream 9 sept 2026, 13:59 · release v0.1.0
Qué es nginx-webui
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
nginx-webui es una interfaz web minimalista diseñada para la gestión diaria de servidores nginx reverse proxy. Proporciona un dashboard que centraliza tareas como la creación de sitios, configuración de certificados TLS, validación de sintaxis con 'nginx -t' y visualización de logs en tiempo real. Su arquitectura se basa en Flask y JavaScript vanilla, sin dependencias complejas ni bases de datos, manteniendo un consumo de memoria bajo (~40 MB RAM).
El sistema opera mediante un agente de control en el host que permite a la interfaz web (ejecutada en contenedor o local) enviar comandos al proceso nginx del sistema anfitrión. Esto es crucial para operaciones como reinicios o validaciones, ya que los contenedores Docker no pueden acceder directamente al PID namespace del servicio systemd. La herramienta soporta tanto despliegues en contenedores Docker como instalaciones nativas (bare-metal).
Incluye funcionalidades avanzadas como un almacén de certificados SSL reutilizable, edición directa de archivos de configuración bajo /etc/nginx con protección contra traversal, y autenticación básica con bloqueo por fuerza bruta. La interfaz es compatible con temas oscuros y claros, y se integra con Let's Encrypt mediante rutas automáticas amigables.
- Gestión centralizada de múltiples sitios proxy inversos sin editar archivos manualmente en el servidor.
- Configuración y renovación de certificados TLS/SSL con almacenamiento persistente de claves.
- Validación rápida de sintaxis de configuración nginx mediante la herramienta 'nginx -t' desde la web.
- Visualización y filtrado de logs de acceso y error para depuración en tiempo real.
- Realización de backups automáticos de la configuración y restauración tras fallos.
- Control remoto de reinicios (reload/restart) del servicio nginx sin acceso SSH directo.
- Arquitectura ligera basada en Flask + Vanilla JS, sin necesidad de Node.js ni compilación.
- Gestión remota mediante agente host que permite control total sobre el proceso nginx del sistema.
- Almacenamiento persistente de certificados SSL y claves para reutilización entre sitios.
- Interfaz con modo oscuro/claro y persistencia de preferencias en el navegador.
- Autenticación robusta con bloqueo temporal tras 5 intentos fallidos (fuerza bruta).
- Compatibilidad nativa con distros Linux principales: Debian, Ubuntu, RHEL, Fedora, Arch.
- Requiere acceso sudo o root para ejecutar comandos críticos como 'systemctl restart nginx'.
- Autenticación mediante contraseña compartida global, sin soporte nativo para múltiples usuarios.
- Dependencia de Python 3.10+ en modo manual o contenedorizado.
- En modo Docker, es obligatorio instalar y configurar el agente host_agent.py en el sistema anfitrión.
- La sesión de autenticación expira tras 30 minutos si no se marca 'Remember me'.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Ejecutar primero './install.sh --check' para validar dependencias sin cambios. Configurar obligatoriamente la variable WEBUI_PASSWORD en el archivo .env para habilitar autenticación. En despliegues Docker, usar docker compose up -d tras copiar el agente host_agent.py al sistema anfitrión y activarlo como systemd service. Asegurar que los puertos 8400 (API) y 9401 (Agente Host) estén abiertos en el firewall.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.