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.
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
rootou un utilisateursudo - 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
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 :
curl -fsSL https://install.crowdsec.net -o crowdsec-repo.sh
less crowdsec-repo.sh
sudo sh crowdsec-repo.shInstallez ensuite le paquet :
sudo apt update
sudo apt install crowdsecContrôlez le service :
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 :
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 statusLe 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 :
echo $SSH_CONNECTION | awk '{print $1}'Créez une liste d'autorisation et ajoutez-y cette adresse :
sudo cscli allowlists create admins -d 'Admin addresses'
sudo cscli allowlists add admins VOTRE_IP -d 'Admin workstation'
sudo cscli allowlists inspect adminsUne 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 :
sudo cscli decisions delete --ip VOTRE_IPÉtape 5 : installer le bouncer pare-feu
sudo apt install crowdsec-firewall-bouncer-iptables
sudo systemctl status crowdsec-firewall-bouncer
sudo cscli bouncers listLe 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
sudo cscli capi status
sudo cscli metrics show acquisition parsersLe 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 :
ssh crowdsec-test-NtktlJHV4TfBSK3wvlhiOBnl@VOTRE_IP_SERVEURSur le serveur, l'alerte de test doit apparaître :
sudo cscli alerts list -s crowdsecurity/ssh-generic-testTester le blocage
Utilisez une adresse publique dont vous disposez, différente de votre adresse d'administration, à la place de 203.0.113.10 :
sudo cscli decisions add --ip 203.0.113.10 --duration 5m --reason 'Test'
sudo cscli decisions listAprès quelques secondes, l'adresse est ajoutée au pare-feu et ne peut plus joindre le serveur :
sudo iptables -S CROWDSEC_CHAIN
sudo ipset list crowdsec-blacklists-0 | tail -n 5Retirez ensuite la décision :
sudo cscli decisions delete --ip 203.0.113.10Collections 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/.
sudo cscli collections list
sudo cscli collections list -aPour un service installé après CrowdSec, comme Nginx, ajoutez la collection :
sudo cscli collections install crowdsecurity/nginxCréez ensuite /etc/crowdsec/acquis.d/nginx.yaml :
filenames:
- /var/log/nginx/*.log
labels:
type: nginxTestez la configuration et redémarrez :
sudo crowdsec -t && sudo systemctl restart crowdsec
sudo cscli metrics show acquisitionGé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 :
iptables_chains:
- INPUT
- DOCKER-USERLa 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 :
sudo systemctl edit crowdsec-firewall-bouncer[Unit]
After=docker.service
Wants=docker.serviceRedémarrez puis contrôlez :
sudo systemctl restart crowdsec-firewall-bouncer
sudo iptables -S DOCKER-USERConsole 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 :
sudo cscli console enroll ENROLLMENT_KEYAcceptez 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) :
sudo apt update
sudo apt install --only-upgrade crowdsec crowdsec-firewall-bouncer-iptables
sudo cscli hub update
sudo cscli hub upgrade
sudo systemctl restart crowdsecLes é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 :
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.gzCette 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 :
sudo cscli decisions delete --ip VOTRE_IP
sudo cscli allowlists add admins VOTRE_IPSi 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_urldans la configuration du bouncer aveclisten_uridans/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 :
sudo cscli bouncers add firewall-bouncer-2
sudo nano /etc/crowdsec/bouncers/crowdsec-firewall-bouncer.yaml
sudo systemctl restart crowdsec-firewall-bouncerent: machine not found ou incorrect Username or Password
Les identifiants locaux ne correspondent plus à la base :
sudo cscli machines add -a --force
sudo systemctl restart crowdsecAucune 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.