Como instalar e configurar o Fail2ban num VPS Debian ou Ubuntu?
Instalar o Fail2ban, escrever um jail.local para SSH e nginx, banir e desbanir um IP, ler o estado das jaulas e evitar os erros mais comuns com nftables ou
O Fail2ban lê os registos dos seus serviços e bane, durante um tempo definido, os endereços IP que acumulam falhas: palavras-passe SSH testadas em ciclo, varrimentos de páginas de administração, autenticações web falhadas. Num VPS exposto à Internet, as tentativas na porta 22 começam poucos minutos após a entrega. Este guia instala o Fail2ban no Debian 12 / 13 ou no Ubuntu 22.04 / 24.04, protege o SSH e o nginx e depois mostra como verificar, banir e desbanir um endereço.
Procedimento passo a passo
-
Instalar o Fail2ban
Atualize a lista de pacotes e depois instale o fail2ban com o nftables e o python3-systemd, que lhe permitem banir com o nftables e ler o diário do systemd. O serviço arranca de imediato com a configuração predefinida.
-
Criar o ficheiro jail.local
Nunca altere /etc/fail2ban/jail.conf, que é substituído a cada atualização. Escreva as suas definições em /etc/fail2ban/jail.local: duração do banimento, janela de observação, número de falhas, endereços que nunca devem ser banidos e ação do nftables.
-
Proteger o SSH
Ative a jaula [sshd] com backend = systemd: no Debian, o SSH escreve no diário do systemd e o ficheiro /var/log/auth.log muitas vezes não existe. Se o SSH escutar numa porta diferente da 22, indique-a com port.
-
Adicionar as jaulas do nginx
Se o nginx estiver a correr no VPS, ative nginx-http-auth para as palavras-passe de autenticação HTTP falhadas e nginx-botsearch para os robôs que procuram páginas de administração. Estas duas jaulas leem /var/log/nginx/error.log.
-
Testar e reiniciar
Verifique a sintaxe com fail2ban-client -t, reinicie com systemctl restart fail2ban e depois liste as jaulas ativas com fail2ban-client status.
-
Verificar, banir e desbanir
fail2ban-client status sshd mostra as falhas contabilizadas e os endereços banidos. fail2ban-client set sshd unbanip 198.51.100.7 liberta um endereço e fail2ban-client set sshd banip 198.51.100.7 bane-o manualmente.
Instalação no Debian e no Ubuntu
apt update
apt install -y fail2ban nftables python3-systemd
systemctl enable --now fail2ban
fail2ban-client version
/etc/fail2ban/jail.local
[DEFAULT]
bantime = 1h
findtime = 10m
maxretry = 5
bantime.increment = true
bantime.maxtime = 1w
ignoreip = 127.0.0.1/8 ::1 203.0.113.10
banaction = nftables-multiport
banaction_allports = nftables-allports
[sshd]
enabled = true
port = ssh
backend = systemd
journalmatch = _SYSTEMD_UNIT=ssh.service + _COMM=sshd + _COMM=sshd-session
maxretry = 4
[nginx-http-auth]
enabled = true
[nginx-botsearch]
enabled = true
Testar e aplicar a configuração
fail2ban-client -t
systemctl restart fail2ban
fail2ban-client status
fail2ban-client status sshd
Banir, desbanir e listar endereços
fail2ban-client banned
fail2ban-client set sshd banip 198.51.100.7
fail2ban-client set sshd unbanip 198.51.100.7
fail2ban-client unban 198.51.100.7
nft list table inet f2b-table
Verificar se um filtro reconhece as falhas
fail2ban-regex systemd-journal sshd
fail2ban-regex /var/log/nginx/error.log nginx-botsearch
tail -n 50 /var/log/fail2ban.log
Variante com UFW
[DEFAULT]
banaction = ufw
banaction_allports = ufw
Antes de começar
Ligue-se como root com ssh root@IP, ou acrescente sudo antes de cada comando. Anote o endereço IP público a partir do qual administra o VPS e coloque-o em ignoreip: caso contrário, enganar-se algumas vezes a escrever a sua própria palavra-passe basta para se banir a si mesmo.
- O Fail2ban complementa o acesso SSH por chave, não o substitui: depois de instalar a chave, desative a autenticação por palavra-passe (veja « O que proteger antes da minha primeira implementação VPS? »).
- Os endereços 203.0.113.10 e 198.51.100.7 dos exemplos são endereços de documentação: substitua-os pelos seus.
- Se ficar bloqueado, a consola noVNC do painel ACLClouds não passa pelo SSH: permite-lhe sempre desbanir o seu endereço.
Compreender as definições do jail.local
Uma jaula associa um filtro (as expressões que reconhecem uma falha num registo), uma fonte de registos e uma ação de banimento. A secção [DEFAULT] define os valores comuns e cada jaula pode substituí-los.
- maxretry, findtime e bantime: aqui, 5 falhas em 10 minutos dão um banimento de uma hora; para o SSH bastam 4 falhas.
- bantime.increment = true prolonga o banimento a cada reincidência, até bantime.maxtime (uma semana).
- ignoreip aceita endereços e intervalos separados por espaços, tanto em IPv4 como em IPv6.
- banaction = nftables-multiport cria a tabela inet f2b-table no nftables e bloqueia nela os endereços banidos, tanto em IPv4 como em IPv6, nas portas da jaula.
- backend = systemd e journalmatch fazem com que a jaula [sshd] leia o diário do systemd e não um ficheiro. A linha journalmatch cobre o Ubuntu e o Debian, incluindo o OpenSSH 10 no Debian 13, onde as mensagens vêm de sshd-session.
Fail2ban com nftables ou UFW
O Debian 12 e 13 usam o nftables. A ação nftables-multiport funciona aí sem mais nenhuma definição, mesmo com o UFW instalado: o Fail2ban mantém as suas regras na sua própria tabela. No Ubuntu, pode preferir a ação ufw (bloco « Variante com UFW ») para ver os banimentos em ufw status.
O Fail2ban bloqueia o tráfego que entra no próprio VPS. As portas publicadas pelo Docker passam pela cadeia FORWARD e escapam a estas regras: para proteger um serviço num contentor, use banaction = iptables-multiport e acrescente chain = DOCKER-USER na respetiva jaula.
Erros comuns a evitar
A maioria das instalações que « não banem nada » tem uma destas causas. fail2ban-client status sshd permite distingui-las: se Total failed se mantiver a 0 enquanto chegam tentativas, o filtro não está a ler o registo certo.
- Alterar jail.conf em vez de jail.local: as alterações desaparecem na próxima atualização do pacote.
- Ativar uma jaula do nginx sem o nginx instalado: o ficheiro de registo não existe e o Fail2ban recusa-se a arrancar.
- Mudar a porta SSH sem atualizar port em [sshd]: o endereço é banido na porta 22, não na nova.
- Esquecer o próprio endereço em ignoreip e depois banir-se a si mesmo durante os testes.
- Escrever backend = systemd em [DEFAULT]: as jaulas do nginx, que leem ficheiros, deixam de ver o que quer que seja.
Verificação rápida
- systemctl is-active fail2ban responde active.
- fail2ban-client status lista sshd e, se o nginx estiver instalado, as jaulas do nginx.
- fail2ban-regex systemd-journal sshd encontra linhas correspondentes.
- O seu próprio endereço IP consta de ignoreip.
- nft list table inet f2b-table mostra os endereços banidos.
Perguntas frequentes
O Fail2ban não arranca e mostra Have not found any log file for sshd jail: o que fazer?
A jaula procura /var/log/auth.log, que não existe quando o SSH escreve apenas no diário do systemd, o que é comum no Debian. Acrescente backend = systemd na secção [sshd] de jail.local, instale python3-systemd e volte a executar systemctl restart fail2ban.
Como desbanir um endereço IP com o Fail2ban?
Execute fail2ban-client set sshd unbanip 198.51.100.7 substituindo a jaula e o endereço, ou fail2ban-client unban 198.51.100.7 para o retirar de todas as jaulas. Se for o seu próprio endereço e o SSH já não responder, ligue-se pela consola noVNC do painel para executar o comando.
Como ver os endereços banidos?
fail2ban-client status sshd mostra o número de endereços banidos e a respetiva lista para uma jaula; fail2ban-client banned apresenta-os para todas as jaulas. Do lado do firewall, nft list table inet f2b-table mostra os conjuntos de endereços bloqueados.
No Ubuntu 24.04, o Fail2ban para com No module named 'asynchat': porquê?
A primeira versão do Fail2ban incluída no Ubuntu 24.04 não era compatível com o Python 3.12. A correção está publicada nos repositórios: execute apt update && apt install --only-upgrade fail2ban e depois systemctl restart fail2ban.
Chegam tentativas, mas Total failed mantém-se a 0: o que verificar?
O filtro não está a ler as mensagens certas. Teste-o com fail2ban-regex systemd-journal sshd: a linha Lines: ... matched tem de ser superior a 0. Caso contrário, verifique backend = systemd e a linha journalmatch da jaula [sshd] e, depois, o nome do serviço com systemctl status ssh.
O Fail2ban basta para proteger um VPS?
Não. Reduz o ruído dos ataques de força bruta e alivia os registos, mas uma chave SSH, o acesso por palavra-passe desativado, um firewall que só deixa passar as portas necessárias e atualizações regulares continuam a ser indispensáveis.