ACLClouds
ACLClouds

Comment installer et configurer Fail2ban sur un VPS Debian ou Ubuntu ?

Installer Fail2ban, écrire un jail.local pour SSH et nginx, bannir et débannir une IP, lire le statut des jails et éviter les erreurs courantes avec

Fail2ban lit les journaux de vos services et bannit pendant un temps donné les adresses IP qui accumulent les échecs : mots de passe SSH essayés en boucle, scans de pages d’administration, authentifications web ratées. Sur un VPS exposé à Internet, les tentatives sur le port 22 commencent quelques minutes après la livraison. Ce guide installe Fail2ban sur Debian 12 / 13 ou Ubuntu 22.04 / 24.04, protège SSH et nginx, puis montre comment contrôler, bannir et débannir une adresse.

Procédure étape par étape

  1. Installer Fail2ban

    Mettez à jour la liste des paquets, puis installez fail2ban avec nftables et python3-systemd, qui lui permettent de bannir avec nftables et de lire le journal systemd. Le service démarre aussitôt avec la configuration par défaut.

  2. Créer le fichier jail.local

    Ne modifiez jamais /etc/fail2ban/jail.conf, remplacé à chaque mise à jour. Écrivez vos réglages dans /etc/fail2ban/jail.local : durée de bannissement, fenêtre d’observation, nombre d’échecs, adresses à ne jamais bannir et action nftables.

  3. Protéger SSH

    Activez la jail [sshd] avec backend = systemd : sur Debian, SSH écrit dans le journal systemd et le fichier /var/log/auth.log n’existe souvent pas. Si SSH écoute sur un autre port que 22, indiquez-le avec port.

  4. Ajouter les jails nginx

    Si nginx tourne sur le VPS, activez nginx-http-auth pour les mots de passe d’authentification HTTP ratés et nginx-botsearch pour les robots qui cherchent des pages d’administration. Ces deux jails lisent /var/log/nginx/error.log.

  5. Tester puis redémarrer

    Vérifiez la syntaxe avec fail2ban-client -t, redémarrez avec systemctl restart fail2ban, puis listez les jails actives avec fail2ban-client status.

  6. Contrôler, bannir et débannir

    fail2ban-client status sshd affiche les échecs comptés et les adresses bannies. fail2ban-client set sshd unbanip 198.51.100.7 libère une adresse, fail2ban-client set sshd banip 198.51.100.7 la bannit à la main.

Installation sur Debian et 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

Tester et appliquer la configuration

fail2ban-client -t
systemctl restart fail2ban
fail2ban-client status
fail2ban-client status sshd

Bannir, débannir et lister les adresses

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

Vérifier qu’un filtre reconnaît les échecs

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

Avant de commencer

Connectez-vous en root avec ssh root@IP, ou ajoutez sudo devant chaque commande. Notez l’adresse IP publique depuis laquelle vous administrez le VPS et placez-la dans ignoreip : une faute de frappe répétée dans votre propre mot de passe suffit sinon à vous bannir.

  • Fail2ban complète une connexion SSH par clé, il ne la remplace pas : une fois la clé installée, désactivez l’authentification par mot de passe (voir « Que faut-il sécuriser avant mon premier déploiement VPS ? »).
  • Les adresses 203.0.113.10 et 198.51.100.7 des exemples sont des adresses de documentation : remplacez-les par les vôtres.
  • En cas de blocage, la console noVNC du panel ACLClouds ne passe pas par SSH : elle permet toujours de débannir votre adresse.

Comprendre les réglages de jail.local

Une jail associe un filtre (les expressions qui reconnaissent un échec dans un journal), une source de journaux et une action de bannissement. La section [DEFAULT] fixe les valeurs communes, chaque jail peut les remplacer.

  • maxretry, findtime et bantime : ici, 5 échecs en 10 minutes valent un bannissement d’une heure ; 4 échecs suffisent pour SSH.
  • bantime.increment = true allonge le bannissement à chaque récidive, jusqu’à bantime.maxtime (une semaine).
  • ignoreip accepte des adresses et des plages séparées par des espaces, en IPv4 comme en IPv6.
  • banaction = nftables-multiport crée la table inet f2b-table dans nftables et y bloque les adresses bannies, en IPv4 comme en IPv6, sur les ports de la jail.
  • backend = systemd et journalmatch font lire à la jail [sshd] le journal systemd, et non un fichier. La ligne journalmatch couvre Ubuntu et Debian, y compris OpenSSH 10 sur Debian 13, où les messages viennent de sshd-session.

Fail2ban avec nftables ou UFW

Debian 12 et 13 utilisent nftables. L’action nftables-multiport y fonctionne sans autre réglage, même si UFW est installé : Fail2ban garde ses règles dans sa propre table. Sur Ubuntu, vous pouvez préférer l’action ufw (bloc « Variante UFW ») pour voir les bannissements dans ufw status.

Fail2ban bloque le trafic qui entre sur le VPS lui-même. Les ports publiés par Docker passent par la chaîne FORWARD et échappent à ces règles : pour protéger un service dans un conteneur, utilisez banaction = iptables-multiport et ajoutez chain = DOCKER-USER dans sa jail.

Erreurs courantes à éviter

La plupart des installations qui « ne bannissent rien » ont l’une de ces causes. fail2ban-client status sshd permet de les distinguer : si Total failed reste à 0 pendant que des tentatives arrivent, le filtre ne lit pas le bon journal.

  • Modifier jail.conf au lieu de jail.local : les changements disparaissent à la prochaine mise à jour du paquet.
  • Activer une jail nginx alors que nginx n’est pas installé : le fichier de journal manque et Fail2ban refuse de démarrer.
  • Changer le port SSH sans mettre à jour port dans [sshd] : l’adresse est bannie sur le port 22, pas sur le nouveau.
  • Oublier son adresse dans ignoreip, puis se bannir soi-même en testant.
  • Écrire backend = systemd dans [DEFAULT] : les jails nginx, qui lisent des fichiers, ne voient plus rien.

Vérification rapide

  • systemctl is-active fail2ban répond active.
  • fail2ban-client status liste sshd et, si nginx est installé, les jails nginx.
  • fail2ban-regex systemd-journal sshd trouve des lignes correspondantes.
  • Votre propre adresse IP figure dans ignoreip.
  • nft list table inet f2b-table montre les adresses bannies.

Questions fréquentes

Fail2ban ne démarre pas et affiche Have not found any log file for sshd jail, que faire ?

La jail cherche /var/log/auth.log, absent quand SSH écrit seulement dans le journal systemd, ce qui est courant sur Debian. Ajoutez backend = systemd dans la section [sshd] de jail.local, installez python3-systemd, puis relancez systemctl restart fail2ban.

Comment débannir une adresse IP avec Fail2ban ?

Lancez fail2ban-client set sshd unbanip 198.51.100.7 en remplaçant la jail et l’adresse, ou fail2ban-client unban 198.51.100.7 pour la retirer de toutes les jails. Si c’est votre propre adresse et que SSH ne répond plus, connectez-vous par la console noVNC du panel pour lancer la commande.

Comment voir les adresses bannies ?

fail2ban-client status sshd affiche le nombre d’adresses bannies et leur liste pour une jail ; fail2ban-client banned les donne pour toutes les jails. Côté pare-feu, nft list table inet f2b-table montre les ensembles d’adresses bloquées.

Sur Ubuntu 24.04, Fail2ban s’arrête avec No module named 'asynchat', pourquoi ?

La première version de Fail2ban livrée avec Ubuntu 24.04 n’était pas compatible avec Python 3.12. Le correctif est publié dans les dépôts : lancez apt update && apt install --only-upgrade fail2ban, puis systemctl restart fail2ban.

Des tentatives arrivent mais Total failed reste à 0, que vérifier ?

Le filtre ne lit pas les bons messages. Testez-le avec fail2ban-regex systemd-journal sshd : la ligne Lines: ... matched doit être supérieure à 0. Sinon, vérifiez backend = systemd et la ligne journalmatch de la jail [sshd], puis le nom du service avec systemctl status ssh.

Fail2ban suffit-il à protéger un VPS ?

Non. Il réduit le bruit des attaques par force brute et soulage les journaux, mais une clé SSH, la connexion par mot de passe désactivée, un pare-feu qui ne laisse passer que les ports utiles et des mises à jour régulières restent indispensables.