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.

🌐 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
| Jail | Log | Regra | Ban |
|---|---|---|---|
| sshd | journal (backend systemd) | 3 falhas | padrão 1 h |
| nginx-k3s-wp-login | log do ingress | 10 POSTs em /wp-login.php em 10 min | 1 h |
| nginx-k3s-nc-login | log do ingress | 10 POSTs no /login do Nextcloud em 10 min | 1 h |
| nginx-k3s-grafana-login | log do ingress | 5 logins falhos no Grafana (HTTP 401) em 10 min | 1 h |
| nginx-k3s-scanner | log do ingress | 20 respostas com 403 ou 404 em 1 min | 1 h |
| nginx-k3s-bad-paths | log do ingress | 2 requisições para caminhos que nunca existem aqui (/.env, /.git/, /phpmyadmin, web shells …) em 1 h | 24 h |
| recidive | fail2ban.log | banido 3 vezes em um dia | 30 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:
| Jail | Blog | Nextcloud A | Nextcloud B |
|---|---|---|---|
| nginx-k3s-bad-paths | 107 | 74 | 74 |
| nginx-k3s-scanner | 63 | 50 | 47 |
| sshd | 9 | 2 | 11 |
| recidive | 4 | 2 | – |
| nginx-k3s-wp-login | 1 | – | – |
| Parcela IPv6 | 11 de 184 | 2 de 128 | 2 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
- Ela está observando o arquivo certo?
get <jail> logpathcontrals /var/log/pods/…– depois de um restart do ingress controller, o timer de log-watch deveria tê-la recarregado em até dois minutos. - O filtro dá match?
fail2ban-regexcontra o arquivo real. Uma mudança no formato de linha depois de um upgrade do ingress aparece aqui. - A data é entendida? Linhas mais antigas que
findtimesão ignoradas; umdatepatternerrado faz toda linha ficar “velha”. - O ban chega ao kernel? Compare
statuscomnft list set. Se forem diferentes, procure “Failed to execute ban” nofail2ban.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.
| Sintoma | Comando |
|---|---|
| Uma jail não bane nada | fail2ban-client status <jail>fail2ban-client get <jail> logpath |
| O filtro não dá match | fail2ban-regex <logfile> /etc/fail2ban/filter.d/<filter>.conf |
| Banido, mas ainda passa | nft get element inet filter f2b_<jail>4 '{ <ip> }' # "No such file" = not in the setmonit status f2b_sets |
| Em qual set uma jail grava? | fail2ban-client get <jail> action nftables-banned-sets setname |
| Remover um ban | fail2ban-client unban <ip> |
| Algum ban falhou? | grep -E "ERROR|Failed to execute" /var/log/fail2ban.log | tailLoki: {job="fail2ban"} |= "ERROR" |
| O fail2ban parou, ou falta uma jail | systemctl status fail2banmonit status f2b_jails |
| Sets vazios depois de um reload do firewall | systemctl 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ção | Ponto forte | Por que não aqui |
|---|---|---|
| CrowdSec | Blocklists compartilhadas pela comunidade, cenários, bouncers | Mais peças móveis (agente, API local, bouncer) e dados compartilhados com um serviço externo. |
| sshguard | Pequeno, rápido, focado em SSH | Cobre bem o SSH, as jails HTTP nem tanto. |
| Só rate limits no ingress | Protege o HTTP sem nenhum daemon extra | Freia atacantes mas nunca os bane, e não faz nada pelo SSH. Usado em complemento (procure por rate limit). |
| fail2ban | Funciona com qualquer log, ações scriptáveis, maduro | Escolhido – 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.
