Fail2ban: o que é, como funciona e como ele bloqueia ataques no seu servidor
Neste guia
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
.enve.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.
