O fail2ban protege o SSH lendo os registos de autenticação do sshd e bloqueando na firewall os IPs que falham demasiadas vezes. Para SSH, basta o /etc/fail2ban/jail.local com a jail [sshd] ativada, um maxretry baixo e um bantime sensato. Depois, verifica o resultado com fail2ban-client status sshd.

Como o fail2ban bloqueia ataques de força bruta ao SSH

O fail2ban lê os registos de autenticação do sshd e passa-os por um filtro de expressões regulares. Quando um IP acumula maxretry falhas dentro de findtime, o fail2ban executa uma ação que o bloqueia na firewall durante bantime. Quando esse tempo termina, a regra é removida automaticamente.

Convém ter claro o alcance. O fail2ban reduz o ruído e o custo das tentativas automáticas contra a porta TCP 22, mas não substitui a autenticação por chaves. Se o servidor aceitar palavras-passe fracas, um atacante que distribua as tentativas por muitos IPs pode continuar a tentar abaixo do limite de cada endereço.

Configurar a jail sshd do fail2ban no jail.local

A regra básica é nunca editar o /etc/fail2ban/jail.conf, porque as atualizações do pacote o sobrescrevem. As suas alterações pertencem ao /etc/fail2ban/jail.local, que o fail2ban lê a seguir e que tem prioridade.

Em Debian ou Ubuntu, instale o pacote e abra o ficheiro:

sudo apt install fail2ban
sudo nano /etc/fail2ban/jail.local

Uma configuração SSH mínima e realista:

[DEFAULT]
ignoreip = 127.0.0.1/8 ::1
bantime  = 1h
findtime = 10m
maxretry = 3
bantime.increment = true

[sshd]
enabled = true
port    = ssh
backend = systemd

port = ssh significa a porta 22. Se o sshd escutar noutra porta, indique o número real (port = 2222); caso contrário, os bloqueios recaem sobre uma porta que ninguém usa. backend = systemd faz com que o fail2ban leia o journal nas distribuições que não escrevem o /var/log/auth.log. Se o seu sistema escrever esse ficheiro, pode remover a linha. Ative o serviço e reinicie-o depois de cada alteração:

sudo systemctl enable --now fail2ban
sudo systemctl restart fail2ban

Num telemóvel, guardar e sair do nano exige Ctrl+O e Ctrl+X. O teclado do termi1, um terminal SSH para iOS e Android, tem Ctrl, Esc, Tab e teclas de seta, por isso editar o jail.local não o obriga a ir à procura de um portátil.

O que controlam bantime, findtime e maxretry no fail2ban

maxretry é o número de falhas permitidas, findtime é a janela em que são contadas e bantime é quanto tempo dura o bloqueio. Os dois últimos aceitam sufixos de tempo como m, h ou d.

  • maxretry = 3: com autenticação por chave, um utilizador legítimo quase nunca falha três vezes seguidas; um bot, sim.
  • findtime = 10m: três falhas espalhadas ao longo de uma hora não contam; três em dez minutos, sim.
  • bantime = 1h: tempo suficiente para o bot desistir e curto o bastante para não ficar bloqueado um dia inteiro se o engano for seu.
  • bantime.increment = true: cada reincidência do mesmo IP prolonga o banimento seguinte.

Um bantime negativo (-1) torna os banimentos permanentes. É tentador, mas a lista cresce sem limite, e um IP dinâmico mais tarde atribuído a um utilizador legítimo fica bloqueado para sempre.

Verificar o fail2ban com fail2ban-client status sshd

sudo fail2ban-client status sshd mostra o estado da jail. A secção Filter apresenta as falhas atuais e totais; a secção Actions apresenta os IPs banidos neste momento, o total de banimentos e a lista de endereços.

sudo fail2ban-client status
sudo fail2ban-client status sshd
sudo fail2ban-client get sshd bantime
sudo fail2ban-client set sshd unbanip 203.0.113.45
  • status sem argumentos lista as jails ativas. Se sshd não aparecer, falta enabled = true ou há um erro de sintaxe; consulte sudo journalctl -u fail2ban.
  • status sshd com zero falhas totais enquanto o journal mostra inícios de sessão falhados significa normalmente um backend ou um caminho de registo errado.
  • get sshd bantime confirma o valor que o fail2ban carregou de facto, e não aquele que julga ter escrito.
  • set sshd unbanip levanta o banimento de um único IP.

No termi1 pode ditar "desbloqueia o 203.0.113.45 no fail2ban": a IA escreve o comando no prompt sem premir Enter e, no modo Review, nunca o executa por si. Numa ligação marcada como produção, o Production Guard retém tudo o que pare ou altere algo, como systemctl restart, antes de chegar ao prompt.

fail2ban versus outras defesas SSH: tabela comparativa

A defesa que trava por completo a força bruta de palavras-passe é PasswordAuthentication no, documentada na referência oficial do sshd_config. O fail2ban é uma camada complementar.

MedidaO que travaO que não travaRisco de ficar bloqueado
Jail sshd do fail2banBots que repetem tentativas a partir de um único IPAtaques distribuídos por muitos IPsMédio se falhar várias vezes seguidas
Só chaves (PasswordAuthentication no)Adivinhação de palavras-passeRuído nos registosBaixo se mantiver uma segunda chave autorizada
Mudar o SSH da porta 22As análises automáticas mais básicasUma análise completa de portasBaixo; lembre-se de atualizar port no jail.local
Rede privada mesh, sem porta públicaQualquer tentativa direta a partir da internetAcesso a partir de dentro da meshBaixo enquanto a mesh funcionar

Evitar que o fail2ban bana a sua própria ligação SSH a partir do telemóvel

ignoreip lista os endereços que o fail2ban nunca bane e é a sua principal proteção contra banir-se a si próprio. O problema num telemóvel é que o IP muda: a rede wifi do escritório pode ter um endereço fixo, mas não é possível pôr os dados móveis na lista branca antecipadamente.

  1. Mantenha uma via alternativa antes de mexer na configuração. A consola web do seu fornecedor ou outra rede permitem-lhe executar unbanip se ficar bloqueado.
  2. Use chaves, não palavras-passe. Sem palavra-passe para escrever, não há gralhas a somar falhas. O termi1 gera a chave no próprio telemóvel, guarda-a no armazenamento seguro do sistema e a chave privada nunca sai do dispositivo.
  3. Entre por uma rede privada mesh. Com uma rede privada mesh sem portas abertas como a Prialo, ou com o Tailscale, chega a partir de um IP da mesh que não muda. Adicione o respetivo intervalo a ignoreip, ou deixe simplesmente de expor a porta 22 à internet.
  4. Perceba como o Mosh se liga. O Mosh inicia o mosh-server através de uma ligação SSH inicial, e as falhas nesse início de sessão contam para a jail sshd. Depois disso, o tráfego circula pelas portas UDP 60000-61000, que a jail não vigia. O termi1 mantém a sessão Mosh ativa quando passa da rede wifi para os dados móveis, o que significa menos religações e menos ocasiões para falhar.
  5. Execute tarefas longas dentro do tmux. Se uma regra o desligar, o que estava a correr continua lá quando voltar a entrar.

Perguntas frequentes

Onde se configura o fail2ban para SSH?

O fail2ban para SSH configura-se em /etc/fail2ban/jail.local, dentro de uma secção [sshd] com enabled = true. Não mexa no jail.conf, porque as atualizações do pacote o sobrescrevem. Depois de cada alteração, reinicie o serviço com sudo systemctl restart fail2ban para que os novos valores sejam carregados.

Que bantime se deve usar para SSH?

Um bantime de uma hora combinado com bantime.increment = true equilibra bem proteção e comodidade. Os bots seguem em frente, os reincidentes recebem banimentos progressivamente mais longos e um autobanimento por engano não lhe custa dias de acesso. Definir bantime como -1 torna todos os banimentos permanentes.

Como se desbloqueia um IP no fail2ban?

Para desbloquear um IP no fail2ban, use sudo fail2ban-client set sshd unbanip seguido do endereço. Primeiro, confirme com sudo fail2ban-client status sshd que ele aparece na lista de IPs banidos. Se o endereço banido for o seu, execute o comando a partir de outra rede ou da consola do seu fornecedor.

O fail2ban também protege as ligações Mosh?

O fail2ban protege a fase SSH do Mosh, porque o mosh-server é iniciado através de uma ligação SSH inicial cujas falhas o sshd regista. O tráfego seguinte circula pelas portas UDP 60000-61000, que a jail sshd não vigia, por isso restrinja esse intervalo na firewall.