Come installare e configurare Fail2ban su un VPS Debian o Ubuntu?
Installare Fail2ban, scrivere un jail.local per SSH e nginx, bannare e sbannare un IP, leggere lo stato delle jail ed evitare gli errori più comuni con
Fail2ban legge i log dei tuoi servizi e banna per un tempo stabilito gli indirizzi IP che accumulano errori: password SSH provate a ripetizione, scansioni delle pagine di amministrazione, accessi web falliti. Su un VPS esposto a Internet, i tentativi sulla porta 22 iniziano pochi minuti dopo la consegna. Questa guida installa Fail2ban su Debian 12 / 13 o Ubuntu 22.04 / 24.04, protegge SSH e nginx, poi mostra come controllare, bannare e sbannare un indirizzo.
Procedura passo passo
-
Installare Fail2ban
Aggiorna l’elenco dei pacchetti, poi installa fail2ban insieme a nftables e python3-systemd, che gli permettono di bannare con nftables e di leggere il journal di systemd. Il servizio si avvia subito con la configurazione predefinita.
-
Creare il file jail.local
Non modificare mai /etc/fail2ban/jail.conf, che viene sostituito a ogni aggiornamento. Scrivi le tue impostazioni in /etc/fail2ban/jail.local: durata del ban, finestra di osservazione, numero di errori, indirizzi da non bannare mai e azione nftables.
-
Proteggere SSH
Attiva la jail [sshd] con backend = systemd: su Debian, SSH scrive nel journal di systemd e spesso il file /var/log/auth.log non esiste. Se SSH è in ascolto su una porta diversa dalla 22, indicala con port.
-
Aggiungere le jail nginx
Se sul VPS gira nginx, attiva nginx-http-auth per le password di autenticazione HTTP sbagliate e nginx-botsearch per i bot che cercano pagine di amministrazione. Entrambe le jail leggono /var/log/nginx/error.log.
-
Testare e riavviare
Verifica la sintassi con fail2ban-client -t, riavvia con systemctl restart fail2ban, poi elenca le jail attive con fail2ban-client status.
-
Controllare, bannare e sbannare
fail2ban-client status sshd mostra gli errori conteggiati e gli indirizzi bannati. fail2ban-client set sshd unbanip 198.51.100.7 libera un indirizzo, fail2ban-client set sshd banip 198.51.100.7 lo banna a mano.
Installazione su Debian e Ubuntu
apt update
apt install -y fail2ban nftables python3-systemd
systemctl enable --now fail2ban
fail2ban-client version
/etc/fail2ban/jail.local
[DEFAULT]
bantime = 1h
findtime = 10m
maxretry = 5
bantime.increment = true
bantime.maxtime = 1w
ignoreip = 127.0.0.1/8 ::1 203.0.113.10
banaction = nftables-multiport
banaction_allports = nftables-allports
[sshd]
enabled = true
port = ssh
backend = systemd
journalmatch = _SYSTEMD_UNIT=ssh.service + _COMM=sshd + _COMM=sshd-session
maxretry = 4
[nginx-http-auth]
enabled = true
[nginx-botsearch]
enabled = true
Testare e applicare la configurazione
fail2ban-client -t
systemctl restart fail2ban
fail2ban-client status
fail2ban-client status sshd
Bannare, sbannare ed elencare gli indirizzi
fail2ban-client banned
fail2ban-client set sshd banip 198.51.100.7
fail2ban-client set sshd unbanip 198.51.100.7
fail2ban-client unban 198.51.100.7
nft list table inet f2b-table
Verificare che un filtro riconosca gli errori
fail2ban-regex systemd-journal sshd
fail2ban-regex /var/log/nginx/error.log nginx-botsearch
tail -n 50 /var/log/fail2ban.log
Variante UFW
[DEFAULT]
banaction = ufw
banaction_allports = ufw
Prima di iniziare
Accedi come root con ssh root@IP, oppure aggiungi sudo davanti a ogni comando. Annota l’indirizzo IP pubblico da cui amministri il VPS e inseriscilo in ignoreip: altrimenti basta digitare male la tua password qualche volta per bannarti da solo.
- Fail2ban completa l’accesso SSH con chiave, non lo sostituisce: una volta installata la chiave, disattiva l’autenticazione con password (vedi « Come proteggere il VPS prima del primo utilizzo? »).
- Gli indirizzi 203.0.113.10 e 198.51.100.7 degli esempi sono indirizzi di documentazione: sostituiscili con i tuoi.
- Se resti bloccato, la console noVNC del pannello ACLClouds non passa da SSH: ti permette sempre di sbannare il tuo indirizzo.
Capire le impostazioni di jail.local
Una jail associa un filtro (le espressioni che riconoscono un errore in un log), una fonte di log e un’azione di ban. La sezione [DEFAULT] fissa i valori comuni e ogni jail può sovrascriverli.
- maxretry, findtime e bantime: qui 5 errori in 10 minuti valgono un ban di un’ora; per SSH ne bastano 4.
- bantime.increment = true allunga il ban a ogni recidiva, fino a bantime.maxtime (una settimana).
- ignoreip accetta indirizzi e intervalli separati da spazi, sia IPv4 sia IPv6.
- banaction = nftables-multiport crea la tabella inet f2b-table in nftables e vi blocca gli indirizzi bannati, sia in IPv4 sia in IPv6, sulle porte della jail.
- backend = systemd e journalmatch fanno leggere alla jail [sshd] il journal di systemd invece di un file. La riga journalmatch copre Ubuntu e Debian, compreso OpenSSH 10 su Debian 13, dove i messaggi arrivano da sshd-session.
Fail2ban con nftables o UFW
Debian 12 e 13 usano nftables. L’azione nftables-multiport funziona senza altre impostazioni, anche se UFW è installato: Fail2ban tiene le sue regole in una tabella propria. Su Ubuntu puoi preferire l’azione ufw (blocco « Variante UFW ») per vedere i ban in ufw status.
Fail2ban blocca il traffico in entrata verso il VPS stesso. Le porte pubblicate da Docker passano per la catena FORWARD e sfuggono a queste regole: per proteggere un servizio in un container, usa banaction = iptables-multiport e aggiungi chain = DOCKER-USER nella sua jail.
Errori comuni da evitare
La maggior parte delle installazioni che « non bannano niente » ha una di queste cause. fail2ban-client status sshd aiuta a distinguerle: se Total failed resta a 0 mentre arrivano tentativi, il filtro non legge il log giusto.
- Modificare jail.conf invece di jail.local: le modifiche spariscono al successivo aggiornamento del pacchetto.
- Attivare una jail nginx quando nginx non è installato: il file di log manca e Fail2ban si rifiuta di avviarsi.
- Cambiare la porta SSH senza aggiornare port in [sshd]: l’indirizzo viene bannato sulla porta 22, non sulla nuova.
- Dimenticare il proprio indirizzo in ignoreip e poi bannarsi da soli durante i test.
- Scrivere backend = systemd in [DEFAULT]: le jail nginx, che leggono file, non vedono più nulla.
Verifica rapida
- systemctl is-active fail2ban risponde active.
- fail2ban-client status elenca sshd e, se nginx è installato, le jail nginx.
- fail2ban-regex systemd-journal sshd trova righe corrispondenti.
- Il tuo indirizzo IP è presente in ignoreip.
- nft list table inet f2b-table mostra gli indirizzi bannati.
Domande frequenti
Fail2ban non si avvia e mostra Have not found any log file for sshd jail: cosa fare?
La jail cerca /var/log/auth.log, che manca quando SSH scrive solo nel journal di systemd, cosa frequente su Debian. Aggiungi backend = systemd nella sezione [sshd] di jail.local, installa python3-systemd, poi esegui di nuovo systemctl restart fail2ban.
Come sbannare un indirizzo IP con Fail2ban?
Esegui fail2ban-client set sshd unbanip 198.51.100.7 sostituendo la jail e l’indirizzo, oppure fail2ban-client unban 198.51.100.7 per rimuoverlo da tutte le jail. Se è il tuo indirizzo e SSH non risponde più, accedi dalla console noVNC del pannello per lanciare il comando.
Come vedere gli indirizzi bannati?
fail2ban-client status sshd mostra il numero di indirizzi bannati e il loro elenco per una jail; fail2ban-client banned li fornisce per tutte le jail. Lato firewall, nft list table inet f2b-table mostra i set di indirizzi bloccati.
Su Ubuntu 24.04 Fail2ban si arresta con No module named 'asynchat': perché?
La prima versione di Fail2ban distribuita con Ubuntu 24.04 non era compatibile con Python 3.12. La correzione è pubblicata nei repository: esegui apt update && apt install --only-upgrade fail2ban, poi systemctl restart fail2ban.
Arrivano tentativi ma Total failed resta a 0: cosa controllare?
Il filtro non legge i messaggi giusti. Testalo con fail2ban-regex systemd-journal sshd: la riga Lines: ... matched deve essere maggiore di 0. Altrimenti controlla backend = systemd e la riga journalmatch della jail [sshd], poi il nome del servizio con systemctl status ssh.
Fail2ban basta a proteggere un VPS?
No. Riduce il rumore degli attacchi brute force e alleggerisce i log, ma una chiave SSH, l’accesso con password disattivato, un firewall che lascia passare solo le porte necessarie e aggiornamenti regolari restano indispensabili.