haproxy-manager
Interfaz web auto-hospedada para gestionar HAProxy, obtener certificados Let's Encrypt y ejecutar clúster activo-pasivo con Keepalived en IP virtual compartida.
Ficha actualizada 18 sept 2026, 21:40 · upstream 10 sept 2026, 12:05 · release v1.95.0
Qué es haproxy-manager
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
haproxy-manager es una herramienta de gestión de balanceadores de carga que permite configurar servicios, administrar certificados SSL/TLS mediante Let's Encrypt y desplegar arquitecturas de alta disponibilidad. La solución se basa en un único archivo JSON para la configuración, eliminando la necesidad de bases de datos externas como PostgreSQL o Redis. Esto simplifica el mantenimiento, ya que las copias de seguridad consisten simplemente en replicar ese archivo entre nodos.
El sistema soporta despliegues en servidores bare-metal mediante paquetes .deb y .rpm, o en entornos Docker con imágenes multiplataforma (linux/amd64 y linux/arm64). La interfaz web proporciona un panel de control para publicar servicios, configurar reglas de enrutamiento, gestionar pools de servidores y monitorear el estado del clúster. Incluye soporte para autenticación básica, OIDC y 2FA, además de una gestión avanzada de certificados que permite reutilizar certificados salvavildcard o solicitar nuevos automáticamente.
La arquitectura soporta clústeres con Keepalived para garantizar la continuidad del servicio mediante una IP virtual compartida. La configuración se sincroniza entre nodos activos y pasivos a través de HTTPS, permitiendo un failover transparente. La interfaz es responsiva y soporta múltiples idiomas, adaptándose automáticamente al idioma del navegador.
- Gestión centralizada de balanceadores de carga HAProxy en entornos de producción
- Implementación de alta disponibilidad con Keepalived e IP virtual compartida
- Automatización de certificados SSL/TLS mediante Let's Encrypt y gestión de renovaciones
- Despliegue rápido en contenedores Docker o servidores bare-metal con paquetes oficiales
- No requiere bases de datos externas; la configuración persiste en un único archivo JSON
- Soporte nativo para clústeres activos-pasivos con Keepalived e IP virtual compartida
- Gestión automática de certificados Let's Encrypt con soporte para certificados salvavildcard
- Despliegue multiplataforma: Docker, paquetes .deb/.rpm y scripts de instalación
- Interfaz web responsiva con soporte para múltiples idiomas y autenticación segura (OIDC/2FA)
- Sincronización automática de configuración entre nodos del clúster vía HTTPS
- Dependencia de HTTPS para la sincronización del clúster entre nodos
- No soporta bases de datos externas para persistencia de configuración
- Requiere permisos de red específicos (NET_ADMIN, NET_BROADCAST, NET_RAW) en modo Docker
- La gestión de certificados no permite terminación TLS externa sin configuración manual
- Falta de soporte explícito para orquestadores como Kubernetes
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.
Para despliegue en Docker, usar la imagen ghcr.io/avandeputte/haproxy-manager:latest con volúmenes persistentes para datos, certificados ACME y configuraciones de HAProxy y Keepalived. Asegurar permisos de red host y capacidades NET_ADMIN, NET_BROADCAST y NET_RAW. Para servidores bare-metal, instalar paquetes .deb o .rpm oficiales o ejecutar el script install.sh. Configurar la IP virtual compartida en Keepalived y sincronizar certificados Let's Encrypt entre nodos.
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.