Repolode
swissmakers

swissmakers/fail2ban-ui

Plataforma web para gerenciar o Fail2Ban em um ou mais hosts Linux, incluindo bans, jails, filtros e alertas.

Estrelas
381
Forks
42
Issues abertas
4
Último commit
há 8 dias

O que é?

O Fail2Ban UI oferece aos administradores uma interface centralizada para instâncias do Fail2Ban em um ou mais hosts Linux. Ele não substitui o Fail2Ban: as decisões de ban continuam sendo tomadas pelo daemon do Fail2Ban em cada host, enquanto a interface se conecta a essas instâncias para exibir as jails ativas e a atividade recente de ban e unban, além de permitir pesquisas e unbans em todos os servidores.

A interface acessa cada host por meio de um conector local, SSH ou um agente HTTP. Cada host envia eventos de ban e unban de volta à interface por meio de uma action personalizada do Fail2Ban. A interface os armazena, envia atualizações em tempo real aos navegadores conectados e pode disparar alertas. Também permite editar configurações de jails e filtros em hosts remotos, testar regex de filtros com linhas de log e aplicar bloqueios permanentes em firewalls MikroTik, pfSense, OPNsense e UniFi.

O projeto é distribuído como um único binário Go, disponível como contêiner ou serviço systemd, e oferece suporte a login OIDC. Os alertas podem ser enviados por email, webhook ou Elasticsearch.

Recursos principais

  • 01Painel centralizado com jails ativas e eventos de ban/unban em tempo real via WebSocket
  • 02Pesquisar e remover bans de endereços IP em todas as jails e servidores
  • 03Gerenciar configurações remotas de jails e filtros, com recuperação de configurações inválidas
  • 04Depuração de filtros com testes de padrões de log em tempo real
  • 05Bloqueios permanentes e gerenciamento de reincidentes em MikroTik, pfSense, OPNsense e UniFi
  • 06Alertas por email, webhook e Elasticsearch com enriquecimento GeoIP/Whois

Casos de uso

  • Gerenciar o Fail2Ban em vários servidores Linux por uma única interface no navegador
  • Revisar e remover bans de IPs sem fazer login em cada host
  • Testar regex de filtros antes de implantar alterações em jails de produção
  • Aplicar bloqueios permanentes no firewall para IPs de atacantes reincidentes

Início rápido

  1. 1

    Execute o contêiner com o 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

    Abra http://localhost:8080 no navegador

  3. 3

    Acesse Settings -> Manage Servers, ative o conector local e clique em Test connection

Antes de usar

  • Requer uma instalação existente do Fail2Ban em hosts Linux; não substitui o Fail2Ban.
  • O conector SSH precisa de uma conta de serviço dedicada com regras sudo, então a configuração exige algum esforço.
  • Recomenda-se executá-lo atrás de um proxy reverso, VPN ou firewall, em vez de expô-lo à Internet pública.

Tópicos

Perguntas frequentes

O que é fail2ban-ui?
Plataforma web para gerenciar o Fail2Ban em um ou mais hosts Linux, incluindo bans, jails, filtros e alertas. O Fail2Ban UI oferece aos administradores uma interface centralizada para instâncias do Fail2Ban em um ou mais hosts Linux. Ele não substitui o Fail2Ban: as decisões de ban continuam sendo tomadas pelo daemon do Fail2Ban em cada host, enquanto a interface se conecta a essas instâncias para exibir as jails ativas e a atividade recente de ban e unban, além de permitir pesquisas e unbans em todos os servidores.
fail2ban-ui é gratuito? Qual é a licença?
fail2ban-ui é open source sob a licença AGPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
fail2ban-ui ainda é mantido?
Manutenção ativa. O último commit de fail2ban-ui foi em 11 de out. de 2026.
Para que posso usar fail2ban-ui?
Gerenciar o Fail2Ban em vários servidores Linux por uma única interface no navegador Revisar e remover bans de IPs sem fazer login em cada host Testar regex de filtros antes de implantar alterações em jails de produção Aplicar bloqueios permanentes no firewall para IPs de atacantes reincidentes
Como instalar fail2ban-ui?
Execute o contêiner com o 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 Abra http://localhost:8080 no navegador Acesse Settings -> Manage Servers, ative o conector local e clique em Test connection
Onde consigo fail2ban-ui?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/swissmakers/fail2ban-ui

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados