Deep Dive: fail2ban – da una riga di log a una voce in un set del kernel, e i ban che non sono mai avvenuti

Come fail2ban trasforma righe di log in ban, come questo setup lo alimenta da log di container che ruotano e scrive i ban direttamente nei set nftables – e tre modi in cui fail2ban ha segnalato un ban che il firewall non ha mai applicato.

Illustrazione per la serie Deep Dive

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

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

fail2ban sembra lo strumento più semplice su questi server: leggi un log, conta i fallimenti, banna l’indirizzo. Su un host K3s ogni parte di questa frase ha un tranello. I log vivono in file di container che cambiano nome a ogni riavvio; i ban devono finire in un firewall in cui scrivono anche altri programmi; e una famiglia di indirizzi che nessuno ha testato può trasformare il tutto in un placebo. Questo post segue una richiesta malevola dalla riga di log fino alla voce nel kernel, spiega ciò che la parte 5 del tour solo sfiora – e descrive tre casi in cui fail2ban ha detto “Ban” e il firewall ha lasciato entrare comunque l’indirizzo.

Indice

🧭 Come funziona fail2ban

Jail, filtri, action

Una jail lega insieme tre cose: un log da osservare, un filtro che riconosce una riga malevola e un’action che banna. Il filtro è un insieme di espressioni regolari (failregex, con ignoreregex per le eccezioni) in cui <HOST> indica l’indirizzo. Ogni match è un fallimento per quell’indirizzo. Se un indirizzo accumula maxretry fallimenti entro findtime, l’action parte e lo banna per bantime.

Backend: come viene letto il log

  • systemd legge direttamente il journal (filtrato per unit) – robusto, niente file, niente rotazione. Qui usato per sshd.
  • polling controlla il file ogni pochi secondi alla ricerca di contenuto nuovo. Semplice, funziona su qualsiasi filesystem – e l’unica opzione quando il percorso è un glob che cambia.
  • pyinotify reagisce immediatamente agli eventi sui file; più veloce, ma osserva i file che esistevano quando la jail è partita.

Il timestamp conta quanto l’indirizzo: fail2ban interpreta la data di ogni riga (datepattern) e ignora le righe più vecchie di findtime. Un filtro con il formato di data sbagliato non trova niente, in silenzio.

Il database e recidive

fail2ban salva i ban attuali in un database SQLite (/var/lib/fail2ban/fail2ban.sqlite3). Dopo un riavvio riapplica ogni ban non ancora scaduto. La jail recidive rivolge fail2ban contro se stesso: il suo log è fail2ban.log, il suo filtro conta le righe “Ban”, e chi viene bannato tre volte in un giorno viene bannato per 30 giorni su tutte le porte.

🛡️ Perché è qui

  • Protezione economica contro gli attacchi automatizzati su SSH, il login di WordPress, il login di Nextcloud e Grafana – e contro gli scanner che passano in rassegna liste di percorsi notoriamente vulnerabili.
  • Ban nel kernel, non nell’applicazione. Un indirizzo bannato non raggiunge proprio niente, nemmeno l’handshake TLS.
  • Visibilità. Chi bussa, quanto spesso e a quale porta sta nel log dei ban – da ottobre 2026 ricercabile in Loki.

🔧 Cosa fa questo repository

Sette jail, due sorgenti di log

JailLogRegolaBan
sshdjournal (backend systemd)3 fallimentidefault 1 h
nginx-k3s-wp-loginlog dell’ingress10 POST su /wp-login.php in 10 min1 h
nginx-k3s-nc-loginlog dell’ingress10 POST sul /login di Nextcloud in 10 min1 h
nginx-k3s-grafana-loginlog dell’ingress5 login Grafana falliti (HTTP 401) in 10 min1 h
nginx-k3s-scannerlog dell’ingress20 risposte con 403 o 404 in 1 min1 h
nginx-k3s-bad-pathslog dell’ingress2 richieste di percorsi che qui non esistono mai (/.env, /.git/, /phpmyadmin, web shell …) in 1 h24 h
recidivefail2ban.logbannato 3 volte in un giorno30 giorni

Tutte le jail HTTP leggono l’access log dell’ingress controller, l’unico posto da cui passa ogni richiesta, per il blog come per Nextcloud. I filtri si aspettano il prefisso di containerd davanti a ogni riga (2026-06-19T14:24:11Z stdout F <client> - - [time] "POST /wp-login.php …"); un filtro scritto per un normale log di nginx non troverebbe mai niente.

Il ban va direttamente in nftables

fail2ban non riceve né una tabella né una chain propria. La sua action aggiunge l’indirizzo a un set che il firewall controlla in cima alla sua input chain – ogni jail nella sua coppia f2b_<jail>4/6 (perché, vedi il quinto bug più sotto).

Ogni elemento porta il proprio timeout, così un ban scade nel kernel anche se nel frattempo fail2ban è morto. L’unban è solo una pulizia best-effort.

Il file di log che si sposta

Il log dell’ingress non è un singolo file. È /var/log/pods/<namespace>_<pod>_<uid>/nginx-ingress/N.log, e cambiano sia la directory del pod sia il numero: un riavvio del container scrive 1.log dopo 0.log, un nuovo pod riceve una nuova directory. fail2ban espande il glob in logpath una sola volta, quando la jail parte. Un piccolo timer (fail2ban-ingress-logwatch, ogni due minuti) confronta l’elenco attuale dei file con l’ultimo e ricarica le jail nginx-k3s-* quando differisce. Senza di lui, vedi il primo bug più sotto.

🐛 Tre volte fail2ban ha detto “Ban” e non è successo niente

1. Per giorni a guardare un file morto

Il 23 settembre 2026 è emerso che le jail HTTP su entrambi i server Nextcloud non bannavano niente da giorni. Dopo un reboot fail2ban era partito prima del container dell’ingress, e dopo un riavvio del container le jail continuavano a seguire un file che non riceveva più righe. Tutto sembrava sano – il servizio girava, le jail erano elencate, nessun errore da nessuna parte. Il timer di log-watch descritto sopra è la correzione. È anche uno dei motivi per cui Monit ora controlla che ogni jail prevista sia attiva (la storia del watchdog è iniziata con fail2ban morto in silenzio per due giorni).

Il punto: Una jail che gira non è ancora una jail che legge. Da allora un timer ricarica le jail HTTP non appena cambia il file di log dell’ingress, e Monit controlla che ogni jail osservi un file che esiste.

2. Un reload del firewall che svuotava i set dei ban

Il firewall sostituisce la propria tabella a ogni reload – e con lei i set, vuoti. fail2ban teneva i suoi ban nel database e li credeva attivi. Il 30 settembre 2026, dopo un’esecuzione del playbook, 15 ban su 17 su un server e 17 su 24 sull’altro esistevano solo in fail2ban. L’handler del firewall ora riavvia fail2ban subito dopo ogni reload, e fail2ban riapplica ogni ban non scaduto.

Il punto: I ban che esistono solo nel database di fail2ban non proteggono niente. Dopo ogni reload del firewall un handler riavvia fail2ban, e Monit confronta i ban con i set.

3. Ban IPv6 che non sono mai stati possibili

Fino al 14 ottobre 2026 ogni jail passava all’action nftset = banned4 – anche per gli indirizzi IPv6. nft si rifiutava di mettere un indirizzo IPv6 in un set IPv4 (“Address family for hostname not supported”), fail2ban registrava comunque il ban, e l’indirizzo non veniva mai bloccato. Su tutti e tre i server. La sezione [Init?family=inet6] di cui sopra sceglie il set in base alla famiglia di indirizzi; nella settimana fino al 20 ottobre 2026, 15 ban su 444 erano indirizzi IPv6 – pochi, ma ognuno di loro prima sarebbe passato dritto.

Il punto: fail2ban registra “Ban” anche quando l’action fallisce. Se l’indirizzo è davvero bloccato lo mostra solo nft list set.

Un quarto, trovato da Loki

Quando il 19 ottobre 2026 i log sono finiti in Loki, il nuovo alert per gli errori di fail2ban è scattato subito. La maggior parte degli errori era innocua (KeyError su un log di pod appena rimosso – il backend polling che perde un file, la jail va avanti). Ma il 13 e 14 ottobre ce n’erano di reali: Failed to execute ban jail 'nginx-k3s-bad-paths' action 'nftables…' – ban non avvenuti mentre il reload del firewall veniva rimaneggiato. Nessuno li aveva visti, perché fail2ban non manda mail sui propri errori. Ora lo fa l’alert, escluso il pattern innocuo noto.

Un quinto: un set per tutte le jail

Fino al 21 ottobre 2026 tutte le jail scrivevano nella stessa coppia di set banned4/6. Sembra ordinato e ha un tranello: un indirizzo bannato da due jail esiste una sola volta nel set. Quando il ban più breve finiva – quello della jail scanner dopo un giorno, per dire – l’indirizzo usciva dal set, anche se recidive intendeva tenerlo fuori ancora per 30 giorni. fail2ban lo elencava come bannato; il kernel non più. Un confronto quel giorno ha trovato da uno a cinque indirizzi del genere per server. Da allora ogni jail ha la propria coppia (f2b_sshd4, f2b_recidive4, …) e aggiunge e rimuove solo lì, e un check di Monit (f2b_sets) confronta regolarmente l’elenco di fail2ban con i set.

Il punto: Un set condiviso da ban di durata diversa perde quello più lungo. Per questo ogni jail ha la propria coppia di set.

Un sesto: un filtro che non ha mai trovato niente

Il 26 ottobre 2026 un nuovo test ha dato in pasto a ogni filtro una riga di log nel formato di oggi. Il filtro di Nextcloud non ha riconosciuto la sua riga: cercava POST /login, ma Nextcloud manda il suo modulo di login a /index.php/login finché htaccess.RewriteBase non è impostato. Da luglio la jail su entrambi i server Nextcloud non aveva contato un solo tentativo di login, e nemmeno il rate limit nell’ingress, che conosceva anche lui solo /login, aveva rallentato quelle richieste. Filtro e ingress ora conoscono entrambi i percorsi; nel log attuale il nuovo filtro ha trovato 15 tentativi, il vecchio 0. Il test gira da allora a ogni esecuzione del playbook: verifica ogni filtro contro una riga di esempio, banna in ogni jail un indirizzo dei range di documentazione (192.0.2.0/24, 2001:db8::/32), controlla il set e toglie di nuovo il ban.

Il punto: Verificare che un servizio giri non basta. Devi dargli input reale e guardare il risultato.

📊 Cosa banna

Una settimana, dal 14 al 20 ottobre 2026, tutti e tre i server:

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

Il quadro è chiaro: quasi tutti i ban vengono da scanner che cercano file .env, directory Git, pannelli di amministrazione e web shell. I veri attacchi al login sono rari – il login di WordPress ha visto due POST in tre ore il giorno in cui sono stati analizzati i log, e dal 19 ottobre 2026 /wp-login.php risponde comunque solo a indirizzi della lista dei paesi. I ban SSH sono pochi perché la porta 10022 accetta solo range di indirizzi tedeschi; quel che resta sono pochi indirizzi da dentro quel range.

Quando una jail non scatta

  1. Sta osservando il file giusto? get <jail> logpath contro ls /var/log/pods/… – dopo un riavvio dell’ingress controller il timer di log-watch avrebbe dovuto ricaricarla entro due minuti.
  2. Il filtro trova qualcosa? fail2ban-regex contro il file reale. Un cambio di formato delle righe dopo un upgrade dell’ingress salta fuori qui.
  3. La data viene capita? Le righe più vecchie di findtime vengono ignorate; un datepattern sbagliato rende ogni riga “vecchia”.
  4. Il ban arriva nel kernel? Confronta status con nft list set. Se differiscono, cerca in fail2ban.log “Failed to execute ban” – o in Loki: {job="fail2ban"} |= "ERROR".

Non testare dal tuo jump host

Richiedere una volta /.env per vedere se la jail bad-paths funziona è una tentazione. Due richieste entro un’ora bannano l’indirizzo per 24 ore – jump host compreso, e con lui ogni sessione SSH verso quel server. I range privati sono in ignoreip, l’indirizzo pubblico della rete di amministrazione no. Testa con fail2ban-regex contro una riga di log, o da un indirizzo che puoi permetterti di perdere per un giorno.

🆘 Cheat sheet: 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
Una jail non banna nientefail2ban-client status <jail>
fail2ban-client get <jail> logpath
Il filtro non trova nientefail2ban-regex <logfile> /etc/fail2ban/filter.d/<filter>.conf
Bannato, ma passa comunquenft get element inet filter f2b_<jail>4 '{ <ip> }' # "No such file" = not in the set
monit status f2b_sets
In quale set scrive una jail?fail2ban-client get <jail> action nftables-banned-sets setname
Togliere un banfail2ban-client unban <ip>
Un ban è fallito?grep -E "ERROR|Failed to execute" /var/log/fail2ban.log | tail
Loki: {job="fail2ban"} |= "ERROR"
fail2ban fermo, o manca una jailsystemctl status fail2ban
monit status f2b_jails
Set vuoti dopo un reload del firewallsystemctl restart fail2ban # re-applies every active ban
Ti sei chiuso fuori da solo# from another address or the provider console:
fail2ban-client unban <your-ip>

🎯 Le lezioni

  • Testa un filtro contro una riga di log reale nel formato di oggi, non solo la sua sintassi.
  • “Ban” nel log non significa “bloccato”: la verità è il set nel kernel.
  • Ban di durata diversa hanno bisogno di set separati.
  • I file di log dei container si spostano; la jail deve spostarsi con loro.
  • Non testare mai percorsi sospetti dal tuo jump host.

⚖️ Alternative – e perché fail2ban

OpzionePunto di forzaPerché non qui
CrowdSecBlocklist condivise dalla community, scenari, bouncerPiù parti in movimento (agent, API locale, bouncer) e dati condivisi con un servizio esterno.
sshguardPiccolo, veloce, focalizzato su SSHCopre bene SSH, meno le jail HTTP.
Solo rate limit nell’ingressProtegge HTTP senza alcun demone in piùRallenta gli attaccanti ma non li banna mai, e non fa niente per SSH. Usato in aggiunta (cerca rate limit).
fail2banFunziona con qualsiasi log, action scriptabili, maturoScelto – con le tre lezioni sopra integrate.

fail2ban è vecchio, semplice e fa esattamente ciò che dice. Il lavoro non è mai stato lo strumento; è stato assicurarsi che ogni “Ban” nel suo log finisse anche come voce nel kernel. Da ottobre 2026 questo viene verificato – dall’handler del firewall, da Monit e da un alert sui log – invece di essere dato per scontato.

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