Quando una connessione Internet smette di funzionare, individuare l’origine del problema può richiedere una lunga sequenza di comandi come ping, dig, curl, traceroute e altri strumenti di rete. Network Doctor nasce con l’obiettivo di riunire queste verifiche all’interno di un’unica interfaccia TUI, fornendo una diagnosi leggibile invece di una semplice raccolta di risultati tecnici.
Lo strumento utilizza una serie di probe indipendenti organizzati secondo una struttura a dipendenze. Questo permette di continuare le verifiche anche quando una determinata componente della connessione non funziona. Un problema DNS, per esempio, non impedisce necessariamente di eseguire i test relativi alla connettività diretta o al percorso verso una destinazione.
Le verifiche coprono diversi livelli della comunicazione:
- interfaccia di rete e connessione Wi-Fi;
- accesso Internet tramite TCP e QUIC/UDP 443;
- connessioni attraverso proxy;
- DNS locale, DNS pubblico e DNS cifrato tramite DoH o DoT;
- connessione TCP verso la destinazione;
- Path MTU;
- TLS e HTTPS;
- HTTP;
- banner SSH e SMTP.
Ogni controllo viene rappresentato con uno stato preciso: Pass, Warn, Fail, Skip oppure N/A. Una condizione di avviso non viene considerata automaticamente un errore, permettendo di distinguere un’anomalia da un vero e proprio guasto.
Network Doctor non richiede privilegi root. Anche le verifiche relative al Path MTU e alla rete locale utilizzano socket non privilegiati e probe con limiti prestabiliti.
L’approccio è pensato soprattutto per rispondere a una domanda pratica: il problema si trova nella rete locale, lungo il percorso verso Internet oppure direttamente sul servizio che si sta tentando di raggiungere?
Modalità interattiva, automazione e diagnosi avanzata
Network Doctor può essere utilizzato direttamente dal terminale oppure integrato all’interno di procedure automatizzate. La modalità --watch permette di ripetere continuamente le verifiche e conservare una cronologia degli incidenti, utile soprattutto quando il problema è intermittente e scompare prima che sia possibile analizzarlo manualmente.
Per i sistemi di monitoraggio e gli script sono disponibili anche l’output JSON e codici di uscita stabili. Il risultato complessivo può essere classificato come ok, degraded, dns, network, service oppure incomplete, mentre i singoli controlli mantengono il proprio stato e le relative informazioni diagnostiche.
Un’altra caratteristica interessante è la possibilità di passare rapidamente dalla diagnosi automatica agli strumenti tradizionali. Network Doctor può avviare in modo interattivo comandi come route, socket, ping, DNS, curl, traceroute, mtr e nmap, mostrando i risultati attraverso processi cancellabili e con output ripulito prima della visualizzazione.
Sono disponibili anche profili dedicati a determinati servizi. Con --profile github, --profile ssh, --profile smtp o --profile web, più controlli vengono combinati in una verifica specifica, mantenendo comunque disponibili i risultati dettagliati di ogni singolo componente.
Per i problemi difficili da riprodurre è possibile salvare una diagnosi in formato .ndoc. L’opzione --support permette inoltre di creare uno snapshot pseudonimizzato da condividere per ricevere assistenza, mentre --compare consente di confrontare due diagnosi precedentemente salvate senza effettuare nuove connessioni di rete.
Network Doctor supporta inoltre scenari più avanzati. La modalità --via server host permette di eseguire i controlli su una macchina remota utilizzando il proprio client SSH, senza installare software sul sistema remoto. Con --two-sided è possibile confrontare il comportamento di una destinazione osservata da due punti differenti, mentre --peer-listen e --peer-connect consentono una diagnosi tra due macchine attraverso una connessione TLS 1.3 autenticata direttamente tra i due endpoint.
Installare Network Doctor
Il progetto è multipiattaforma e supporta Linux, macOS e Windows, con pacchetti nativi e binari precompilati. La combinazione tra interfaccia TUI, diagnosi strutturata, output JSON e strumenti di approfondimento rende Network Doctor particolarmente interessante per amministratori di sistema, tecnici IT e utenti che devono capire rapidamente perché una connessione non funziona. Abbiamo testato Network Doctor su Kubuntu 26.04 LTS.