Repolode
swissmakers

swissmakers/fail2ban-ui

Plataforma web para administrar Fail2Ban en uno o varios hosts Linux, incluidos bloqueos, jails, filtros y alertas.

Estrellas
381
Forks
42
Issues abiertos
4
Último commit
hace 9 días

¿Qué es?

Fail2Ban UI ofrece a los administradores una interfaz centralizada para las instancias de Fail2Ban que se ejecutan en uno o varios hosts Linux. No reemplaza a Fail2Ban: el daemon de Fail2Ban de cada host sigue tomando las decisiones de bloqueo, mientras que la interfaz se conecta a esas instancias para mostrar los jails activos y la actividad reciente de bloqueos y desbloqueos, y para realizar búsquedas y desbloqueos en todos los servidores.

La interfaz se conecta a cada host mediante un conector local, un conector SSH o un agente HTTP. Cada host envía eventos de bloqueo y desbloqueo a la interfaz mediante una acción personalizada de Fail2Ban. La interfaz los almacena, los envía en tiempo real a los navegadores conectados y puede activar alertas. También permite editar la configuración de jails y filtros en hosts remotos, probar expresiones regulares de filtros con líneas de registro y enviar bloqueos permanentes a firewalls MikroTik, pfSense, OPNsense y UniFi.

El proyecto se distribuye como un único binario Go, disponible como contenedor o servicio systemd, y admite inicio de sesión OIDC. Las alertas se pueden enviar por correo electrónico, webhook o Elasticsearch.

Funciones clave

  • 01Panel centralizado con los jails activos y eventos de bloqueo y desbloqueo en tiempo real mediante WebSocket
  • 02Buscar y desbloquear direcciones IP en todos los jails y servidores
  • 03Administrar la configuración de jails y filtros remotos, con recuperación de la configuración en caso de errores
  • 04Depurar filtros probando patrones en registros en tiempo real
  • 05Aplicar bloqueos permanentes y gestionar infractores recurrentes en MikroTik, pfSense, OPNsense y UniFi
  • 06Alertas por correo electrónico, webhook y Elasticsearch con enriquecimiento de GeoIP/Whois

Casos de uso

  • Administrar Fail2Ban en varios servidores Linux desde una única interfaz en el navegador
  • Revisar y desbloquear IP sin iniciar sesión en cada host
  • Probar expresiones regulares de filtros antes de implementar cambios en jails de producción
  • Enviar a un firewall las IP de atacantes reincidentes para bloquearlas permanentemente

Inicio rápido

  1. 1

    Ejecuta el contenedor con el conector local

    podman run -d --name fail2ban-ui --network=host \ -v /opt/fail2ban-ui:/config:Z \ -v /etc/fail2ban:/etc/fail2ban:Z \ -v /var/run/fail2ban:/var/run/fail2ban \ -v /var/log:/var/log:ro \ swissmakers/fail2ban-ui:latest
  2. 2

    Abre http://localhost:8080 en el navegador

  3. 3

    Ve a Settings -> Manage Servers, activa el conector local y haz clic en Test connection

Antes de usarlo

  • Requiere que Fail2Ban ya esté instalado en los hosts Linux; no sustituye a Fail2Ban.
  • El conector SSH necesita una cuenta de servicio dedicada con reglas sudo, por lo que la configuración requiere algo de trabajo.
  • Se recomienda ejecutarlo detrás de un proxy inverso, una VPN o un firewall, en lugar de exponerlo a Internet.

Temas

Preguntas frecuentes

¿Qué es fail2ban-ui?
Plataforma web para administrar Fail2Ban en uno o varios hosts Linux, incluidos bloqueos, jails, filtros y alertas. Fail2Ban UI ofrece a los administradores una interfaz centralizada para las instancias de Fail2Ban que se ejecutan en uno o varios hosts Linux. No reemplaza a Fail2Ban: el daemon de Fail2Ban de cada host sigue tomando las decisiones de bloqueo, mientras que la interfaz se conecta a esas instancias para mostrar los jails activos y la actividad reciente de bloqueos y desbloqueos, y para realizar búsquedas y desbloqueos en todos los servidores.
¿fail2ban-ui es gratuito? ¿Qué licencia tiene?
fail2ban-ui es open source bajo la licencia AGPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿fail2ban-ui sigue mantenido?
Mantenimiento activo. El último commit de fail2ban-ui fue el 11 oct 2026.
¿Para qué puedo usar fail2ban-ui?
Administrar Fail2Ban en varios servidores Linux desde una única interfaz en el navegador Revisar y desbloquear IP sin iniciar sesión en cada host Probar expresiones regulares de filtros antes de implementar cambios en jails de producción Enviar a un firewall las IP de atacantes reincidentes para bloquearlas permanentemente
¿Cómo se instala fail2ban-ui?
Ejecuta el contenedor con el conector local: podman run -d --name fail2ban-ui --network=host \ -v /opt/fail2ban-ui:/config:Z \ -v /etc/fail2ban:/etc/fail2ban:Z \ -v /var/run/fail2ban:/var/run/fail2ban \ -v /var/log:/var/log:ro \ swissmakers/fail2ban-ui:latest Abre http://localhost:8080 en el navegador Ve a Settings -> Manage Servers, activa el conector local y haz clic en Test connection
¿Dónde consigo fail2ban-ui?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/swissmakers/fail2ban-ui

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

Proyectos relacionados