Ir para o conteúdo

Digite pelo menos 2 letras.

Fail2ban: o que é, como funciona e como ele bloqueia ataques no seu servidor

Fail2ban bloqueando ataques e robôs no servidor
Neste guia
  1. O que é o fail2ban
  2. Como o fail2ban funciona por dentro
  3. Os comandos do dia a dia
  4. Configuração básica: o jail.local
  5. O que os logs de ataque me ensinaram
  6. Cuidado para não banir você mesmo
  7. Fail2ban e WordPress
  8. Perguntas frequentes

Coloque um site no ar e, em poucas horas, ele estará sendo atacado. Não é pessoal: são milhares de robôs varrendo a internet atrás de senha fraca, arquivo esquecido e plugin desatualizado. O fail2ban é a ferramenta que separa esse ruído do tráfego de verdade e bane automaticamente quem está atacando. Ele é a base da defesa de todos os meus servidores. Neste artigo eu explico como ele funciona, os comandos que você vai usar e as regras que eu aprendi lendo anos de logs de ataque. Mais abaixo estão os vídeos, incluindo um robô pego no ato.

O que é o fail2ban

O fail2ban é um programa de código aberto para servidores Linux que lê os logs (os registros de acesso e de erro), procura padrões de ataque e, quando encontra, bloqueia o IP responsável no firewall por um tempo. Os casos clássicos:

  • alguém errando a senha do SSH dezenas de vezes;
  • um robô tentando logins no WordPress em sequência;
  • um scanner procurando arquivos como .env e .git;
  • um mesmo IP pedindo páginas demais em pouco tempo.

O código e a documentação estão no repositório oficial do fail2ban.

Como o fail2ban funciona por dentro

São três peças:

  • Filtro: uma expressão que reconhece uma linha de ataque no log. Por exemplo: “linha de acesso pedindo /.env”.
  • Jail (cela): junta um filtro, o log que ele lê e as regras do bloqueio. É a unidade que você liga e desliga.
  • Ação: o que fazer quando a regra dispara. Quase sempre, uma regra no firewall bloqueando o IP.

E três números definem cada jail:

Parâmetro O que define Exemplo
maxretry Quantas ocorrências até banir 5 tentativas
findtime Em quanto tempo essas ocorrências contam em 10 minutos
bantime Quanto tempo o IP fica banido por 1 hora

Traduzindo o exemplo: errou a senha 5 vezes em 10 minutos, fica 1 hora sem acesso.

Os comandos do dia a dia

# Quais jails estão ativas
sudo fail2ban-client status

# Quem está banido numa jail (ex.: sshd)
sudo fail2ban-client status sshd

# Desbanir um IP
sudo fail2ban-client set sshd unbanip 203.0.113.10

# Testar um filtro contra um log antes de ativar
sudo fail2ban-regex /var/log/nginx/access.log /etc/fail2ban/filter.d/nginx-varredura.conf

Configuração básica: o jail.local

Nunca edite o jail.conf: ele é sobrescrito nas atualizações. As suas regras vão no /etc/fail2ban/jail.local:

[DEFAULT]
bantime  = 1h
findtime = 10m
maxretry = 5
# Seu IP nunca é banido
ignoreip = 127.0.0.1/8 SEU.IP.AQUI

[sshd]
enabled = true

# Quem é banido várias vezes volta para um banimento longo
[recidive]
enabled  = true
bantime  = 1w
findtime = 1d

Depois de mudar, recarregue com sudo fail2ban-client reload.

O que os logs de ataque me ensinaram

Configuração básica protege o SSH. Mas o ataque de verdade, hoje, está na web. Foi lendo anos de logs reais que montamos as cerca de 50 jails que o GW Server traz prontas. Três lições valem para qualquer servidor.

1. Varredura não é erro de digitação

Errar a senha acontece com qualquer um. Pedir /.env não: ninguém procura o arquivo de senhas de uma aplicação por acidente. Por isso eu separo as duas coisas. Login errado leva um bloqueio curto. Procurar brecha leva bloqueio longo, que cresce a cada volta.

Exemplo de filtro para quem procura .env e .git num servidor nginx:

# /etc/fail2ban/filter.d/nginx-varredura.conf
[Definition]
failregex = ^<HOST> - \S+ \[[^\]]+\] "(?:GET|POST|HEAD) /(?:\.env|\.git/)

E a jail dele, banindo na primeira tentativa:

[nginx-varredura]
enabled  = true
port     = http,https
filter   = nginx-varredura
logpath  = /var/log/nginx/access.log
maxretry = 1
bantime  = 7d

Teste o filtro com o fail2ban-regex antes de ativar. E se a sua versão do fail2ban for a 0.11 ou mais nova, a opção bantime.increment = true faz o tempo de banimento crescer sozinho para quem reincide.

📊 Dados Reais

Por que o bloqueio de quem procura brecha ficou longo: medindo num servidor real, a maior parte dos IPs banidos por 24 horas voltava assim que o bloqueio vencia, e um deles derrubou o desempenho de um site justamente numa dessas voltas. Hoje, no GW Server, quem procura .env, .git ou backdoor em PHP fica 7 dias banido, e o tempo dobra a cada retorno, até 30 dias.

Medido em: servidores de produção da Gerenciando Web, registrado na documentação do GW Server (2026).

2. O robô não sabe o que você instalou

Eu instalei um Mautic antes de sair para almoçar. Duas horas depois, o próprio rastreador de visitas do Mautic mostrava um robô varrendo a instalação: procurava sitemap, .env, wp-config.php, wp-config.backup, .git, docker-compose. Ou seja, falhas de WordPress e de aplicações Docker num site que não era nem uma coisa nem outra.

A lição: as regras de varredura de uma aplicação valem para todas. Desde então, o servidor aplica no Mautic, no n8n e nas outras aplicações as mesmas regras contra varredura de WordPress e de Docker.

3. Fail2ban sozinho não é a defesa inteira

O fail2ban age depois do primeiro sinal de ataque. Antes dele, outras camadas tiram muito peso do servidor:

  • Firewall de portas: só ficam abertas as portas em uso.
  • Bloqueio geográfico: recusar tráfego de países de onde você não tem cliente e de onde vem boa parte dos robôs. Eu não tenho comprador na Rússia nem na China, e esse bloqueio, na minha experiência, corta a grande maioria das varreduras.
  • Senha forte e verificação em duas etapas no painel e no WordPress.
  • Cloudflare, para quem quer ir além: dá para o servidor aceitar conexões só da Cloudflare, e ninguém acessa o IP de origem direto. Explico no guia de DNS da Cloudflare.

Veja as camadas configuradas, uma a uma:

Cuidado para não banir você mesmo

💡 Dica do Gabriel

Já aconteceu aqui. Rodando um levantamento das páginas de um site nosso, com um pedido a cada pouco mais de um segundo, a jail contra excesso de acessos baniu o IP do nosso escritório em menos de dois minutos. E como o banimento vale para o servidor inteiro, todos os sites daquele servidor sumiram para a nossa internet. O fail2ban estava certo: aquilo parecia um ataque. Coloque o seu IP na lista de liberados e, em testes que geram muito acesso, vá devagar ou desligue a proteção do site durante o teste.

Outra regra de ouro: deixe uma porta de saída. No GW Server, nenhum banimento fecha a porta do SSH, que fica coberta só pela jail própria dele. Se um dia o painel parar de responder para você, o SSH continua de pé para você se liberar.

Fail2ban e WordPress

Para o WordPress, o fail2ban é mais eficiente que plugin de segurança: o bloqueio acontece no servidor, antes de o WordPress gastar processamento com o atacante. As jails que fazem mais diferença são as de login em sequência, robôs procurando plugins vulneráveis e acessos em excesso. Em área de membros ou loja, onde clientes erram a senha com frequência, vale afrouxar a regra de login. Eu reuni o resto da proteção no guia de segurança do WordPress, e se o estrago já aconteceu, em como limpar um site WordPress hackeado.

O SSH também merece atenção própria: chave em vez de senha e um bom cliente para conectar, como eu mostro em acesso SSH ao servidor.

Quero meu servidor protegido desde a instalação →

Perguntas frequentes

O fail2ban substitui o firewall?

Não, ele trabalha junto. O firewall decide quais portas ficam abertas para todo mundo. O fail2ban observa o comportamento de quem usa essas portas e fecha a porta só para quem está atacando, por um tempo. Na prática, quem executa o bloqueio é o próprio firewall, comandado pelo fail2ban.

Como desbanir um IP no fail2ban?

Use o comando sudo fail2ban-client set NOME-DA-JAIL unbanip ENDERECO-IP. Para descobrir em qual jail o IP está, rode sudo fail2ban-client status para ver as jails e sudo fail2ban-client status NOME-DA-JAIL para ver os IPs banidos em cada uma.

O fail2ban pode me bloquear do meu próprio servidor?

Pode, se você errar a senha várias vezes ou rodar algum teste que pareça ataque. Para evitar, coloque o seu IP na lista de liberados (ignoreip). E deixe sempre uma porta de entrada, como o SSH com chave, coberta só pela jail própria dele, para conseguir se destravar.

O fail2ban protege o WordPress?

Protege muito bem, desde que tenha jails para ele: tentativas de login em sequência, robôs procurando plugins vulneráveis e acessos em excesso. Como ele age no servidor, o bloqueio acontece antes do WordPress gastar processamento com o atacante, o que é mais leve que um plugin de segurança.

Continue lendo