Anime-Sanctuary

fail2ban

Quelques minutes après sa mise en ligne, votre serveur reçoit déjà des inconnus qui essaient des mots de passe à sa porte SSH. Installons fail2ban, un gardien qui les repère et les met dehors pour un temps.

Parcours
Tutoriel 13 sur 35
Durée
20 min de lecture
Vérifié avec
Commandes : essais sous Debian 13.7 (fail2ban 1.1.0)
Ce que vous saurez faire
  • Voir dans les journaux qui essaie de se connecter à votre serveur.
  • Installer fail2ban et vérifier que la surveillance de SSH est active.
  • Régler le nombre d'essais permis et la durée du bannissement.
  • Lire l'état de la surveillance et débannir une adresse.

Avant de commencer : Pare-feu avec ufw.

Sommaire
  1. Pourquoi des inconnus essaient vos mots de passe
  2. Installer fail2ban
  3. Régler la surveillance dans jail.local
  4. Lire l'état de la surveillance
  5. Débannir une adresse
  6. Si ça échoue
  7. Questions fréquentes
  8. La suite
  9. Sources

Comment installer fail2ban sur Debian pour protéger SSH ? Votre pare-feu décide quelles portes restent ouvertes, mais il ne sait pas qui frappe à celle de SSH. fail2ban ajoute ce regard : il lit ce que le serveur note, repère les adresses qui échouent trop souvent et les bloque un moment. Comptez vingt minutes, et un peu de méfiance envers vos propres doigts, nous y reviendrons.

Pourquoi des inconnus essaient vos mots de passe

Des programmes automatiques, des robots, essaient en permanence des mots de passe sur toutes les adresses d'Internet, et la vôtre n'y échappe pas. Une adresse IP est le numéro qui identifie une machine sur le réseau. Le robot n'a pas choisi votre serveur : il frappe à chaque porte SSH qu'il trouve ouverte, avec des noms de compte courants comme admin ou ubuntu.

Votre serveur garde la trace de chaque tentative dans son journal, le cahier où il note ce qui lui arrive. La commande journalctl le lit ; l'article Lire les journaux en détaille les options. Ici, une seule suffit : elle affiche les tentatives sur un compte qui n'existe pas. Les adresses des exemples sont fictives ; les vôtres seront réelles.

Sur le serveur
sudo journalctl -u ssh | grep "Invalid user" | tail -4
Résultat attendu
Nov 05 01:24:48 mon-serveur sshd-session[4069]: Invalid user admin from 198.51.100.23 port 50626
Nov 05 01:24:48 mon-serveur sshd-session[4071]: Invalid user ubuntu from 198.51.100.23 port 50630
Nov 05 01:27:21 mon-serveur sshd-session[4110]: Invalid user test from 198.51.100.23 port 49654
Nov 05 01:27:21 mon-serveur sshd-session[4112]: Invalid user oracle from 198.51.100.23 port 49668

Chaque ligne dit : à telle heure, l'adresse 198.51.100.23 a essayé le compte admin, qui n'existe pas ici. Quatre essais en quelques minutes depuis la même adresse, c'est un robot et non un oubli de mot de passe. Si vous avez coupé les mots de passe avec Sécuriser SSH : couper les mots de passe, il échoue toujours, mais il remplit votre journal pour rien. Reste à lui montrer la porte, ce que fait fail2ban.

1Installer fail2ban

fail2ban s'installe comme n'importe quel paquet Debian, et il démarre tout seul. L'option -y répond « oui » à la confirmation.

Sur le serveur
sudo apt install -y fail2ban

L'installation défile pendant une minute. Vérifions ensuite que le service, un programme qui tourne en permanence en arrière-plan, est bien en route.

Sur le serveur
systemctl is-active fail2ban
Résultat attendu
active

Demandons maintenant à fail2ban ce qu'il surveille. Chaque surveillance s'appelle une jail, « prison » en anglais : une règle qui dit quel service regarder et quand sévir.

Sur le serveur
sudo fail2ban-client status
Résultat attendu
Status
|- Number of jail:	1
`- Jail list:	sshd

Debian a déjà activé la jail sshd, celle qui surveille SSH. Vous êtes donc protégé dès cette minute, avec les réglages d'usine. Ils sont corrects mais larges : examinons-les pour les resserrer.

2Régler la surveillance dans jail.local

Les réglages se changent dans un fichier à vous, /etc/fail2ban/jail.local, et jamais dans jail.conf. Ce dernier appartient au paquet : son en-tête prévient qu'une mise à jour peut l'écraser. Votre jail.local est lu après jail.conf, et pour fail2ban la dernière valeur lue l'emporte : il corrige donc jail.conf et survit aux mises à jour. C'est l'inverse de sshd dans Sécuriser SSH : couper les mots de passe, où la première valeur lue gagne. Chaque programme a sa règle.

Trois nombres décident de tout, comme un videur de salle qui compte les mauvaises entrées :

RéglageRôleDebian, puis nous
maxretryéchecs permis5, puis 3
findtimedurée du comptage10 min
bantimedurée du blocage10 min, puis 1 h

Avec nos valeurs, une adresse qui échoue trois fois en dix minutes est bloquée une heure. Un humain qui se trompe de mot de passe n'y arrive presque jamais. Un robot, si, dès sa première rafale.

Reste un risque : vous bannir vous-même après trois fautes de frappe. Bannir, c'est refuser toute connexion à une adresse pendant un temps. La ligne ignoreip est la liste blanche, les adresses que fail2ban ne bannit jamais. Votre serveur connaît déjà l'adresse d'où vous êtes connecté, dans la variable SSH_CLIENT. On la range dans MON_IP, puis on écrit le fichier avec tee : tout ce qui suit la commande, jusqu'à la ligne EOF, devient son contenu.

Sur le serveur
MON_IP=$(echo "$SSH_CLIENT" | cut -d' ' -f1)
sudo tee /etc/fail2ban/jail.local > /dev/null <<EOF
[DEFAULT]
ignoreip = 127.0.0.1/8 ::1 $MON_IP
maxretry = 3
findtime = 10m
bantime  = 1h

[sshd]
enabled = true
EOF

La commande ne répond rien, c'est bon signe. Avant de relancer le service, fail2ban sait vérifier un fichier de réglages sans rien casser. Une faute de frappe dans jail.local empêcherait sinon le redémarrage.

Sur le serveur
sudo fail2ban-client -t
sudo systemctl restart fail2ban
sudo fail2ban-client get sshd maxretry
Résultat attendu
OK: configuration test is successful
3

Le 3 confirme que la jail lit bien votre fichier. Gardez votre session SSH ouverte pendant le redémarrage, puis testez une deuxième connexion avant de fermer la première. Une surveillance qui tourne ne prouve rien tant qu'on n'a pas vu ce qu'elle voit : lisons son rapport.

3Lire l'état de la surveillance

La commande fail2ban-client status sshd donne le rapport d'une jail : combien d'échecs elle a vus, et qui est actuellement banni. Voici ce que vous verrez après quelques visites indésirables. Vos chiffres et vos adresses seront différents.

Sur le serveur
sudo fail2ban-client status sshd
Résultat attendu
Status for the jail: sshd
|- Filter
|  |- Currently failed:	0
|  |- Total failed:	3
|  `- Journal matches:	_SYSTEMD_UNIT=ssh.service + _COMM=sshd
`- Actions
   |- Currently banned:	1
   |- Total banned:	1
   `- Banned IP list:	198.51.100.23

Cinq lignes comptent pour vous :

  • Currently failed : le nombre d'adresses qui ont échoué récemment sans atteindre le seuil de bannissement. C'est un simple compteur (ici 0), pas une liste.
  • Total failed : tous les échecs vus depuis le démarrage de fail2ban.
  • Currently banned : le nombre d'adresses bloquées en ce moment.
  • Total banned : tous les bannissements depuis le démarrage.
  • Banned IP list : la liste de ces adresses.

Les autres lignes ne demandent rien de vous. Journal matches dit seulement où fail2ban lit : _SYSTEMD_UNIT=ssh.service signifie « les lignes du journal venant du service SSH ».

Pour voir un bannissement sans attendre un robot, bannissez à la main une adresse fictive avec banip. La commande répond 1, et l'adresse apparaît dans Banned IP list au prochain status.

Sur le serveur
sudo fail2ban-client set sshd banip 198.51.100.99
Résultat attendu
1
Retrouver les bannissements passés

Les bannissements passés restent dans le fichier de fail2ban. Chaque ligne Ban dit quelle adresse a été bloquée, et Unban quand elle est libérée. Ce fichier écrit les dates en année-mois-jour, alors que journalctl écrit le mois puis le jour.

Sur le serveur
sudo grep -E " (Ban|Unban) " /var/log/fail2ban.log
Résultat attendu
2026-11-05 01:22:35,737 fail2ban.actions        [3660]: NOTICE  [sshd] Ban 198.51.100.23
2026-11-05 01:22:44,589 fail2ban.actions        [3660]: NOTICE  [sshd] Unban 198.51.100.23

On sait donc lire un bannissement. Reste le geste inverse, utile le jour où l'on bloque quelqu'un qui n'aurait pas dû l'être.

4Débannir une adresse

Pour libérer une adresse, on la nomme dans unbanip. La commande répond 1 quand une adresse a été libérée. Libérons notre adresse fictive.

Sur le serveur
sudo fail2ban-client set sshd unbanip 198.51.100.99
Résultat attendu
1

L'adresse a disparu de la liste, et elle peut de nouveau frapper à la porte SSH. Mais vous ne pouvez taper cette commande que si vous arrivez encore sur le serveur. Que faire si c'est vous qui êtes banni ?

Dans ce cas SSH ne répond plus, mais la console distante, l'écran de secours de votre hébergeur dans son espace client, fonctionne toujours. Connectez-vous-y en alice, puis lancez la même commande avec votre adresse, que vous lirez dans Banned IP list. Sinon, patientez : le bannissement s'arrête de lui-même au bout d'une heure.

Si ça échoue

Trois messages reviennent, avec leur cause :

  • ssh: connect to host 203.0.113.10 port 22: Connection refused (« connexion refusée »), alors que le serveur tourne. Vous avez sans doute échoué trois fois et fail2ban vous a bloqué. Passez par la console distante et débannissez-vous comme à l'étape 4.
  • ERROR: test configuration failed, précédé de Source contains parsing errors: '/etc/fail2ban/jail.local' et d'un numéro de ligne. Une faute de frappe se cache dans jail.local, souvent un crochet oublié dans [sshd]. Corrigez la ligne indiquée, puis relancez sudo fail2ban-client -t jusqu'à lire OK.
  • Failed to access socket path: /var/run/fail2ban/fail2ban.sock. Is fail2ban running? (« fail2ban est-il lancé ? »). Le service est arrêté. Tapez sudo systemctl start fail2ban.

Questions fréquentes

Comment installer fail2ban sur Debian pour protéger SSH ?

Installez le paquet fail2ban, qui démarre tout seul : la jail sshd est déjà active avec les réglages d'usine. Vous pouvez ensuite les resserrer dans /etc/fail2ban/jail.local.

Comment débannir une adresse IP avec fail2ban ?

Lancez sudo fail2ban-client set sshd unbanip suivi de l'adresse. La commande répond 1 quand l'adresse a été libérée.

Que veulent dire maxretry, findtime et bantime ?

maxretry est le nombre d'échecs permis, findtime la durée du comptage et bantime la durée du blocage. Avec 3, 10 minutes et 1 heure, une adresse qui échoue trois fois en dix minutes est bloquée une heure.

La suite

Votre serveur ferme désormais la porte aux robots, et vous avez lu vos premières lignes de journal sans en connaître tous les secrets. Or, quand quelque chose ne marche pas, le journal est presque toujours le premier endroit où chercher. L'article suivant, Lire les journaux, apprend à le lire pour de bon.

Sources (consultées le 4 novembre 2026)

  • fail2ban : jail.conf(5), fail2ban-client(1).
  • Valeurs par défaut (5, 10 minutes, 10 minutes) : fichier /etc/fail2ban/jail.conf du paquet.
  • Commandes : essais sous Debian 13.7 (fail2ban 1.1.0-8) avec un vrai serveur SSH ; adresses d'exemple.