FR

Linux et réseau

Installer CrowdSec avec un bouncer pare-feu

Protégez votre serveur Debian ou Ubuntu avec CrowdSec : installation, liste d'autorisation de votre IP, bouncer pare-feu, collections, décisions et dépannage.

7 min de lecture, mis à jour le 18 novembre 2026

Sur cette page

Vos valeurs

Renseignez-les une fois, les commandes du guide se mettent à jour.

CrowdSec analyse les journaux de votre serveur, repère les comportements malveillants (force brute SSH, scans web, etc.) et décide de bloquer les adresses concernées. Ce guide vous montre comment l'installer sur un VPS ou un serveur dédié, protéger votre propre adresse IP, puis appliquer les blocages au niveau du pare-feu.

Comment fonctionne CrowdSec

Composant Rôle
Security Engine Lit les journaux et détecte les attaques à l'aide de scénarios
Local API (LAPI) Stocke les décisions, en écoute sur 127.0.0.1:8080 par défaut
Bouncer pare-feu Récupère les décisions et bloque les adresses dans le pare-feu
cscli Outil en ligne de commande pour tout administrer

Prérequis

  • Un serveur sous Debian 12/13 ou Ubuntu 22.04/24.04
  • Un accès SSH avec root ou un utilisateur sudo
  • L'adresse IP publique depuis laquelle vous administrez le serveur
  • Un moyen d'accès de secours : sur un VPS, la console VNC de votre espace client. Sur un serveur dédié, vérifiez l'accès disponible ou contactez le support depuis votre espace client

Ports : aucun port entrant n'est à ouvrir. La LAPI (8080) et les métriques (6060) écoutent uniquement sur 127.0.0.1 et ne doivent pas être exposées. Le serveur doit pouvoir joindre api.crowdsec.net en HTTPS.

Étape 1 : vérifier les ports locaux

Terminal
sudo ss -ltnp | grep -E ':(8080|6060) '

Si la commande n'affiche rien, passez à l'étape suivante. Si le port 8080 est déjà utilisé, par exemple par un conteneur Docker, continuez aussi : l'étape 3 règle ce cas.

Étape 2 : installer CrowdSec

Téléchargez le script officiel d'ajout du dépôt, consultez-le, puis exécutez-le :

Terminal
curl -fsSL https://install.crowdsec.net -o crowdsec-repo.sh
less crowdsec-repo.sh
sudo sh crowdsec-repo.sh

Installez ensuite le paquet :

Terminal
sudo apt update
sudo apt install crowdsec

Contrôlez le service :

Terminal
sudo systemctl status crowdsec
sudo cscli version

Étape 3 : changer le port de la LAPI si nécessaire

Si le port 8080 est occupé, le paquet s'installe sans démarrer le service et affiche Not attempting to start crowdsec, port 8080 is already used. Choisissez un port libre, ici 8180, puis modifiez les deux fichiers concernés :

Terminal
sudo sed -i 's|listen_uri: 127.0.0.1:8080|listen_uri: 127.0.0.1:8180|' /etc/crowdsec/config.yaml
sudo sed -i 's|^url: .*|url: http://127.0.0.1:8180|' /etc/crowdsec/local_api_credentials.yaml
sudo systemctl restart crowdsec
sudo cscli lapi status

Le message You can successfully interact with Local API (LAPI) confirme que tout fonctionne.

Étape 4 : autoriser votre adresse IP

Faites-le avant d'installer le bouncer, pour ne pas risquer de bloquer votre propre accès. Depuis votre session SSH, affichez l'adresse utilisée :

Terminal
echo $SSH_CONNECTION | awk '{print $1}'

Créez une liste d'autorisation et ajoutez-y cette adresse :

Terminal
sudo cscli allowlists create admins -d 'Admin addresses'
sudo cscli allowlists add admins VOTRE_IP -d 'Admin workstation'
sudo cscli allowlists inspect admins

Une plage s'ajoute de la même façon, par exemple 198.51.100.0/24. Une liste d'autorisation empêche les nouvelles décisions, mais ne retire pas celles qui existent déjà. Si votre adresse était déjà bloquée :

Terminal
sudo cscli decisions delete --ip VOTRE_IP

Étape 5 : installer le bouncer pare-feu

Terminal
sudo apt install crowdsec-firewall-bouncer-iptables
sudo systemctl status crowdsec-firewall-bouncer
sudo cscli bouncers list

Le bouncer installé sur le même serveur s'enregistre automatiquement auprès de la LAPI : il doit apparaître dans la liste avec une coche dans la colonne Valid. Sa configuration se trouve dans /etc/crowdsec/bouncers/crowdsec-firewall-bouncer.yaml.

Ce paquet utilise iptables et ipset, ce qui fonctionne avec UFW et avec la chaîne DOCKER-USER de Docker. Un paquet crowdsec-firewall-bouncer-nftables existe pour les configurations entièrement basées sur nftables.

Étape 6 : vérifier la détection et le blocage

État général

Terminal
sudo cscli capi status
sudo cscli metrics show acquisition parsers

Le tableau des sources peut rester vide tant qu'aucune nouvelle ligne n'a été écrite dans les journaux depuis le démarrage du service.

Tester la détection SSH

Depuis une machine dont l'adresse n'est pas dans votre liste d'autorisation, lancez cette connexion, qui échouera normalement :

Terminal
ssh crowdsec-test-NtktlJHV4TfBSK3wvlhiOBnl@VOTRE_IP_SERVEUR

Sur le serveur, l'alerte de test doit apparaître :

Terminal
sudo cscli alerts list -s crowdsecurity/ssh-generic-test

Tester le blocage

Utilisez une adresse publique dont vous disposez, différente de votre adresse d'administration, à la place de 203.0.113.10 :

Terminal
sudo cscli decisions add --ip 203.0.113.10 --duration 5m --reason 'Test'
sudo cscli decisions list

Après quelques secondes, l'adresse est ajoutée au pare-feu et ne peut plus joindre le serveur :

Terminal
sudo iptables -S CROWDSEC_CHAIN
sudo ipset list crowdsec-blacklists-0 | tail -n 5

Retirez ensuite la décision :

Terminal
sudo cscli decisions delete --ip 203.0.113.10

Collections et sources de journaux

Une collection regroupe les analyseurs et les scénarios d'un service. À l'installation, CrowdSec détecte les services présents et écrit les sources correspondantes dans /etc/crowdsec/acquis.d/.

Terminal
sudo cscli collections list
sudo cscli collections list -a

Pour un service installé après CrowdSec, comme Nginx, ajoutez la collection :

Terminal
sudo cscli collections install crowdsecurity/nginx

Créez ensuite /etc/crowdsec/acquis.d/nginx.yaml :

YAML
filenames:
  - /var/log/nginx/*.log
labels:
  type: nginx

Testez la configuration et redémarrez :

Terminal
sudo crowdsec -t && sudo systemctl restart crowdsec
sudo cscli metrics show acquisition

Gérer les décisions

Action Commande
Lister les décisions sudo cscli decisions list
Bannir une adresse 24 h sudo cscli decisions add --ip 203.0.113.10 --duration 24h --reason 'Manual ban'
Bannir une plage sudo cscli decisions add --range 203.0.113.0/24 --reason 'Manual ban'
Débannir une adresse sudo cscli decisions delete --ip 203.0.113.10
Consulter les alertes sudo cscli alerts list
Alertes d'une adresse sudo cscli alerts list --ip 203.0.113.10

Sans --duration, une décision manuelle dure 4 heures. Évitez sudo cscli decisions delete --all, qui supprime aussi les décisions locales et communautaires.

Protéger les conteneurs Docker

Les ports publiés par Docker passent par la chaîne FORWARD et non par INPUT. Pour que le bouncer les couvre, créez /etc/crowdsec/bouncers/crowdsec-firewall-bouncer.yaml.local :

YAML
iptables_chains:
  - INPUT
  - DOCKER-USER

La liste de ce fichier remplace celle du fichier principal : gardez donc INPUT. Docker doit être installé, car c'est lui qui crée la chaîne DOCKER-USER. Pour que le bouncer démarre après Docker, ajoutez un complément systemd :

Terminal
sudo systemctl edit crowdsec-firewall-bouncer
Configuration
[Unit]
After=docker.service
Wants=docker.service

Redémarrez puis contrôlez :

Terminal
sudo systemctl restart crowdsec-firewall-bouncer
sudo iptables -S DOCKER-USER

Console CrowdSec (facultatif)

La console web permet de suivre vos alertes et vos serveurs. Créez un compte sur app.crowdsec.net, récupérez votre clé d'enrôlement, puis lancez :

Terminal
sudo cscli console enroll ENROLLMENT_KEY

Acceptez le serveur dans la console, puis redémarrez le service avec sudo systemctl restart crowdsec. CrowdSec fonctionne aussi sans cette étape.

Mises à jour

Mettez à jour les paquets, puis les éléments du Hub (collections, scénarios, analyseurs) :

Terminal
sudo apt update
sudo apt install --only-upgrade crowdsec crowdsec-firewall-bouncer-iptables
sudo cscli hub update
sudo cscli hub upgrade
sudo systemctl restart crowdsec

Les éléments que vous avez modifiés localement ne sont pas mis à jour par cscli hub upgrade.

Sauvegarde

La configuration se trouve dans /etc/crowdsec et les données, dont la base SQLite par défaut, dans /var/lib/crowdsec/data. Arrêtez le service pendant la copie pour obtenir une base cohérente :

Terminal
sudo systemctl stop crowdsec
sudo tar czf crowdsec-backup.tar.gz /etc/crowdsec /var/lib/crowdsec/data
sudo systemctl start crowdsec
sudo chmod 600 crowdsec-backup.tar.gz

Cette archive contient des identifiants : conservez-la en lieu sûr, hors du serveur.

En cas de problème

Vous êtes bloqué par CrowdSec

Connectez-vous par la console VNC, ou contactez le support pour un serveur dédié, puis retirez la décision et autorisez votre adresse :

Terminal
sudo cscli decisions delete --ip VOTRE_IP
sudo cscli allowlists add admins VOTRE_IP

Si besoin, sudo systemctl stop crowdsec-firewall-bouncer suspend les blocages le temps de corriger.

bind: address already in use

Un autre service utilise le port de la LAPI. Identifiez-le avec sudo ss -ltnp | grep 8080, puis appliquez l'étape 3. Si le bouncer était déjà installé, mettez aussi à jour api_url dans sa configuration et redémarrez-le.

Le bouncer affiche connection refused

  • Vérifiez que CrowdSec tourne : sudo systemctl status crowdsec
  • Comparez api_url dans la configuration du bouncer avec listen_uri dans /etc/crowdsec/config.yaml
  • Consultez /var/log/crowdsec-firewall-bouncer.log

Le bouncer affiche API error: access forbidden

Sa clé n'est plus reconnue. Créez-en une sous un nouveau nom, reportez-la dans api_key, puis redémarrez le bouncer :

Terminal
sudo cscli bouncers add firewall-bouncer-2
sudo nano /etc/crowdsec/bouncers/crowdsec-firewall-bouncer.yaml
sudo systemctl restart crowdsec-firewall-bouncer

ent: machine not found ou incorrect Username or Password

Les identifiants locaux ne correspondent plus à la base :

Terminal
sudo cscli machines add -a --force
sudo systemctl restart crowdsec

Aucune ligne n'est analysée

  • Listez les sources : sudo cscli metrics show acquisition
  • Vérifiez les fichiers de /etc/crowdsec/acquis.d/ et le chemin réel de vos journaux
  • Recherchez les erreurs : sudo grep -E 'level=(error|fatal)' /var/log/crowdsec.log

Le bouncer ne démarre plus après l'ajout de DOCKER-USER

La chaîne n'existe pas tant que Docker n'a pas démarré. Vérifiez sudo systemctl status docker, puis sudo iptables -S DOCKER-USER.

Références