IT

Linux e rete

Installare CrowdSec con un bouncer firewall

Proteggi il tuo server Debian o Ubuntu con CrowdSec: installazione, lista di autorizzazione del tuo IP, bouncer firewall, collezioni, decisioni e risoluzione dei problemi.

7 min di lettura, aggiornato il 18 novembre 2026

In questa pagina

I tuoi valori

Inseriscili una volta: i comandi della guida si aggiornano.

CrowdSec analizza i log del tuo server, individua i comportamenti malevoli (brute force SSH, scansioni web, ecc.) e decide di bloccare gli indirizzi coinvolti. Questa guida ti mostra come installarlo su un VPS o su un server dedicato, proteggere il tuo indirizzo IP e poi applicare i blocchi a livello di firewall.

Come funziona CrowdSec

Componente Ruolo
Security Engine Legge i log e rileva gli attacchi tramite scenari
Local API (LAPI) Memorizza le decisioni, in ascolto su 127.0.0.1:8080 per impostazione predefinita
Bouncer firewall Recupera le decisioni e blocca gli indirizzi nel firewall
cscli Strumento a riga di comando per amministrare tutto

Prerequisiti

  • Un server con Debian 12/13 o Ubuntu 22.04/24.04
  • Un accesso SSH con root o con un utente sudo
  • L'indirizzo IP pubblico da cui amministri il server
  • Un metodo di accesso di emergenza: su un VPS, la console VNC della tua area clienti. Su un server dedicato, verifica l'accesso disponibile o contatta il supporto dalla tua area clienti

Porte: non è necessario aprire alcuna porta in ingresso. La LAPI (8080) e le metriche (6060) ascoltano solo su 127.0.0.1 e non devono essere esposte. Il server deve poter raggiungere api.crowdsec.net in HTTPS.

Passo 1: verificare le porte locali

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

Se il comando non mostra nulla, passa al passo successivo. Se la porta 8080 è già usata, per esempio da un container Docker, continua comunque: il passo 3 risolve questo caso.

Passo 2: installare CrowdSec

Scarica lo script ufficiale che aggiunge il repository, leggilo, poi eseguilo:

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

Installa quindi il pacchetto:

Terminale
sudo apt update
sudo apt install crowdsec

Controlla il servizio:

Terminale
sudo systemctl status crowdsec
sudo cscli version

Passo 3: cambiare la porta della LAPI se necessario

Se la porta 8080 è occupata, il pacchetto si installa senza avviare il servizio e mostra Not attempting to start crowdsec, port 8080 is already used. Scegli una porta libera, qui 8180, poi modifica i due file interessati:

Terminale
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

Il messaggio You can successfully interact with Local API (LAPI) conferma che tutto funziona.

Passo 4: autorizzare il tuo indirizzo IP

Fallo prima di installare il bouncer, per non rischiare di bloccare il tuo stesso accesso. Dalla tua sessione SSH, mostra l'indirizzo usato:

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

Crea una lista di autorizzazione e aggiungi questo indirizzo:

Terminale
sudo cscli allowlists create admins -d 'Admin addresses'
sudo cscli allowlists add admins TUO_IP -d 'Admin workstation'
sudo cscli allowlists inspect admins

Un intervallo si aggiunge allo stesso modo, per esempio 198.51.100.0/24. Una lista di autorizzazione impedisce le nuove decisioni, ma non rimuove quelle già esistenti. Se il tuo indirizzo era già bloccato:

Terminale
sudo cscli decisions delete --ip TUO_IP

Passo 5: installare il bouncer firewall

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

Il bouncer installato sullo stesso server si registra automaticamente presso la LAPI: deve comparire nell'elenco con un segno di spunta nella colonna Valid. La sua configurazione si trova in /etc/crowdsec/bouncers/crowdsec-firewall-bouncer.yaml.

Questo pacchetto usa iptables e ipset, il che funziona con UFW e con la catena DOCKER-USER di Docker. Esiste un pacchetto crowdsec-firewall-bouncer-nftables per le configurazioni interamente basate su nftables.

Passo 6: verificare il rilevamento e il blocco

Stato generale

Terminale
sudo cscli capi status
sudo cscli metrics show acquisition parsers

La tabella delle sorgenti può restare vuota finché nessuna nuova riga è stata scritta nei log dall'avvio del servizio.

Testare il rilevamento SSH

Da una macchina il cui indirizzo non è nella tua lista di autorizzazione, lancia questa connessione, che normalmente fallirà:

Terminale
ssh crowdsec-test-NtktlJHV4TfBSK3wvlhiOBnl@IP_DEL_TUO_SERVER

Sul server, l'avviso di test deve comparire:

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

Testare il blocco

Usa al posto di 203.0.113.10 un indirizzo pubblico di cui disponi, diverso dal tuo indirizzo di amministrazione:

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

Dopo qualche secondo, l'indirizzo viene aggiunto al firewall e non può più raggiungere il server:

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

Rimuovi poi la decisione:

Terminale
sudo cscli decisions delete --ip 203.0.113.10

Collezioni e sorgenti dei log

Una collezione raggruppa gli analizzatori e gli scenari di un servizio. All'installazione, CrowdSec rileva i servizi presenti e scrive le sorgenti corrispondenti in /etc/crowdsec/acquis.d/.

Terminale
sudo cscli collections list
sudo cscli collections list -a

Per un servizio installato dopo CrowdSec, come Nginx, aggiungi la collezione:

Terminale
sudo cscli collections install crowdsecurity/nginx

Crea poi /etc/crowdsec/acquis.d/nginx.yaml:

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

Testa la configurazione e riavvia:

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

Gestire le decisioni

Azione Comando
Elencare le decisioni sudo cscli decisions list
Bannare un indirizzo per 24 h sudo cscli decisions add --ip 203.0.113.10 --duration 24h --reason 'Manual ban'
Bannare un intervallo sudo cscli decisions add --range 203.0.113.0/24 --reason 'Manual ban'
Rimuovere il ban a un indirizzo sudo cscli decisions delete --ip 203.0.113.10
Consultare gli avvisi sudo cscli alerts list
Avvisi di un indirizzo sudo cscli alerts list --ip 203.0.113.10

Senza --duration, una decisione manuale dura 4 ore. Evita sudo cscli decisions delete --all, che elimina anche le decisioni locali e quelle della community.

Proteggere i container Docker

Le porte pubblicate da Docker passano dalla catena FORWARD e non da INPUT. Perché il bouncer le copra, crea /etc/crowdsec/bouncers/crowdsec-firewall-bouncer.yaml.local:

YAML
iptables_chains:
  - INPUT
  - DOCKER-USER

L'elenco di questo file sostituisce quello del file principale: mantieni quindi INPUT. Docker deve essere installato, perché è lui a creare la catena DOCKER-USER. Perché il bouncer si avvii dopo Docker, aggiungi un'integrazione systemd:

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

Riavvia e poi controlla:

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

Console CrowdSec (facoltativa)

La console web permette di seguire i tuoi avvisi e i tuoi server. Crea un account su app.crowdsec.net, recupera la tua chiave di registrazione, poi lancia:

Terminale
sudo cscli console enroll ENROLLMENT_KEY

Accetta il server nella console, poi riavvia il servizio con sudo systemctl restart crowdsec. CrowdSec funziona anche senza questo passo.

Aggiornamenti

Aggiorna i pacchetti, poi gli elementi dell'Hub (collezioni, scenari, analizzatori):

Terminale
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

Gli elementi che hai modificato localmente non vengono aggiornati da cscli hub upgrade.

Backup

La configurazione si trova in /etc/crowdsec e i dati, compreso il database SQLite predefinito, in /var/lib/crowdsec/data. Ferma il servizio durante la copia per ottenere un database coerente:

Terminale
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

Questo archivio contiene delle credenziali: conservalo in un luogo sicuro, fuori dal server.

In caso di problemi

Sei bloccato da CrowdSec

Connettiti tramite la console VNC, oppure contatta il supporto per un server dedicato, poi rimuovi la decisione e autorizza il tuo indirizzo:

Terminale
sudo cscli decisions delete --ip TUO_IP
sudo cscli allowlists add admins TUO_IP

Se necessario, sudo systemctl stop crowdsec-firewall-bouncer sospende i blocchi il tempo necessario per correggere.

bind: address already in use

Un altro servizio usa la porta della LAPI. Individualo con sudo ss -ltnp | grep 8080, poi applica il passo 3. Se il bouncer era già installato, aggiorna anche api_url nella sua configurazione e riavvialo.

Il bouncer mostra connection refused

  • Verifica che CrowdSec sia in esecuzione: sudo systemctl status crowdsec
  • Confronta api_url nella configurazione del bouncer con listen_uri in /etc/crowdsec/config.yaml
  • Consulta /var/log/crowdsec-firewall-bouncer.log

Il bouncer mostra API error: access forbidden

La sua chiave non viene più riconosciuta. Creane una con un nuovo nome, riportala in api_key, poi riavvia il bouncer:

Terminale
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 o incorrect Username or Password

Le credenziali locali non corrispondono più al database:

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

Nessuna riga viene analizzata

  • Elenca le sorgenti: sudo cscli metrics show acquisition
  • Controlla i file in /etc/crowdsec/acquis.d/ e il percorso reale dei tuoi log
  • Cerca gli errori: sudo grep -E 'level=(error|fatal)' /var/log/crowdsec.log

Il bouncer non si avvia più dopo l'aggiunta di DOCKER-USER

La catena non esiste finché Docker non è stato avviato. Verifica sudo systemctl status docker, poi sudo iptables -S DOCKER-USER.

Riferimenti