Tutoriais de VPS
O que fazer quando o Fail2Ban bloqueia seu VPS (2026): guia de autossocorro para quando o SSH não entra, unbanip e ignoreip
Depois de instalar o Fail2Ban em um VPS, o SSH de repente para de conectar — possivelmente porque seu próprio IP foi bloqueado por engano pelo jail do sshd. Causas comuns incluem senhas erradas acionando o maxretry, IPs dinâmicos não adicionados ao ignoreip, configuração de jail muito rígida e bans antigos restaurados do banco de dados após uma reinicialização. Este artigo percorre a solução camada por camada: autossocorro pelo console/VNC, fail2ban-client status, unbanip, ignoreip, jail.local, dbpurgeage e como evitar outro autobloqueio.

O Fail2Ban existe para evitar ataques de força bruta, mas com uma configuração descuidada ele também pode te deixar do lado de fora do seu próprio VPS.
O cenário mais típico: você erra a senha do SSH algumas vezes seguidas, ou muda para uma nova saída de rede, e de repente descobre:
ssh: connect to host x.x.x.x port 22: Connection refused
Connection timed out
Permission denied
Se o servidor não caiu e o serviço SSH não está quebrado, é muito provável que o Fail2Ban tenha adicionado seu IP à lista de bloqueios do jail sshd.
Este artigo não é sobre "como instalar o Fail2Ban", mas sobre como se recuperar depois de ter se bloqueado e como evitar que isso aconteça de novo.
Se você ainda tem uma sessão SSH aberta, ou consegue entrar por outro IP, primeiro verifique:
sudo fail2ban-client status
Depois veja o jail do SSH:
sudo fail2ban-client status sshd
Preste atenção em:
Currently banned: a quantidade atual de bloqueios;Banned IP list: a lista de IPs bloqueados;- se o seu IP público atual está nela.
Consulte seu próprio IP público:
curl -4 ifconfig.me
Se o seu IP estiver na lista, o serviço SSH não está quebrado: você foi bloqueado pelo Fail2Ban.
Se você ainda consegue entrar no VPS por outro IP, outro usuário, um jump host ou uma sessão preservada, desbloqueie diretamente:
sudo fail2ban-client set sshd unbanip 你的IP
Algumas versões também permitem desbloquear um IP de todos os jails:
sudo fail2ban-client unban 你的IP
Se for apenas um ambiente de teste e você quiser limpar temporariamente todos os bloqueios:
sudo fail2ban-client unban --all
Em produção, não execute unban --all sem pensar, porque isso também vai liberar IPs de atacantes reais.
Após desbloquear, teste novamente:
ssh root@你的服务器IP
Ou:
ssh 用户名@你的服务器IP
Se nenhuma conexão SSH funciona, você precisa de um login fora de banda:
- Console web do provedor de nuvem;
- VNC / noVNC;
- Serial Console;
- Rescue Mode;
- Console IPMI / KVM.
Após entrar, não comece a apagar regras de qualquer jeito; primeiro execute:
sudo fail2ban-client status sshd
sudo fail2ban-client set sshd unbanip 你的IP
Se o fail2ban-client não estiver disponível, pare o serviço temporariamente:
sudo systemctl stop fail2ban
Isso é apenas um socorro temporário. Assim que conseguir entrar por SSH de novo, corrija a configuração imediatamente, senão o Fail2Ban pode te bloquear novamente após uma reinicialização.
O local correto geralmente é:
sudo nano /etc/fail2ban/jail.local
Em [DEFAULT], adicione:
[DEFAULT]
ignoreip = 127.0.0.1/8 ::1 你的固定IP 你的VPN出口IP
Se você tem uma sub-rede fixa no escritório ou em casa, também pode usar CIDR:
ignoreip = 127.0.0.1/8 ::1 203.0.113.10 198.51.100.0/24
Após salvar, recarregue:
sudo fail2ban-client reload
Ou:
sudo systemctl reload fail2ban
Observação: ignoreip só protege contra bloqueios futuros; ele não necessariamente remove automaticamente um IP já bloqueado. Um IP já bloqueado ainda precisa primeiro de unbanip.
Arquivos comuns do Fail2Ban:
/etc/fail2ban/jail.conf
/etc/fail2ban/jail.local
/etc/fail2ban/jail.d/*.local
/etc/fail2ban/fail2ban.conf
O princípio é simples:
jail.confé a configuração padrão; não é recomendado editá-la, pois atualizações podem sobrescrevê-la;jail.localguarda a configuração de substituição local;jail.d/*.localé adequado para separar por serviço;fail2ban.confé a configuração do próprio Fail2Ban, que contém opções relacionadas ao banco de dados.
Uma configuração separada do SSH pode ser escrita assim:
[sshd]
enabled = true
port = ssh
maxretry = 3
findtime = 10m
bantime = 1h
Se você mudou o SSH para uma porta diferente da 22, atualize isto de acordo:
port = 2222
Caso contrário, o monitoramento e as ações de firewall do Fail2Ban podem não corresponder à sua porta SSH real.
Os três parâmetros principais:
| Parâmetro | Significado | Valores comuns |
|---|---|---|
maxretry | Número de falhas permitidas dentro da janela de tempo | 3-5 costumam ser usados para SSH |
findtime | Janela de tempo para contar as falhas | 10m |
bantime | Quanto tempo dura o bloqueio | 1h, 24h |
Se você configurar assim:
maxretry = 1
findtime = 1h
bantime = 1w
então é muito fácil se bloquear por uma semana.
Para um VPS pessoal, um ponto de partida relativamente seguro:
[sshd]
enabled = true
maxretry = 5
findtime = 10m
bantime = 1h
Se realmente houver muitos ataques, considere o bloqueio progressivo em vez de levar o bantime para várias semanas desde o início.
Há uma situação bem chata: você já se adicionou ao ignoreip e se desbloqueou, mas após reiniciar o Fail2Ban ou o servidor, você é bloqueado de novo.
A causa pode ser que registros de bloqueios antigos ainda estejam guardados no banco de dados do Fail2Ban.
Verifique a configuração:
sudo grep -n 'dbpurgeage\|dbfile' /etc/fail2ban/fail2ban.conf
dbpurgeage controla por quanto tempo os registros são mantidos no banco de dados. Se os registros antigos permanecerem, os bloqueios antigos podem ser restaurados após uma reinicialização.
Abordagem de diagnóstico:
sudo fail2ban-client status sshd
sudo fail2ban-client set sshd unbanip 你的IP
sudo systemctl reload fail2ban
Se ainda continuar acontecendo repetidamente, você pode parar o Fail2Ban temporariamente, verificar o banco de dados e a configuração, e então iniciá-lo novamente:
sudo systemctl stop fail2ban
sudo systemctl start fail2ban
Não apague arquivos de banco de dados sem entender o impacto. Em produção, eles também guardam registros de IPs de atacantes reais.
Em sistemas como Ubuntu 22.04/24.04 e Debian 12, muitos logs ficam no journald.
Você pode definir isto em [DEFAULT]:
backend = systemd
Depois recarregue:
sudo systemctl reload fail2ban
Se o backend não corresponder, dois problemas podem ocorrer:
- O Fail2Ban não lê os logs de falha de login SSH e não bloqueia nada;
- Um jail personalizado lê os logs errados e trata solicitações normais como ataques.
Antes de mudar o backend de logs, verifique primeiro os logs do Fail2Ban:
sudo journalctl -u fail2ban -n 100 --no-pager
sudo tail -n 100 /var/log/fail2ban.log
Os caminhos de log podem variar entre distribuições; em ambientes systemd, verifique primeiro journalctl.
Muitos autobloqueios não vêm do SSH, mas de jails personalizados para Nginx, Traefik, Caddy ou páginas de login de aplicações.
Por exemplo, enquanto você depura o login do painel, recebe 401/403 repetidos, que o Fail2Ban identifica como ataque:
sudo fail2ban-client status
sudo fail2ban-client status nginx-http-auth
sudo fail2ban-client status 自定义jail名
Desbloquear nem sempre se resume a sshd; depende do jail específico:
sudo fail2ban-client set nginx-http-auth unbanip 你的IP
Se você acessa a origem por meio do Cloudflare, de um proxy reverso ou de um balanceador de carga, confirme também se a aplicação recebe o IP real do cliente ou o IP do proxy. Caso contrário, o Fail2Ban pode bloquear o alvo errado.
Para problemas de origem com o Cloudflare, consulte: O que fazer quando o site no VPS mostra Cloudflare 521 / 522.
Antes de habilitar o Fail2Ban, recomenda-se fazer três coisas primeiro:
- Confirmar que você consegue entrar pelo console/VNC do provedor de nuvem;
- Adicionar seu IP fixo ou saída VPN ao
ignoreip; - Manter uma sessão SSH atual aberta e não desconectá-la imediatamente.
Após habilitar, teste:
sudo fail2ban-client status
sudo fail2ban-client status sshd
sudo journalctl -u fail2ban -n 50 --no-pager
Não configure maxretry muito baixo e bantime muito longo quando você tem apenas uma saída de rede, sem acesso ao console e sem lista branca.
Se você suspeita que o Fail2Ban te bloqueou, siga esta ordem:
- Troque de rede ou entre no VPS usando uma sessão SSH preservada.
- Execute
fail2ban-client statuspara ver quais jails existem. - Execute
fail2ban-client status sshdpara ver se seu IP está bloqueado. - Execute
fail2ban-client set sshd unbanip 你的IPpara desbloquear. - Se o SSH estiver totalmente inacessível, use o VNC/console/modo de resgate do provedor de nuvem.
- Adicione
ignoreipa[DEFAULT]em/etc/fail2ban/jail.local. - Verifique se
maxretry/findtime/bantimeestá agressivo demais. - Verifique se um jail personalizado de Nginx/Traefik está te bloqueando por engano.
- Se você for bloqueado de novo após reiniciar, verifique
dbpurgeagee a persistência do banco de dados. - Após recarregar, mantenha uma sessão SSH aberta para testar; não a desconecte imediatamente.
O autobloqueio do Fail2Ban não é um evento improvável, especialmente em VPS novos, durante o endurecimento de segurança, ao mudar a porta SSH ou ao depurar um proxy reverso.
Para uma emergência, primeiro use fail2ban-client status para encontrar o jail, depois set sshd unbanip para desbloquear; se o SSH estiver totalmente inacessível, recorra ao console do provedor de nuvem. A correção de longo prazo depende de ignoreip, de um maxretry/findtime/bantime razoável, do jail.local correto e da compreensão da persistência do banco de dados. O Fail2Ban é uma boa ferramenta, mas só se você não deixar que ele feche a porta na sua cara primeiro.