ACLClouds
ACLClouds

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

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. Testare e riavviare

    Verifica la sintassi con fail2ban-client -t, riavvia con systemctl restart fail2ban, poi elenca le jail attive con fail2ban-client status.

  6. 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.