Deep Dive: nftables – uma tabela só nossa, sets com timeout e as 300 regras que o K3s escreve ao lado
Como o nftables realmente avalia pacotes, por que este setup tem exatamente uma tabela e nunca dá flush no ruleset, como fail2ban, detecção de port scan e o filtro de país do SSH dividem sets no kernel – e quatro bugs que ensinaram os detalhes.

🌐 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 as roles, os deep dives a tecnologia por baixo: como funciona, por que é usada assim aqui e o que deu errado pelo caminho.
O nftables substituiu o iptables no kernel há anos, mas a maioria dos guias ainda traduz regras antigas do iptables linha por linha e para por aí. Isso funciona até um segundo programa também escrever regras – e num host K3s vários escrevem. Este post explica o modelo de dados do nftables com os detalhes que importam na prática, como a role common_firewall monta uma tabela para o host, o fail2ban, a detecção de port scan e o filtro de país do SSH, o que o K3s coloca ao lado, e quatro bugs dos últimos meses que ensinaram cada um desses detalhes do jeito difícil. A migração em si está descrita num post anterior, o filtro de país em outro; este é sobre como tudo se encaixa.
Índice
🧭 Como o nftables decide
Tabelas, chains, hooks
No iptables, as tabelas (filter, nat, mangle) e suas chains eram fixas. No nftables, uma tabela é só um namespace que você cria, e ela pertence a uma família de endereços: ip, ip6, inet (ambos), arp, bridge, netdev. Uma chain só vê pacotes se for uma base chain – uma que está ligada a um hook do netfilter (prerouting, input, forward, output, postrouting) com uma prioridade e uma policy. Chains normais sem hook só são alcançadas via jump ou goto.
table inet filter {
chain input {
type filter hook input priority filter; policy drop;
...
}
}
Prioridades: várias tabelas num hook
Qualquer número de base chains de qualquer número de tabelas pode ficar pendurado no mesmo hook. O kernel as executa na ordem do número de prioridade – menor primeiro: raw é −300, o connection tracking roda em −200, mangle −150, dstnat −100, filter 0, srcnat 100. Daí seguem dois fatos fáceis de esquecer:
- Um accept só é final para a própria chain. Se a nossa chain
inputaceita um pacote, a próxima base chain no mesmo hook – por exemplo a que o K3s criou – ainda o vê e pode descartá-lo. Só um drop encerra a viagem do pacote em todo lugar. - Onde uma chain fica em relação ao conntrack importa. Uma chain em −300 roda antes do connection tracking e não tem como saber se um pacote é uma resposta. Uma em −150 roda depois e pode usar
ct state. Um dos bugs abaixo veio exatamente dessa diferença.
Sets e maps
Sets são coleções tipadas (ipv4_addr, ipv6_addr, números de porta, concatenações) guardadas no kernel e consultadas em tempo constante. Com flags interval guardam faixas, com flags timeout cada elemento expira sozinho, e com flags dynamic a própria regra pode adicionar elementos a partir do caminho do pacote (add @set, update @set). Foi isso que tornou o ipset desnecessário: uma lista de ban com expiração de 24 horas são três linhas.
Substituição atômica – e por que “flush ruleset” é perigoso
nft -f file aplica o arquivo inteiro como uma transação: ou tudo é carregado ou nada, e não existe nenhum momento sem regras. Muitas configurações de exemplo começam com flush ruleset. Num host onde só um programa escreve regras, tudo bem. Num host onde kube-proxy, flannel e o controller de network policies do Kubernetes mantêm suas próprias tabelas, isso apaga as regras deles também – e eles só percebem no próximo sync, segundos ou minutos depois.
iptables-nft e iptables-legacy
A maioria dos componentes do Kubernetes ainda fala iptables. Nas distribuições atuais, o comando iptables é o iptables-nft: mesma sintaxe, mas ele escreve em tabelas do nftables chamadas ip filter, ip nat e assim por diante, usando uma camada de compatibilidade para módulos de match antigos. O outro backend, iptables-legacy, escreve nas antigas estruturas x_tables do kernel. Os dois podem estar ativos ao mesmo tempo – e aí nem nft list ruleset nem iptables-legacy -L mostram o quadro completo.
🛡️ Por que está aqui
- Um arquivo legível para IPv4 e IPv6 (
table inet), versionado no Git, renderizado a partir de um template. - Drop por padrão nas duas direções. Entrada só web, SSH e o que o K3s precisa; saída só DNS, NTP, HTTP(S), envio de e-mail e o tráfego do próprio cluster.
- Listas de ban no kernel com timeouts para o fail2ban, a detecção de port scan e a allowlist de país do SSH – nenhum daemon no caminho do pacote.
🔧 O que este repositório faz
Uma tabela só nossa
A role renderiza fw.nft.j2 em /etc/sysconfig/nftables.conf – o arquivo que a unit do nftables no AlmaLinux realmente lê (não /etc/nftables.conf). O arquivo começa assim:
table inet filter
delete table inet filter
table inet filter {
...
}
A primeira linha cria a tabela se ela não existir (para que o delete não possa falhar num boot limpo), a segunda a apaga com tudo dentro, e depois ela é reconstruída – tudo numa transação. Só a nossa tabela é substituída; as tabelas do K3s ficam intocadas. Um drop-in do systemd delimita a unit do mesmo jeito: ExecReload carrega o arquivo, ExecStop roda nft delete table inet filter em vez do flush padrão da distribuição. Antes de o arquivo substituir o que está ativo, o Ansible valida o candidato renderizado com nft -c -f; um erro de sintaxe nunca chega ao firewall.
A lição: num host onde vários programas escrevem regras, você substitui só a sua própria tabela – nunca o ruleset inteiro.
A chain input, em ordem
- Loopback, established/related, drop de invalid; drop de pacotes XMAS e NULL, reset de SYN+ACK em conexões novas, rate limit de RSTs.
- Listas de ban primeiro:
f2b_<jail>4/6(fail2ban, um par por jail, com o tempo de ban daquele jail),banned4/6(manual, 24 h) escanban4/6(port scanners, 1 h) – antes de qualquer accept, então um endereço banido não alcança nada. - Exceções do K3s: pods podem alcançar o API server e o kubelet (6443, 10250), o HTTP(S) do próprio host para o self-check do cert-manager e, nos hosts Nextcloud, o MariaDB e o Redis no host.
- Drop de faixas de origem privadas e reservadas vindas de fora, permitir o ICMP útil e os tipos de ICMPv6 sem os quais o IPv6 não vive.
- Web em 80/443 (sem UDP 443 – o ingress controller não tem HTTP/3), SSH na 10022 só da allowlist de países.
- Detecção de port scan: o que ainda chegou aqui está prestes a bater no policy drop – uma porta fechada. Uma origem que manda mais de 30 SYNs por minuto para portas fechadas é adicionada ao
scanban4pela própria regra. - Linha de log com rate limit, policy drop.
O fail2ban escreve nos mesmos sets
O fail2ban não ganha tabela própria. A action dele são duas linhas:
actionban = nft add element inet filter <nftset> { <ip> timeout <bantime>s }
actionunban = nft delete element inet filter <nftset> { <ip> } 2>/dev/null; true
Cada ban carrega seu próprio timeout, então expira no kernel mesmo que o fail2ban não esteja rodando. No blog, os sets do fail2ban tinham 22 endereços no momento em que escrevi isto, a allowlist do SSH ssh_geo4 7.498 faixas de endereços alemãs (com flags interval e auto-merge, montada semanalmente a partir dos dados do RIPE). Desde 19 de outubro de 2026 a mesma lista também protege o login do WordPress: o ssh-geo-update a escreve uma segunda vez como arquivo geo do nginx, e o nginx no pod do blog responde /wp-login.php e /wp-admin/ com 403 para tudo fora dela. Desde 20 de outubro de 2026 a mesma lista vai também para o ingress controller em todos os servidores, que responde 403 em /grafana fora dela.
O que o K3s escreve ao lado
No blog, nft list tables mostra sete tabelas. Só inet filter é nossa (49 regras). As outras vêm do K3s via iptables-nft: ip filter com umas 190 regras – KUBE-SERVICES, KUBE-NODEPORTS, KUBE-PROXY-FIREWALL do kube-proxy e KUBE-ROUTER-*, KUBE-NWPLCY-* do controller de network policies, mais uma chain KUBE-POD-FW-* por pod –, ip nat com umas 120 (DNAT de Services, masquerading do flannel) e pequenas tabelas ip6. A nossa chain forward portanto só precisa deixar a rede de pods passar; se um pod pode falar com outro pod é decidido nas chains do K3s no mesmo hook.
A lição: as nossas 49 regras são a parte menor. Se um pacote passa ou não só fica claro quando você olha todas as tabelas no mesmo hook e suas prioridades.
🐛 Quatro bugs, quatro detalhes
1. “flush ruleset” quebrou os Services
A primeira versão do template começava com flush ruleset. Cada reload do firewall apagava também as regras do kube-proxy e do flannel; o Nextcloud perdia a conexão com o MariaDB e o Redis via ClusterIP por 30 a 90 segundos até o kube-proxy sincronizar de novo. A correção é o delete limitado à tabela mostrado acima.
A lição: flush ruleset só cabe em hosts onde mais ninguém escreve regras.
2. Um reload desbaniu todo mundo em silêncio
Substituir a nossa tabela também substitui os sets de ban – vazios. O fail2ban não percebia e mantinha os endereços como “banidos” no próprio banco de dados enquanto o firewall os deixava entrar de novo. Descoberto em 30 de setembro de 2026: depois de uma execução do playbook, 15 de 17 bans num servidor Nextcloud e 17 de 24 no outro existiam só no fail2ban. O handler do firewall agora reinicia o fail2ban logo após cada reload (systemctl try-restart fail2ban), e o fail2ban reaplica todo ban ainda ativo a partir do seu banco de dados.
A lição: dois sistemas que guardam o mesmo estado se afastam um do outro. Desde então um handler reinicia o fail2ban depois de cada reload, o que reaplica os bans ativos, e o Monit compara o fail2ban com os sets.
3. A chain de NodePort descartava as respostas do nosso próprio tráfego
O kube-proxy torna cada NodePort (30000–32767) alcançável em todo endereço local – inclusive o público – e esse tráfego sofre DNAT para um pod e depois passa pela chain forward, não pela input. Os exporters estavam alcançáveis pela internet. A primeira correção foi uma chain na prioridade raw (−300) que descartava tudo para essa faixa de portas no endereço público. Funcionou – e também descartava cerca de 4 % das respostas a conexões de saída dos pods: o flannel faz masquerading do tráfego dos pods com --random-fully sobre a faixa inteira de portas, então algumas conexões recebiam uma porta de origem entre 30000 e 32767, e o SYN-ACK delas era jogado fora antes que o conntrack pudesse reconhecê-lo como resposta. Sintoma por dois meses: timeouts esporádicos para o GitHub e lojas de apps a partir de todo host K3s. A chain agora roda em −150, depois do conntrack, e descarta só ct state new.
A lição: onde uma chain fica em relação ao connection tracking decide se ela reconhece as respostas ao nosso próprio tráfego como tal. Um bloqueio em portas que também aparecem como portas de origem só pode atingir conexões novas.
4. O policy engine que não aplicava nada, e um bloqueio de módulos largo demais
Por dois meses o Calico rodou ao lado do K3s como o suposto engine de NetworkPolicy. Um teste deny-all em 19 de outubro de 2026 mostrou que ele nunca casou com nada: o Felix do Calico só cuida de interfaces cali* – as do seu próprio CNI – enquanto o Flannel do K3s cria veth*. Toda a aplicação sempre tinha vindo do controller de policies embutido no K3s (as chains KUBE-NWPLCY-*). O Calico foi removido; o blog, que até então usava iptables-legacy, passou a usar só nftables, e os módulos das tabelas legacy foram bloqueados com install … /bin/false no modprobe.d. A primeira versão desse bloqueio também incluía ip_tables e ip6_tables – depois do reboot seguinte, o controller de policies do K3s entrou em pânico, porque o iptables-nft ainda usa o antigo match icmp pela camada de compatibilidade, e isso precisa desses módulos. O blog respondeu 502 por uns cinco minutos. Agora só os módulos de tabela iptable_* e ip6table_* estão bloqueados.
A lição: uma proteção só funciona quando um teste mostra que ela bloqueia alguma coisa. Um teste deny-all achou numa tarde o que dois meses de leitura não acharam.
Lendo o log de drop
Pacotes descartados são logados com os prefixos nftables DROP IN:, DROP FWD: e DROP OUT:, no máximo dois por minuto por chain. Desde outubro de 2026 dá para buscá-los no Loki: {job="journal", transport="kernel"} |= "nftables DROP". Uma linha DROP OUT é a interessante – significa que algo no servidor tentou se conectar a um lugar onde não tem permissão.
🆘 Cola: sintoma → comando
A versão curta deste artigo para o momento em que algo está errado. Rode no host como root; <…> são placeholders.
| Sintoma | Comando |
|---|---|
| Um endereço está bloqueado? | nft get element inet filter f2b_<jail>4 '{ <ip> }' # "No such file" = not in the setnft get element inet filter scanban4 '{ <ip> }' |
| SSH recusado de um endereço novo | nft get element inet filter ssh_geo4 '{ <ip> }'# outside the list: fw_ssh_geo_extra in the inventory |
| Remover um ban de port scan | nft delete element inet filter scanban4 '{ <ip> }' |
| O que está sendo descartado agora? | journalctl -k --since -10min | grep "nftables DROP" |
| Mostrar só as nossas regras | nft list table inet filter |
| Pods não alcançam services depois de um reload | nft list tables # are the K3s tables still there?journalctl -u k3s --since -10min |
| Verificar o arquivo antes de carregá-lo | nft -c -f /etc/sysconfig/nftables.conf |
| Seguir um pacote por todas as chains | nft add rule inet filter prerouting ip saddr <ip> meta nftrace set 1nft monitor trace |
| Voltar ao estado do repositório | ansible-playbook <playbook>.yml -l <host> --tags common_firewall |
🎯 As lições
- Substitua só a sua própria tabela, de forma atômica numa transação.
- As prioridades e a posição em relação ao connection tracking decidem o que uma chain chega a ver.
- Bans no kernel com timeout sobrevivem a uma falha do fail2ban – mas não a um reload da tabela onde moram.
- Onde dois sistemas guardam o mesmo estado, uma comparação pertence ao monitoramento.
- Prove cada proteção com um teste real, não lendo a configuração.
⚖️ Alternativas – e por que nftables puro
| Opção | Ponto forte | Por que não aqui |
|---|---|---|
| iptables + ipset | O que a maioria dos componentes do Kubernetes ainda fala | Duas ferramentas, rulesets separados para IPv4/IPv6, sem substituição atômica do arquivo inteiro. |
| firewalld | Zonas, runtime vs. permanent, CLI agradável | É dono do ruleset e o reescreve; em hosts K3s é conhecido por brigar com o kube-proxy. Removido pela role. |
| eBPF (Cilium, XDP) | Muito rápido, integração profunda com Kubernetes | Outro modelo operacional e outro CNI – demais para três clusters de um nó só. |
| nftables puro | Um arquivo legível, carga atômica, sets no kernel, sem daemon | Escolhido. |
A verdadeira lição dos últimos meses não é um detalhe de sintaxe. É que um firewall num host Kubernetes nunca está sozinho: toda suposição sobre quem escreve qual regra, e em que ordem o kernel as executa, precisa ser testada – um teste deny-all achou mais numa tarde do que dois meses lendo arquivos de configuração.
