Deep Dive: fail2ban – de uma linha de log a uma entrada em um set do kernel, e os bans que nunca aconteceram

Como o fail2ban transforma linhas de log em bans, como este setup o alimenta com logs de contêiner que rotacionam e grava os bans direto em sets do nftables – e três casos em que o fail2ban relatou um ban que o firewall nunca aplicou.

Ilustração da série Deep Dive

🌐 Também em: English · Deutsch · Français · Español · Italiano · Nederlands · Polski

Deep Dive da série em torno do Ansible Tour. O tour explica os roles, os deep dives explicam a tecnologia por baixo: como funciona, por que é usada desse jeito aqui e o que deu errado pelo caminho.

O fail2ban parece a ferramenta mais simples destes servidores: ler um log, contar falhas, banir o endereço. Num host K3s, cada parte dessa frase tem uma pegadinha. Os logs ficam em arquivos de contêiner que mudam de nome a cada restart; os bans precisam cair num firewall em que outros programas também escrevem; e uma família de endereços que ninguém testou pode transformar tudo num placebo. Este post acompanha uma requisição maliciosa da linha de log até a entrada no kernel, explica o que a parte 5 do tour só menciona de passagem – e descreve três casos em que o fail2ban disse “Ban” e o firewall deixou o endereço entrar mesmo assim.

Índice

🧭 Como o fail2ban funciona

Jails, filtros, ações

Uma jail junta três coisas: um log para observar, um filtro que reconhece uma linha ruim e uma ação que bane. O filtro é um conjunto de expressões regulares (failregex, com ignoreregex para exceções) em que <HOST> marca o endereço. Cada match é uma falha para esse endereço. Se um endereço acumula maxretry falhas dentro de findtime, a ação roda e o bane por bantime.

Backends: como o log é lido

  • systemd lê o journal diretamente (filtrado por unit) – robusto, sem arquivos, sem rotação. Usado aqui para o sshd.
  • polling verifica o arquivo a cada poucos segundos em busca de conteúdo novo. Simples, funciona em qualquer sistema de arquivos – e é a única opção quando o caminho é um glob que muda.
  • pyinotify reage imediatamente a eventos de arquivo; mais rápido, mas observa os arquivos que existiam quando a jail foi iniciada.

O timestamp importa tanto quanto o endereço: o fail2ban interpreta a data de cada linha (datepattern) e ignora linhas mais antigas que findtime. Um filtro com o formato de data errado não casa com nada, em silêncio.

O banco de dados e o recidive

O fail2ban guarda os bans atuais num banco SQLite (/var/lib/fail2ban/fail2ban.sqlite3). Depois de um restart, ele reaplica todo ban que ainda não expirou. A jail recidive volta o fail2ban contra si mesmo: o log dela é o fail2ban.log, o filtro conta linhas “Ban”, e quem for banido três vezes em um dia fica banido por 30 dias em todas as portas.

🛡️ Por que ele está aqui

  • Proteção barata contra ataques automatizados no SSH, no login do WordPress, no login do Nextcloud e no Grafana – e contra scanners que percorrem listas de caminhos sabidamente vulneráveis.
  • Bans no kernel, não na aplicação. Um endereço banido não alcança absolutamente nada, nem mesmo o handshake TLS.
  • Visibilidade. Quem bate, com que frequência e em qual porta está no log de bans – desde outubro de 2026 pesquisável no Loki.

🔧 O que este repositório faz

Sete jails, duas fontes de log

JailLogRegraBan
sshdjournal (backend systemd)3 falhaspadrão 1 h
nginx-k3s-wp-loginlog do ingress10 POSTs em /wp-login.php em 10 min1 h
nginx-k3s-nc-loginlog do ingress10 POSTs no /login do Nextcloud em 10 min1 h
nginx-k3s-grafana-loginlog do ingress5 logins falhos no Grafana (HTTP 401) em 10 min1 h
nginx-k3s-scannerlog do ingress20 respostas com 403 ou 404 em 1 min1 h
nginx-k3s-bad-pathslog do ingress2 requisições para caminhos que nunca existem aqui (/.env, /.git/, /phpmyadmin, web shells …) em 1 h24 h
recidivefail2ban.logbanido 3 vezes em um dia30 dias

Todas as jails HTTP leem o access log do ingress controller, o único lugar por onde passa toda requisição, tanto do blog quanto do Nextcloud. Os filtros esperam o prefixo do containerd na frente de cada linha (2026-06-19T14:24:11Z stdout F <client> - - [time] "POST /wp-login.php …"); um filtro escrito para um log nginx comum nunca daria match.

O ban vai direto para o nftables

O fail2ban não ganha tabela nem chain próprias. A ação dele adiciona o endereço a um set que o firewall verifica logo no topo da sua input chain – cada jail no seu próprio par f2b_<jail>4/6 (o porquê está no quinto bug abaixo).

Cada elemento carrega seu próprio timeout, então um ban expira no kernel mesmo que o fail2ban tenha morrido nesse meio-tempo. O unban é só uma limpeza feita na base do melhor esforço.

O arquivo de log que se mexe

O log do ingress não é um arquivo só. Ele é /var/log/pods/<namespace>_<pod>_<uid>/nginx-ingress/N.log, e tanto o diretório do pod quanto o número mudam: um restart do contêiner grava 1.log depois de 0.log, um pod novo ganha um diretório novo. O fail2ban expande o glob em logpath uma única vez, quando a jail inicia. Um pequeno timer (fail2ban-ingress-logwatch, a cada dois minutos) compara a lista atual de arquivos com a anterior e recarrega as jails nginx-k3s-* quando ela muda. Sem ele, veja o primeiro bug abaixo.

🐛 Três vezes em que o fail2ban disse “Ban” e nada aconteceu

1. Observando um arquivo morto por dias

Em 23 de setembro de 2026 descobriu-se que as jails HTTP dos dois servidores Nextcloud não baniam nada havia dias. Depois de um reboot, o fail2ban tinha subido antes do contêiner do ingress, e depois de um restart do contêiner as jails continuaram acompanhando um arquivo que não recebia mais linhas. Tudo parecia saudável – o serviço rodava, as jails apareciam na lista, nenhum erro em lugar nenhum. O timer de log-watch descrito acima é a correção. Ele também é um dos motivos pelos quais o Monit agora verifica se toda jail esperada está ativa (a história do watchdog começou com o fail2ban morrendo em silêncio por dois dias).

A lição: Uma jail que roda ainda não é uma jail que lê. Desde então, um timer recarrega as jails HTTP assim que o arquivo de log do ingress muda, e o Monit verifica se cada jail observa um arquivo que existe.

2. Um reload do firewall que esvaziou os sets de ban

O firewall substitui a própria tabela a cada reload – e com ela os sets, vazios. O fail2ban mantinha os bans no banco de dados e acreditava que estavam ativos. Em 30 de setembro de 2026, depois de uma execução do playbook, 15 de 17 bans em um servidor e 17 de 24 no outro existiam só no fail2ban. O handler do firewall agora reinicia o fail2ban logo depois de cada reload, e o fail2ban reaplica todo ban que ainda não expirou.

A lição: Bans que existem só no banco de dados do fail2ban não protegem nada. Depois de cada reload do firewall, um handler reinicia o fail2ban, e o Monit compara os bans com os sets.

3. Bans IPv6 que nunca foram possíveis

Até 14 de outubro de 2026, toda jail passava nftset = banned4 para a ação – também para endereços IPv6. O nft se recusava a colocar um endereço IPv6 num set IPv4 (“Address family for hostname not supported”), o fail2ban registrava o ban mesmo assim, e o endereço nunca era bloqueado. Nos três servidores. A seção [Init?family=inet6] mencionada acima escolhe o set pela família de endereço; na semana até 20 de outubro de 2026, 15 de 444 bans foram de endereços IPv6 – poucos, mas cada um deles teria passado direto antes.

A lição: O fail2ban registra “Ban” mesmo quando a ação falha. Se o endereço está realmente bloqueado, só o nft list set mostra.

Um quarto, encontrado pelo Loki

Quando os logs foram para o Loki em 19 de outubro de 2026, o novo alerta para erros do fail2ban disparou na hora. A maioria dos erros era inofensiva (KeyError num log de pod que acabara de ser removido – o backend de polling perdendo um arquivo, a jail segue em frente). Mas em 13 e 14 de outubro houve erros de verdade: Failed to execute ban jail 'nginx-k3s-bad-paths' action 'nftables…' – bans que não aconteceram enquanto o reload do firewall estava sendo refeito. Ninguém tinha visto, porque o fail2ban não manda e-mail sobre os próprios erros. O alerta agora manda, tirando o padrão inofensivo conhecido.

Um quinto: um set para todas as jails

Até 21 de outubro de 2026, todas as jails gravavam no mesmo par de sets banned4/6. Parece organizado e tem uma pegadinha: um endereço banido por duas jails existe só uma vez no set. Quando o ban mais curto terminava – o da jail scanner depois de um dia, digamos – o endereço saía do set, embora o recidive ainda quisesse mantê-lo fora por 30 dias. O fail2ban o listava como banido; o kernel não mais. Uma comparação naquele dia encontrou de um a cinco desses endereços por servidor. Desde então cada jail tem o próprio par (f2b_sshd4, f2b_recidive4, …) e adiciona e remove só nele, e um check do Monit (f2b_sets) compara regularmente a lista do fail2ban com os sets.

A lição: Um set compartilhado por bans de durações diferentes perde o mais longo. É por isso que cada jail tem o próprio par de sets.

Um sexto: um filtro que nunca dava match

Em 26 de outubro de 2026, um novo teste alimentou cada filtro com uma linha de log no formato atual. O filtro do Nextcloud não reconheceu a linha dele: procurava POST /login, mas o Nextcloud envia o formulário de login para /index.php/login enquanto htaccess.RewriteBase não estiver definido. Desde julho, a jail nos dois servidores Nextcloud não tinha contado uma única tentativa de login, e o rate limit no ingress, que também só conhecia /login, também não tinha freado essas requisições. Filtro e ingress agora conhecem os dois caminhos; no log atual o filtro novo encontrou 15 tentativas, o antigo 0. O teste roda desde então a cada execução do playbook: verifica cada filtro contra uma linha de exemplo, bane em cada jail um endereço das faixas de documentação (192.0.2.0/24, 2001:db8::/32), confere o set e remove o ban de novo.

A lição: Verificar que um serviço roda não basta. É preciso dar a ele uma entrada real e olhar o resultado.

📊 O que ele bane

Uma semana, de 14 a 20 de outubro de 2026, os três servidores:

JailBlogNextcloud ANextcloud B
nginx-k3s-bad-paths1077474
nginx-k3s-scanner635047
sshd9211
recidive42–
nginx-k3s-wp-login1––
Parcela IPv611 de 1842 de 1282 de 132

O quadro é claro: quase todos os bans vêm de scanners que procuram arquivos .env, diretórios Git, painéis de admin e web shells. Ataques reais de login são raros – o login do WordPress viu dois POSTs em três horas no dia em que os logs foram analisados, e desde 19 de outubro de 2026 o /wp-login.php só responde a endereços da lista de países, de qualquer forma. Os bans de SSH são poucos porque a porta 10022 só aceita faixas de endereços alemãs; o que sobra são alguns endereços de dentro dessa faixa.

Quando uma jail não dispara

  1. Ela está observando o arquivo certo? get <jail> logpath contra ls /var/log/pods/… – depois de um restart do ingress controller, o timer de log-watch deveria tê-la recarregado em até dois minutos.
  2. O filtro dá match? fail2ban-regex contra o arquivo real. Uma mudança no formato de linha depois de um upgrade do ingress aparece aqui.
  3. A data é entendida? Linhas mais antigas que findtime são ignoradas; um datepattern errado faz toda linha ficar “velha”.
  4. O ban chega ao kernel? Compare status com nft list set. Se forem diferentes, procure “Failed to execute ban” no fail2ban.log – ou no Loki: {job="fail2ban"} |= "ERROR".

Não teste a partir do seu próprio jump host

Requisitar /.env uma vez para ver se a jail bad-paths funciona é tentador. Duas requisições em uma hora banem o endereço por 24 horas – incluindo o jump host, e com ele toda sessão SSH para aquele servidor. As faixas privadas estão em ignoreip, o endereço público da rede de administração não. Teste com fail2ban-regex contra uma linha de log, ou a partir de um endereço que você pode se dar ao luxo de perder por um dia.

🆘 Cola: sintoma → comando

A versão curta deste artigo para o momento em que algo dá errado. Rode no host como root; <…> são placeholders.

SintomaComando
Uma jail não bane nadafail2ban-client status <jail>
fail2ban-client get <jail> logpath
O filtro não dá matchfail2ban-regex <logfile> /etc/fail2ban/filter.d/<filter>.conf
Banido, mas ainda passanft get element inet filter f2b_<jail>4 '{ <ip> }' # "No such file" = not in the set
monit status f2b_sets
Em qual set uma jail grava?fail2ban-client get <jail> action nftables-banned-sets setname
Remover um banfail2ban-client unban <ip>
Algum ban falhou?grep -E "ERROR|Failed to execute" /var/log/fail2ban.log | tail
Loki: {job="fail2ban"} |= "ERROR"
O fail2ban parou, ou falta uma jailsystemctl status fail2ban
monit status f2b_jails
Sets vazios depois de um reload do firewallsystemctl restart fail2ban # re-applies every active ban
Você mesmo ficou trancado do lado de fora# from another address or the provider console:
fail2ban-client unban <your-ip>

🎯 As lições

  • Teste um filtro contra uma linha de log real no formato de hoje, não só a sintaxe dele.
  • “Ban” no log não significa “bloqueado”: a verdade é o set no kernel.
  • Bans de durações diferentes precisam de sets separados.
  • Arquivos de log de contêiner se mexem; a jail precisa se mexer junto.
  • Nunca teste caminhos suspeitos a partir do seu próprio jump host.

⚖️ Alternativas – e por que fail2ban

OpçãoPonto fortePor que não aqui
CrowdSecBlocklists compartilhadas pela comunidade, cenários, bouncersMais peças móveis (agente, API local, bouncer) e dados compartilhados com um serviço externo.
sshguardPequeno, rápido, focado em SSHCobre bem o SSH, as jails HTTP nem tanto.
Só rate limits no ingressProtege o HTTP sem nenhum daemon extraFreia atacantes mas nunca os bane, e não faz nada pelo SSH. Usado em complemento (procure por rate limit).
fail2banFunciona com qualquer log, ações scriptáveis, maduroEscolhido – com as três lições acima incorporadas.

O fail2ban é velho, simples e faz exatamente o que promete. O trabalho nunca foi a ferramenta; foi garantir que cada “Ban” no log dele também virasse uma entrada no kernel. Desde outubro de 2026 isso é verificado – pelo handler do firewall, pelo Monit e por um alerta de log – em vez de presumido.

Alguns textos e imagens deste site foram criados com a ajuda de IA ou gerados por IA. Detalhes