Come installare ntopng su Ubuntu 22.04

Su Ubuntu 22.04 ntopng si installa in modo pulito, ma conviene farlo con un minimo di metodo: prima verifichi l’origine dei pacchetti, poi prepari Redis, infine controlli che l’interfaccia di monitoraggio sia davvero utile e non solo “accesa”. ntopng è uno strumento comodo per osservare traffico, host e conversazioni; se lo monti in fretta senza considerare interfaccia, storage e accesso alla UI, finisci con un servizio che funziona a metà.

Qui sotto trovi una procedura pensata per un server Ubuntu 22.04 standard, con systemd, repository ufficiale del vendor e una configurazione iniziale ragionevole. Dove servono scelte, ti segnalo anche cosa cambia se vuoi esporre il pannello solo in LAN o dietro reverse proxy.

Prerequisiti e impostazione del contesto

Prima di installare, chiarisci due punti: su quale interfaccia vuoi osservare il traffico e come vuoi accedere alla dashboard. ntopng può essere utile su un server con una sola NIC, ma rende molto di più se sai già quale interfaccia deve sniffare e da dove arriveranno gli accessi web.

Assumo un’installazione su Ubuntu 22.04 aggiornata, con privilegi sudo e un server raggiungibile in rete amministrativa. Se il server è esposto su Internet, il blast radius non è banale: la UI di monitoraggio e la raccolta dati di rete diventano un punto sensibile, quindi conviene limitare l’esposizione e proteggere bene l’accesso.

1. Aggiornare il sistema e verificare l’ambiente

Parti da un aggiornamento base e verifica che il sistema sia allineato. Non è un passaggio estetico: riduce problemi di dipendenze e ti fa capire subito se il nodo è già in uno stato fragile.

sudo apt update
sudo apt -y upgrade
uname -a
lsb_release -a

Se il sistema è in produzione, valuta l’impatto degli aggiornamenti prima di eseguirli. Il rollback, in questo caso, non è “annulla tutto” ma avere snapshot, backup o una finestra di manutenzione chiara. Se stai lavorando su un host critico, evita di introdurre cambiamenti non necessari oltre a ntopng.

2. Preparare il repository ufficiale di ntop

Su Ubuntu conviene usare il repository del vendor, perché i pacchetti della distribuzione possono non essere aggiornati abbastanza per un uso serio. La procedura può cambiare nel tempo, quindi la cosa corretta è partire dalla documentazione ufficiale di ntop e usare il repository previsto per Ubuntu 22.04.

In linea generale, il flusso è questo: aggiungi la chiave del repository, registri la sorgente APT e aggiorni l’indice pacchetti. Se il metodo di firma dei repository è stato aggiornato, usa il formato supportato dal vendor al momento dell’installazione; non forzare vecchi comandi deprecati se la documentazione indica un percorso diverso.

sudo apt install -y curl gnupg ca-certificates
curl -fsSL https://packages.ntop.org/apt/ntop.key | sudo gpg --dearmor -o /usr/share/keyrings/ntop.gpg
printf 'deb [signed-by=/usr/share/keyrings/ntop.gpg] https://packages.ntop.org/apt/stable/22.04/ amd64/\n' | sudo tee /etc/apt/sources.list.d/ntop.list
sudo apt update

Il file repository può variare nel nome o nel percorso esatto a seconda della versione del vendor. Se il comando di update restituisce un errore di firma o di URL, il controllo da fare subito è in /etc/apt/sources.list.d/ntop.list e nel messaggio di apt update. Non andare avanti “a tentativi” se il repository non è valido.

3. Installare ntopng e dipendenze correlate

Una volta che il repository è corretto, installa ntopng e i componenti di supporto. Redis è fondamentale per la gestione dello stato e dei dati temporanei; senza di lui, ntopng non lavora come previsto.

sudo apt install -y ntopng redis-server

In alcuni ambienti il pacchetto può tirare dentro anche dipendenze aggiuntive per la raccolta dati e il backend web. Dopo l’installazione, verifica che i servizi esistano davvero e siano abilitati all’avvio.

systemctl status ntopng --no-pager
systemctl status redis-server --no-pager

Ti aspetti uno stato active (running). Se uno dei due è fermo, l’errore va letto subito nei log, non dopo aver già aperto firewall e DNS. Il punto è capire se il problema è di pacchetto, configurazione o permessi prima di toccare altro.

4. Configurare ntopng per l’interfaccia corretta

La parte più importante non è “accenderlo”, ma dirgli cosa osservare. La configurazione di ntopng su Ubuntu si trova tipicamente in /etc/ntopng/ntopng.conf o in un file equivalente gestito dal pacchetto. Prima di modificarlo, fai una copia di sicurezza.

sudo cp /etc/ntopng/ntopng.conf /etc/ntopng/ntopng.conf.bak

Dentro il file, in genere imposti almeno l’interfaccia da monitorare e le opzioni di base per Redis e la porta web. Un esempio essenziale può essere questo, da adattare al tuo ambiente:

-i=enp0s3
--redis=127.0.0.1:6379
--http-port=3000

Se la tua interfaccia non si chiama enp0s3, sostituiscila con quella reale. Puoi individuarla con ip link o ip a. Se il server ha più interfacce, sbagliare quella giusta significa osservare il traffico del segmento sbagliato e arrivare a conclusioni inutili.

ip link

In molti casi è più prudente tenere la dashboard in ascolto solo su localhost o su un IP interno, e poi esporla tramite reverse proxy o VPN. Se invece la lasci in ascolto su tutte le interfacce, il blast radius aumenta: chiunque raggiunga la porta può tentare l’accesso alla UI, quindi devi compensare con firewall e autenticazione robusta.

5. Riavviare il servizio e leggere i log

Dopo la configurazione, riavvia e controlla subito i log. È il punto in cui emergono gli errori reali: interfaccia inesistente, Redis non raggiungibile, porta occupata o file di configurazione con sintassi errata.

sudo systemctl restart ntopng
sudo systemctl status ntopng --no-pager
sudo journalctl -u ntopng -n 100 --no-pager

Se il servizio non sale, la prima verifica è quasi sempre nel journal. Cerca messaggi come errore di bind sulla porta, impossibilità di aprire l’interfaccia di rete o problemi di connessione a Redis. A quel punto il rollback minimo è ripristinare /etc/ntopng/ntopng.conf dalla copia salvata e riavviare di nuovo il servizio.

6. Aprire la porta in firewall in modo controllato

Se usi UFW, consenti la porta della dashboard solo da reti fidate. Non aprirla in modo indiscriminato se il server è raggiungibile da segmenti non amministrativi.

sudo ufw allow from 192.168.1.0/24 to any port 3000 proto tcp
sudo ufw status verbose

Se ti serve accesso da un host specifico, restringi ancora di più l’origine. La condizione corretta è semplice: la porta 3000 deve essere raggiungibile solo dai sistemi che devono davvero usarla. Se UFW non è attivo, verifica la policy del firewall di rete o del security group del provider.

7. Accedere alla dashboard e completare la prima configurazione

A servizio avviato, apri il browser su http://IP_DEL_SERVER:3000 oppure sul nome host che hai configurato. La prima schermata di ntopng dovrebbe mostrare l’interfaccia di navigazione, gli host osservati e i dati iniziali del traffico.

Se la pagina non risponde, separa il problema in tre livelli: servizio in ascolto, firewall, raggiungibilità di rete. Un controllo rapido della porta locale è utile per capire se ntopng è vivo anche quando la rete esterna lo blocca.

ss -ltnp | grep 3000

Se vedi il processo in ascolto ma il browser non risponde, il problema è quasi certamente fuori dall’applicazione: firewall, routing o proxy. Se invece la porta non è in ascolto, torna ai log del servizio e alla configurazione.

8. Rendere persistente il monitoraggio nel tempo

ntopng non serve solo per “vedere qualcosa” all’istante. Per essere utile deve rimanere stabile, con retention coerente e una configurazione che non cambi a ogni riavvio. Qui la priorità è evitare configurazioni fragili o troppo personalizzate se non hai già un motivo preciso.

Controlla i parametri di retention e le impostazioni di storage previste dal pacchetto o dal file di configurazione. Se il nodo ha poco disco, tieni d’occhio il consumo di spazio: il rischio non è solo la perdita di dati storici, ma anche l’effetto collaterale su altri servizi del server.

df -h
sudo du -sh /var/lib/ntopng 2>/dev/null

Se il consumo cresce troppo, valuta una retention più corta o uno storage dedicato. In un ambiente con vincoli seri, il monitoraggio deve essere dimensionato come un servizio a tutti gli effetti, non come un extra lasciato al caso.

9. Verifiche finali di funzionamento

A installazione completata, fai un controllo finale su quattro elementi: servizio, porta, interfaccia e accesso web. Se uno di questi manca, l’installazione non è davvero conclusa.

1. Servizio attivo: systemctl is-active ntopng deve restituire active.

2. Porta in ascolto: ss -ltnp | grep 3000 deve mostrare il processo ntopng.

3. Interfaccia corretta: nei log o nella UI deve comparire il traffico della NIC scelta, non un’interfaccia vuota.

4. Accesso web: la dashboard deve aprirsi senza errori 4xx/5xx e mostrare host o flussi osservati.

Se vuoi un test rapido da shell, puoi verificare l’endpoint HTTP in locale. Non sostituisce la UI, ma ti dice se il processo risponde davvero.

curl -I http://127.0.0.1:3000

Un 200 OK o comunque una risposta HTTP coerente indica che il servizio web è vivo. Se ottieni connection refused, il problema è a monte: ntopng non sta ascoltando oppure è stato configurato su un’altra porta.

10. Hardening minimo consigliato

Se il server non è un ambiente di laboratorio, applica almeno un hardening minimo. La dashboard non dovrebbe essere esposta senza motivo verso reti non fidate, e gli accessi dovrebbero essere coerenti con il principio del privilegio minimo.

• Limita la porta 3000 a IP o subnet amministrative.

• Se possibile, metti la UI dietro VPN o reverse proxy con autenticazione aggiuntiva.

• Monitora i log di ntopng e il consumo disco del nodo.

• Tieni aggiornati Ubuntu e i pacchetti del repository ntop.

Se usi un reverse proxy, il blast radius della UI si riduce parecchio, ma il rollback deve essere chiaro: riporti il backend alla porta originale, disabiliti il proxy e verifichi che il servizio continui a rispondere localmente. Non introdurre troppe variabili insieme se stai ancora validando l’installazione.

11. Problemi tipici e lettura rapida dei sintomi

Gli errori più comuni in fase di setup sono quasi sempre riconoscibili. Se Redis non parte, ntopng può avviarsi male o non avviarsi affatto. Se l’interfaccia scelta non esiste, il traffico resta a zero. Se la porta è già occupata, la dashboard non sale. Se il repository è sbagliato, l’installazione si ferma prima ancora di arrivare alla configurazione.

La sequenza giusta è sempre la stessa: controlli il journal, verifichi lo stato del servizio, confermi che la porta sia in ascolto e solo dopo tocchi configurazioni più ampie. È il modo più rapido per evitare modifiche inutili e ridurre il tempo perso in diagnosi casuali.

Assunzione operativa: il server è Ubuntu 22.04 aggiornato, ntopng viene installato da repository ufficiale e la dashboard viene esposta solo a reti amministrative o tramite proxy/VPN controllato.

Se vuoi portarlo in esercizio in modo serio, il passo successivo non è “installare altro”, ma definire retention, accesso, alert e backup della configurazione. ntopng è utile quando resta affidabile nel tempo, non quando si limita a mostrare un grafico il giorno dell’installazione.