Deep Dive: nftables – una tabella tutta nostra, set con timeout e le 300 regole che K3s scrive accanto

Come nftables valuta davvero i pacchetti, perché questo setup possiede esattamente una tabella e non svuota mai il ruleset, come fail2ban, il rilevamento dei port scan e il filtro per paese di SSH condividono i set del kernel – e quattro bug che hanno insegnato i dettagli.

Illustrazione per la serie Deep Dive

🌐 Anche in: English · Deutsch · Français · Español · Português · Nederlands · Polski

Deep Dive della serie legata all’Ansible Tour. Il tour spiega i ruoli, i deep dive la tecnologia che c’è sotto: come funziona, perché qui viene usata così e cosa è andato storto lungo la strada.

nftables ha sostituito iptables nel kernel anni fa, ma la maggior parte delle guide traduce ancora le vecchie regole iptables riga per riga e si ferma lì. Funziona finché anche un secondo programma non scrive regole – e su un host K3s ce ne sono diversi. Questo post spiega il modello dei dati di nftables con i dettagli che contano nella pratica, come il ruolo common_firewall costruisce una tabella per l’host, fail2ban, il rilevamento dei port scan e il filtro per paese di SSH, cosa ci mette accanto K3s, e quattro bug degli ultimi mesi che hanno insegnato ciascuno uno di quei dettagli a caro prezzo. La migrazione in sé è descritta in un post precedente, il filtro per paese in un altro; questo parla di come tutto si incastra.

Indice

🧭 Come decide nftables

Tabelle, chain, hook

In iptables le tabelle (filter, nat, mangle) e le loro chain erano fisse. In nftables una tabella è solo un namespace che crei tu, e appartiene a una famiglia di indirizzi: ip, ip6, inet (entrambi), arp, bridge, netdev. Una chain vede pacchetti solo se è una base chain – una agganciata a un hook di netfilter (prerouting, input, forward, output, postrouting) con una priorità e una policy. Le chain normali senza hook si raggiungono solo con jump o goto.

table inet filter {
  chain input {
    type filter hook input priority filter; policy drop;
    ...
  }
}

Priorità: più tabelle sullo stesso hook

Sullo stesso hook possono stare quante base chain vuoi, da quante tabelle vuoi. Il kernel le esegue in ordine di numero di priorità – prima le più basse: raw è −300, il connection tracking gira a −200, mangle −150, dstnat −100, filter 0, srcnat 100. Ne seguono due fatti facili da trascurare:

  • Un accept è definitivo solo per la sua chain. Se la nostra chain input accetta un pacchetto, la base chain successiva sullo stesso hook – per esempio quella creata da K3s – lo vede comunque e può scartarlo. Solo un drop chiude il viaggio del pacchetto ovunque.
  • Conta dove si trova una chain rispetto a conntrack. Una chain a −300 gira prima del connection tracking e non può sapere se un pacchetto è una risposta. Una a −150 gira dopo e può usare ct state. Uno dei bug qui sotto nasce proprio da questa differenza.

Set e map

I set sono collezioni tipizzate (ipv4_addr, ipv6_addr, numeri di porta, concatenazioni) memorizzate nel kernel e consultate in tempo costante. Con flags interval contengono intervalli, con flags timeout ogni elemento scade da solo, e con flags dynamic la regola stessa può aggiungere elementi dal percorso del pacchetto (add @set, update @set). È questo che ha reso superfluo ipset: una lista di ban con scadenza di 24 ore sono tre righe.

Sostituzione atomica – e perché “flush ruleset” è pericoloso

nft -f file applica l’intero file come un’unica transazione: o viene caricato tutto o niente, e non c’è un istante senza regole. Molte configurazioni di esempio iniziano con flush ruleset. Su un host dove scrive regole un solo programma va bene. Su un host dove kube-proxy, flannel e il controller delle network policy di Kubernetes tengono le proprie tabelle, cancella anche le loro regole – se ne accorgono solo alla loro sincronizzazione successiva, da secondi a minuti dopo.

iptables-nft e iptables-legacy

La maggior parte dei componenti di Kubernetes parla ancora iptables. Sulle distribuzioni attuali il comando iptables è iptables-nft: stessa sintassi, ma scrive in tabelle nftables chiamate ip filter, ip nat e così via, usando uno strato di compatibilità per i vecchi moduli di match. L’altro backend, iptables-legacy, scrive nelle vecchie strutture x_tables del kernel. Possono essere attivi entrambi contemporaneamente – e allora né nft list ruleset né iptables-legacy -L mostrano il quadro completo.

🛡️ Perché è qui

  • Un solo file leggibile per IPv4 e IPv6 (table inet), versionato in Git, generato da un unico template.
  • Drop predefinito in entrambe le direzioni. In entrata solo web, SSH e quello che serve a K3s; in uscita solo DNS, NTP, HTTP(S), invio della posta e il traffico del cluster stesso.
  • Liste di ban lato kernel con timeout per fail2ban, il rilevamento dei port scan e la allowlist per paese di SSH – nessun demone nel percorso dei pacchetti.

🔧 Cosa fa questo repository

Una tabella tutta nostra

Il ruolo genera fw.nft.j2 in /etc/sysconfig/nftables.conf – il file che l’unità nftables su AlmaLinux legge davvero (non /etc/nftables.conf). Il file inizia così:

table inet filter
delete table inet filter

table inet filter {
  ...
}

La prima riga crea la tabella se non esiste (così il delete non può fallire su un boot pulito), la seconda la cancella con tutto il contenuto, poi viene ricostruita – tutto in un’unica transazione. Viene sostituita solo la nostra tabella; le tabelle di K3s restano intatte. Un drop-in di systemd limita l’unità allo stesso modo: ExecReload carica il file, ExecStop esegue nft delete table inet filter invece del flush predefinito della distribuzione. Prima che il file sostituisca quello attivo, Ansible convalida il candidato generato con nft -c -f; un errore di sintassi non arriva mai al firewall.

Il succo: su un host dove più programmi scrivono regole, sostituisci solo la tua tabella – mai l’intero ruleset.

La chain input, in ordine

  1. Loopback, established/related, drop degli invalid; drop dei pacchetti XMAS e NULL, reset di SYN+ACK su nuove connessioni, rate limit sui RST.
  2. Prima le liste di ban: f2b_<jail>4/6 (fail2ban, una coppia per jail, con il ban time di quella jail), banned4/6 (manuale, 24 h) e scanban4/6 (port scanner, 1 h) – prima di qualsiasi accept, così un indirizzo bannato non raggiunge niente.
  3. Eccezioni per K3s: i pod possono raggiungere l’API server e il kubelet (6443, 10250), l’HTTP(S) dell’host stesso per l’autoverifica di cert-manager, e sugli host Nextcloud MariaDB e Redis sull’host.
  4. Drop dei range sorgente privati e riservati provenienti dall’esterno, permessi gli ICMP utili e i tipi ICMPv6 senza cui IPv6 non può vivere.
  5. Web su 80/443 (niente UDP 443 – l’ingress controller non ha HTTP/3), SSH su 10022 solo dalla allowlist per paese.
  6. Rilevamento dei port scan: quello che è ancora qui sta per finire nel drop della policy – una porta chiusa. Una sorgente che invia più di 30 SYN al minuto a porte chiuse viene aggiunta a scanban4 dalla regola stessa.
  7. Riga di log con rate limit, drop della policy.

fail2ban scrive negli stessi set

fail2ban non ha una tabella sua. La sua azione sono due righe:

actionban   = nft add element inet filter <nftset> { <ip> timeout <bantime>s }
actionunban = nft delete element inet filter <nftset> { <ip> } 2>/dev/null; true

Ogni ban porta il suo timeout, quindi scade nel kernel anche se fail2ban non è in esecuzione. Sul blog, al momento della scrittura i set di fail2ban contenevano 22 indirizzi, la allowlist SSH ssh_geo4 7.498 range di indirizzi tedeschi (con flags interval e auto-merge, costruita ogni settimana dai dati RIPE). Dal 19 ottobre 2026 la stessa lista protegge anche il login di WordPress: ssh-geo-update la scrive una seconda volta come file geo di nginx, e nginx nel pod del blog risponde a /wp-login.php e /wp-admin/ con 403 per tutto ciò che sta fuori. Dal 20 ottobre 2026 la stessa lista va anche all’ingress controller su ogni server, che risponde con 403 su /grafana fuori da essa.

Cosa scrive K3s accanto

Sul blog, nft list tables mostra sette tabelle. Solo inet filter è nostra (49 regole). Le altre vengono da K3s tramite iptables-nft: ip filter con circa 190 regole – KUBE-SERVICES, KUBE-NODEPORTS, KUBE-PROXY-FIREWALL di kube-proxy e KUBE-ROUTER-*, KUBE-NWPLCY-* del controller delle network policy più una chain KUBE-POD-FW-* per pod –, ip nat con circa 120 (DNAT dei Service, masquerading di flannel), e piccole tabelle ip6. La nostra chain forward deve quindi solo lasciar passare la rete dei pod; se un pod possa parlare con un altro pod lo decidono le chain di K3s sullo stesso hook.

Il succo: le nostre 49 regole sono la parte minore. Se un pacchetto passa si vede solo guardando ogni tabella sullo stesso hook e la sua priorità.

🐛 Quattro bug, quattro dettagli

1. “flush ruleset” ha rotto i Service

La prima versione del template iniziava con flush ruleset. Ogni reload del firewall cancellava anche le regole di kube-proxy e di flannel; Nextcloud perdeva la connessione a MariaDB e Redis via ClusterIP per 30–90 secondi finché kube-proxy non risincronizzava. Il fix è il delete limitato alla tabella mostrato sopra.

Il succo: flush ruleset va usato solo su host dove nessun altro scrive regole.

2. Un reload sbannava tutti in silenzio

Sostituire la nostra tabella sostituisce anche i set dei ban – vuoti. fail2ban non se ne accorgeva e continuava a tenere gli indirizzi come “bannati” nel suo database, mentre il firewall li lasciava di nuovo entrare. Scoperto il 30 settembre 2026: dopo un’esecuzione del playbook, 15 ban su 17 su un server Nextcloud e 17 su 24 sull’altro esistevano solo in fail2ban. L’handler del firewall ora riavvia fail2ban subito dopo ogni reload (systemctl try-restart fail2ban), e fail2ban riapplica dal suo database ogni ban ancora attivo.

Il succo: due sistemi che tengono lo stesso stato finiscono per divergere. Da allora un handler riavvia fail2ban dopo ogni reload, che riapplica i ban attivi, e Monit confronta fail2ban con i set.

3. La chain dei NodePort scartava le risposte al nostro stesso traffico

kube-proxy rende ogni NodePort (30000–32767) raggiungibile su ogni indirizzo locale – compreso quello pubblico – e quel traffico viene DNATato verso un pod e poi passa per la chain forward, non input. Gli exporter erano raggiungibili da internet. Il primo fix è stato una chain a priorità raw (−300) che scartava tutto ciò che andava a quel range di porte sull’indirizzo pubblico. Funzionava – e scartava anche circa il 4 % delle risposte alle connessioni in uscita dei pod: flannel fa il masquerading del traffico dei pod con --random-fully su tutto il range di porte, quindi alcune connessioni ricevevano una porta sorgente tra 30000 e 32767, e il loro SYN-ACK veniva buttato via prima che conntrack potesse riconoscerlo come risposta. Sintomo per due mesi: timeout sporadici verso GitHub e gli app store da ogni host K3s. La chain ora gira a −150, dopo conntrack, e scarta solo ct state new.

Il succo: la posizione di una chain rispetto al connection tracking decide se riconosce come tali le risposte al nostro stesso traffico. Un blocco su porte che compaiono anche come porte sorgente può colpire solo le nuove connessioni.

4. Il motore di policy che non applicava niente, e un blocco dei moduli troppo largo

Per due mesi Calico ha girato accanto a K3s come presunto motore delle NetworkPolicy. Un test deny-all il 19 ottobre 2026 ha mostrato che non aveva mai fatto match su niente: Felix di Calico gestisce solo le interfacce cali* – quelle del suo CNI – mentre Flannel di K3s crea veth*. Tutta l’applicazione delle policy era sempre venuta dal controller di policy integrato di K3s (le chain KUBE-NWPLCY-*). Calico è stato rimosso; il blog, che fino ad allora usava iptables-legacy, è passato solo a nftables, e i moduli delle tabelle legacy sono stati bloccati con install … /bin/false in modprobe.d. La prima versione di quel blocco includeva anche ip_tables e ip6_tables – dopo il reboot successivo il controller di policy di K3s è andato in panic, perché iptables-nft usa ancora il vecchio match icmp tramite lo strato di compatibilità, e quello ha bisogno di quei moduli. Il blog ha risposto 502 per circa cinque minuti. Ora sono bloccati solo i moduli delle tabelle iptable_* e ip6table_*.

Il succo: una protezione funziona solo quando un test dimostra che blocca qualcosa. Un test deny-all ha trovato in un pomeriggio quello che due mesi di letture non avevano trovato.

Leggere il log dei drop

I pacchetti scartati vengono loggati con i prefissi nftables DROP IN:, DROP FWD: e DROP OUT:, al massimo due al minuto per chain. Da ottobre 2026 sono ricercabili in Loki: {job="journal", transport="kernel"} |= "nftables DROP". Una riga DROP OUT è quella interessante – significa che qualcosa sul server ha provato a collegarsi da qualche parte dove non gli è permesso.

🆘 Promemoria: sintomo → comando

La versione breve di questo articolo per il momento in cui qualcosa non va. Da eseguire sull’host come root; <…> sono segnaposto.

SintomoComando
Un indirizzo è bloccato?nft get element inet filter f2b_<jail>4 '{ <ip> }' # "No such file" = not in the set
nft get element inet filter scanban4 '{ <ip> }'
SSH rifiutato da un nuovo indirizzonft get element inet filter ssh_geo4 '{ <ip> }'
# outside the list: fw_ssh_geo_extra in the inventory
Togliere un ban per port scannft delete element inet filter scanban4 '{ <ip> }'
Cosa viene scartato in questo momento?journalctl -k --since -10min | grep "nftables DROP"
Mostrare solo le nostre regolenft list table inet filter
I pod non raggiungono i servizi dopo un reloadnft list tables # are the K3s tables still there?
journalctl -u k3s --since -10min
Controllare il file prima di caricarlonft -c -f /etc/sysconfig/nftables.conf
Seguire un pacchetto attraverso tutte le chainnft add rule inet filter prerouting ip saddr <ip> meta nftrace set 1
nft monitor trace
Tornare allo stato del repositoryansible-playbook <playbook>.yml -l <host> --tags common_firewall

🎯 Le lezioni

  • Sostituisci solo la tua tabella, in modo atomico in un’unica transazione.
  • Le priorità e la posizione rispetto al connection tracking decidono cosa vede una chain.
  • I ban nel kernel con timeout sopravvivono a un guasto di fail2ban – ma non al reload della tabella in cui vivono.
  • Dove due sistemi tengono lo stesso stato, un confronto va messo nel monitoraggio.
  • Dimostra ogni protezione con un test reale, non leggendo la configurazione.

⚖️ Alternative – e perché nftables puro

OpzionePunto di forzaPerché non qui
iptables + ipsetQuello che parla ancora la maggior parte dei componenti di KubernetesDue strumenti, ruleset IPv4/IPv6 separati, nessuna sostituzione atomica dell’intero file.
firewalldZone, runtime vs. permanente, bella CLISi impossessa del ruleset e lo riscrive; sugli host K3s è noto per litigare con kube-proxy. Rimosso dal ruolo.
eBPF (Cilium, XDP)Molto veloce, profonda integrazione con KubernetesUn modello operativo diverso e un CNI diverso – troppo per tre cluster a nodo singolo.
nftables puroUn file leggibile, caricamenti atomici, set nel kernel, nessun demoneScelto.

La vera lezione degli ultimi mesi non è un dettaglio di sintassi. È che un firewall su un host Kubernetes non è mai solo: ogni ipotesi su chi scrive quale regola, e in che ordine il kernel le esegue, va testata – un test deny-all ha trovato in un pomeriggio più di due mesi passati a leggere file di configurazione.

Alcuni testi e immagini di questo sito sono creati con l’aiuto dell’IA o generati dall’IA. Dettagli