Tutoriais de VPS
Configurar Fail2Ban: SSH, bloqueios progressivos e firewall
Configure arquivos locais, limites de falhas, bloqueios progressivos e uma lista administrativa restrita. Verifique logs, filtros e bloqueio real; acrescente jails Nginx e próprios, coordene UFW e Docker e entenda os limites de CDN e persistência.

Um serviço SSH exposto à internet costuma receber tentativas automáticas de acesso. Consulte os registros para entender a situação da sua máquina:
grep "Failed password" /var/log/auth.log | wc -l
As chaves SSH reduzem o risco de uma senha adivinhada. O Fail2Ban acrescenta detecção de falhas repetidas e solicita a uma ação de firewall, ou a outro mecanismo compatível, um bloqueio temporário. Ele complementa autenticação e filtragem de portas; não impede que um ataque distribuído chegue à sua rede.
- Um filtro lê arquivos ou o journal do sistema.
- As falhas atribuídas a um endereço atingem
maxretrydentro defindtime. - Uma ação aplica o bloqueio por
bantime.
O Fail2Ban delega a execução a uma ação, normalmente iptables ou nftables. Ações antigas de hosts.deny só funcionam com serviços que realmente aceitem TCP wrappers. Identificar uma falha e impedir uma nova conexão são etapas diferentes de verificação.
sudo grep -c "Failed password" /var/log/auth.log
sudo grep "Failed password" /var/log/auth.log | awk '{print $(NF-3)}' | sort | uniq -c | sort -rn | head -10
O segundo comando agrupa endereços em um formato específico de Failed password. Confira linhas reais porque as posições dos campos podem variar. Se auth.log não existe, consulte o journal; isso não demonstra ausência de tentativas.
sudo apt update
sudo apt install -y fail2ban
A versão depende da distribuição e dos repositórios. Números como 1.0.2 ou 1.1.1 são referências, não uma combinação universal de versões atuais de Ubuntu e upstream. Confira fail2ban-client --version e o suporte de segurança do pacote antes de mudar a origem da instalação.
sudo systemctl enable --now fail2ban
sudo systemctl status fail2ban
O jail sshd pode ou não vir habilitado, conforme o pacote. Confira os jails ativos: instalar o serviço não comprova proteção do SSH.
| Arquivo | Função |
|---|---|
/etc/fail2ban/jail.conf | Configuração base mantida pelo pacote |
/etc/fail2ban/jail.d/*.conf | Configuração adicional carregada depois da base |
/etc/fail2ban/jail.local | Ajustes próprios |
Preserve jail.conf e use jail.local ou arquivos locais adicionais. jail.d/*.local é lido depois de jail.local; confira a configuração efetiva em vez de presumir que jail.local sempre prevalece.
Salve qualquer configuração local existente antes do exemplo, pois tee substitui o arquivo. Acrescente seus endereços de administração e ajuste a porta SSH:
sudo tee /etc/fail2ban/jail.local > /dev/null <<'EOF'
[DEFAULT]
# 封禁时长(首次)
bantime = 1h
# 统计窗口
findtime = 10m
# 窗口内失败多少次就封
maxretry = 5
# 递增封禁:反复来的 IP 越封越久
bantime.increment = true
bantime.factor = 1
bantime.maxtime = 1w
# 白名单:自己的固定 IP 写这里,避免把自己封了
ignoreip = 127.0.0.1/8 ::1
[sshd]
enabled = true
backend = systemd
EOF
Mantenha uma sessão autenticada e o console do provedor disponíveis. Valide com sudo fail2ban-client -t antes de reiniciar:
sudo systemctl restart fail2ban
sudo fail2ban-client status
| Parâmetro | Referência comum | Significado |
|---|---|---|
bantime | 10m | Duração do bloqueio |
findtime | 10m | Janela de observação |
maxretry | 5 | Limite de falhas |
ignoreip | 127.0.0.1/8 ::1 | Endereços isentos |
bantime = 10m pode ser curto para um reincidente, mas bloqueios longos também ampliam o impacto de um falso positivo. Uma hora é um ponto inicial de política, sem garantia contra atacantes que trocam de endereço.
| Política | Exemplo | Compromisso |
|---|---|---|
| Tolerante | maxretry=10, findtime=10m, bantime=30m | Menor risco de bloquear usuários; admite mais falhas |
| Ponto inicial equilibrado | maxretry=5, findtime=10m, bantime=1h | Limite e duração moderados |
| Estrita | maxretry=3, findtime=1h, bantime=1d | Maior risco em redes compartilhadas e dinâmicas |
Evite a opção estrita se seu IP muda com frequência ou vários usuários legítimos compartilham a saída.
bantime.increment = true
bantime.factor = 1
bantime.maxtime = 1w
A fórmula exponencial pode aumentar a duração aproximadamente em 1, 2, 4, 8 e 16 vezes; histórico, fatores e multiplicadores alternativos influenciam o resultado. bantime.maxtime limita a duração máxima:
bantime.formula = ban.Time * (1<<(ban.Count if ban.Count<20 else 20)) * banFactor
A própria fórmula limita o deslocamento binário, portanto não significa duplicação literalmente infinita. Guarde histórico suficiente para a política desejada. bantime.rndtime acrescenta variação aleatória de tempo, sem resolver por si só uma botnet distribuída.
ignoreip = 127.0.0.1/8 ::1 203.0.113.5 198.51.100.0/24
Os endereços são exemplos de documentação: substitua pelos reais. A opção aceita IP, CIDR e resolução de nomes suportada. Separe valores por espaços e considere mudanças de DNS e endereço.
- Seu endereço fixo de administração, se houver.
- O servidor de salto administrativo.
- Monitoramento que realmente precise acessar o serviço protegido.
- Somente sub-redes internas confiáveis que precisem de isenção.
Não isente redes amplas sem verificar quem pode utilizá-las. ignoreself costuma valer true, ignorando os endereços do próprio servidor; confira o valor efetivo.
Se você se bloquear, use o console do provedor e fail2ban-client set sshd unbanip 你的IP, substituindo o exemplo pelo seu IP. Veja o guia de recuperação de acesso.
[sshd]
backend = systemd
| Backend | Origem | Considerações |
|---|---|---|
systemd | Journal do sistema | Precisa de integração e seleção de registros corretas |
auto | Escolha automática de backend de arquivos | Depende de módulos e versão |
pyinotify | Notificações de alterações em arquivos | Requer a integração Python correspondente |
polling | Consulta periódica de arquivos | Compatível, com atraso de leitura |
systemd atende quando o SSH escreve no journal em vez de /var/log/auth.log. auto não transforma automaticamente um caminho ausente em monitoramento do journal: confira erros de inicialização e a fonte utilizada.
Com systemd, utilize journalmatch em vez de logpath. O filtro costuma fornecer a seleção, mas o exemplo _SYSTEMD_UNIT=sshd.service deve corresponder à unidade real; alguns sistemas usam ssh.service. Valide uma mudança de backend contra uma falha registrada.
sudo fail2ban-client status
# 应该列出 sshd
sudo fail2ban-client status sshd
# 会显示当前封禁数量、总封禁数、以及被封的 IP 列表
# 用 systemd journal
sudo fail2ban-regex systemd-journal /etc/fail2ban/filter.d/sshd.conf
# 或者指定日志文件
sudo fail2ban-regex /var/log/auth.log /etc/fail2ban/filter.d/sshd.conf
Confira Lines: ... matched. Zero correspondências pode indicar filtro/origem incorretos ou uma amostra sem falhas. Use uma falha conhecida e confira horário, seleção do journal e endereço extraído.
sudo fail2ban-regex --print-all-matched systemd-journal /etc/fail2ban/filter.d/sshd.conf | head -30
# 看当前的 iptables 规则里有没有 f2b 链
sudo iptables -L -n | grep -A5 f2b
Uma cadeia f2b-sshd pode ser criada somente no primeiro bloqueio. Sua ausência antes disso não comprova erro; uma ação nftables exige examinar o conjunto nft. Verifique porta, família IPv4/IPv6 e caminho do tráfego.
Prepare console e desbloqueio. O laço é interativo e deve apontar para seu próprio servidor:
# 在测试机上故意输错
for i in $(seq 1 6); do ssh wronguser@your-server; done
Se senhas estão desabilitadas, produza falhas reconhecidas pelo filtro real sem habilitar senhas apenas para o teste.
sudo fail2ban-client status sshd
# 应该能看到那个 IP 出现在 Banned IP list 里
Confira a lista e uma conexão nova, depois desbloqueie o endereço de teste.
sudo tail -f /var/log/fail2ban.log
journalctl -u fail2ban -f
Procure Ban, erros da ação e Unban, além do estado do processo.
sshd é um dos disponíveis. Examine os filtros instalados:
ls /etc/fail2ban/filter.d/ | head -40
[nginx-http-auth]
enabled = true
port = http,https
logpath = %(nginx_error_log)s
maxretry = 5
bantime = 1h
Confira caminho e uma falha conhecida. Se o backend global é systemd, escolha um backend de arquivos para esse jail que lê error.log.
[nginx-botsearch]
enabled = true
port = http,https
logpath = %(nginx_error_log)s
nginx-botsearch reconhece padrões específicos do log. Ele não é um limitador geral de requisições; configure limites de taxa no Nginx quando necessário.
[wordpress]
enabled = true
filter = wordpress
port = http,https
logpath = /var/log/nginx/access.log
maxretry = 3
bantime = 2h
É necessário um filtro wordpress compatível e registros que distingam falhas de login. Um access.log com HTTP 200 tanto para sucesso quanto para falha não basta. Um plugin mantido que limite tentativas pode fornecer contexto da aplicação; teste a integração antes de habilitar o jail.
Observe o formato confiável do registro:
sudo tail -20 /var/log/myapp/auth.log
# 2026-09-29 10:23:11 FAILED login from 203.0.113.5 user=admin
Crie /etc/fail2ban/filter.d/myapp.conf:
[Definition]
failregex = ^.*FAILED login from <HOST>.*$
ignoreregex =
<HOST> extrai um endereço, mas não é o único requisito. Restrinja o padrão amplo do exemplo a um prefixo estruturado confiável, impedindo que texto controlado por usuários indique o IP de outra pessoa. Teste horários, IPv4/IPv6, falhas reais e exemplos negativos, como logins bem-sucedidos.
sudo fail2ban-regex /var/log/myapp/auth.log /etc/fail2ban/filter.d/myapp.conf
Ajuste com fail2ban-regex antes de habilitar o jail:
[myapp]
enabled = true
filter = myapp
port = http,https
logpath = /var/log/myapp/auth.log
maxretry = 5
findtime = 10m
bantime = 1h
Para uma política UFW existente, confira banaction. iptables-multiport é um exemplo comum, não o padrão atual de todas as distribuições. Cadeias e ordem dependem da ação e do backend efetivos.
limit do UFW limita tentativas de conexão; o Fail2Ban analisa falhas registradas. Os mecanismos podem se complementar. Se decidir trocar limit por allow, confira a regra exata, a porta personalizada e a nova permissão antes de excluir. O exemplo pode não corresponder a uma regra criada com outra grafia:
sudo ufw delete limit ssh
sudo ufw allow OpenSSH
Examine iptables/nftables, incluindo IPv6:
sudo iptables -L -n | grep f2b # 有输出说明 iptables 兼容层在工作
sudo nft list ruleset | grep f2b # 或者看 nftables 里有没有
Escolha uma ação suportada, como nftables-multiport, quando apropriado. Algumas criam regras somente com um bloqueio, então faça um teste controlado. Não use ufw disable como uma redefinição geral: alterações no UFW podem afetar acesso e bloqueios, conforme as regras existentes.
O tráfego publicado com -p 8080:8080 pode usar encaminhamento que não passa pelo bloqueio no INPUT do anfitrião. Uma aplicação privada pode vincular-se a 127.0.0.1 e receber acessos por um proxy no anfitrião:
ports:
- "127.0.0.1:8080:8080"
Leia os logs corretos e aplique o bloqueio no caminho correspondente. Isso não resolve automaticamente uma CDN: o par de rede ainda pode ser um nó da CDN, não o visitante.
Nenhum bloqueio: confira jail, falha conhecida e erros de ação:
# 1. jail 启用了吗
sudo fail2ban-client status
# 2. 能匹配到日志吗(最可能的问题)
sudo fail2ban-regex systemd-journal /etc/fail2ban/filter.d/sshd.conf
# 3. server 和 jail 的日志
sudo tail -50 /var/log/fail2ban.log
Zero resultados em fail2ban-regex exige verificar entrada, horário e filtro.
Desbloqueio muito rápido: examine bantime e Unban. 10m é uma referência; reinícios, mudanças de política e histórico também influenciam.
O endereço ainda conecta: confira encaminhamento, IPv6, portas, conexões estabelecidas e ordem. Com CDN, configure real_ip para aceitar cabeçalhos apenas de proxies conhecidos. Mudar o endereço registrado não muda a origem do pacote: bloquear visitantes atrás de uma CDN geralmente exige aplicar a medida no proxy/CDN. Não bloqueie nós compartilhados indiscriminadamente.
Failed to execute ban jail 'sshd' action ... 'iptables': se a ação realmente precisa do comando ausente, instale o pacote compatível:
sudo apt install -y iptables
Também pode ser necessário selecionar uma ação nftables. Instalar iptables não corrige todo desajuste de configuração.
Lista de bloqueios grande: investigue a causa antes de limpar. O segundo comando abaixo desbloqueia todos os jails, apesar do comentário ilustrativo sugerir apenas um:
# 解封单个
sudo fail2ban-client set sshd unbanip 203.0.113.5
# 全部解封某个 jail
sudo fail2ban-client unban --all
Prefira um desbloqueio específico quando possível.
Persistência após reiniciar: muitos pacotes já usam /var/lib/fail2ban/fail2ban.sqlite3. Confira dbfile e permissões em fail2ban.conf/fail2ban.local. Este fragmento com estilo de jail não habilita sozinho um banco de dados:
[DEFAULT]
dbpurgeage = 1d
dbpurgeage pertence à configuração do daemon. Um dia de histórico pode ser insuficiente para uma política progressiva de uma semana; ajuste o valor em fail2ban.local e teste a restauração. bantime.increment exige histórico utilizável: não presuma que todo reinício o apaga ou que toda instalação o preserva corretamente.
Falsos positivos: um IP de empresa, escola ou rede móvel pode representar várias pessoas. Aumente maxretry ou reduza bantime conforme o caso, mantendo uma isenção administrativa restrita.
CrowdSec e recursos: ele oferece outros fluxos de detecção e inteligência e exige componentes que apliquem as medidas. Escolha conforme a carga e sua capacidade operacional. O processo Python e o banco do Fail2Ban costumam ser modestos, mas o consumo varia com jails e volume, inclusive em uma VPS de 1 GB.
- Ajustes em
jail.localou arquivos locais, preservandojail.conf. -
bantimeadequado ao risco de bloqueio acidental, sem copiar 10m automaticamente. -
bantime.incremente históricodbpurgeagedo daemon verificados. -
ignoreiprestrito e atualizado. -
backend = systemdou origem real de arquivos confirmada. - Falha conhecida testada com
fail2ban-regex. -
iptables -L -n | grep f2bou ação nftables efetiva examinada. - Bloqueio e nova conexão verificados de um cliente de teste.
-
limitdo UFW coordenado deliberadamente. - Portas privadas Docker em
127.0.0.1quando apropriado. - Cabeçalhos
real_ipconfiáveis e aplicação da medida na fronteira correta.