Il cavo console e i driver
Switch appena tolto dalla scatola, firewall che non risponde più in rete, router da riportare alla configurazione di fabbrica: come facciamo a parlarci dal Mac, che non ha una porta seriale? Ci serve un cavo console USB-seriale, e il Terminale fa il resto. Non occorre installare PuTTY o simili.
In commercio troviamo tre tipi di cavo:
- USB-A o USB-C verso RJ45 (il classico cavo azzurro con l’elettronica già dentro): il più comodo, va direttamente nella porta CONSOLE;
- adattatore USB verso DB9 più il vecchio cavo «rollover» DB9-RJ45: utile se abbiamo già i cavi Cisco di una volta;
- cavo USB semplice per gli apparati con porta console USB (mini-USB, micro-USB o USB-C su molti switch recenti): in questo caso il convertitore seriale è dentro l’apparato.
Il componente che conta è il chip del convertitore. I macOS recenti includono driver per i più diffusi: FTDI, Prolific PL2303, Silicon Labs CP210x, WCH CH340/CH341, oltre ai dispositivi USB CDC-ACM che usano molte porte console USB integrate. Nella maggior parte dei casi basta collegare il cavo, senza installare niente (consiglio: comprate un cavo con chip FTDI, è quello che dà meno problemi). Se il fornitore propone un driver, installatelo solo se il cavo non viene riconosciuto: i vecchi driver come estensioni del kernel non sono più adatti ai Mac Apple Silicon.
Per sapere quale chip c’è nel cavo:
# macOS 26 (e versioni recenti)
system_profiler SPUSBHostDataType | grep -B2 -A8 -i -E "serial|uart|ftdi|prolific"
# versioni precedenti
system_profiler SPUSBDataType | grep -B2 -A8 -i -E "serial|uart|ftdi|prolific"
Il nome della sezione USB di system_profiler è cambiato nelle versioni recenti: system_profiler -listDataTypes | grep -i usb ci dice quale usare. In alternativa apriamo Informazioni di sistema › USB, dove il cavo compare con il nome del produttore.
Trovare la porta seriale
Colleghiamo il cavo e chiediamo al sistema i dispositivi seriali:
ls /dev/cu.*
ls /dev/tty.*
/dev/cu.Bluetooth-Incoming-Port
/dev/cu.debug-console
/dev/cu.usbserial-A10KXYZ1
Il nome dipende dal chip e dal driver: cu.usbserial-… per FTDI, Prolific e per gli altri convertitori con i driver Apple, cu.usbmodem… per le porte console USB degli apparati (CDC-ACM), cu.SLAB_USBtoUART o cu.wchusbserial… se è installato il driver del produttore. Un trucco per non sbagliare: lanciamo ls /dev/cu.* prima e dopo aver collegato il cavo, e quella nuova è la nostra. Le voci Bluetooth-Incoming-Port e debug-console sono del sistema: non c’entrano.
tty o cu?
Ogni porta compare due volte. La differenza viene dai modem di una volta:
/dev/tty.*è il lato «in ingresso»: l’apertura attende il segnale di portante (DCD), come un modem che aspetta una chiamata;/dev/cu.*(call-up) è il lato «in uscita»: si apre subito, senza aspettare.
Per una console usiamo cu. Con la maggior parte degli adattatori USB funziona anche tty, che si trova in tante guide (anch’io l’ho usato per anni); ma se il Terminale resta bloccato all’apertura della porta, la causa è quasi sempre questa.
Collegarsi con screen
screen è già nel sistema. Il secondo argomento è la velocità:
screen /dev/cu.usbserial-A10KXYZ1 9600
# indicando anche 8 bit e niente controllo di flusso software
screen /dev/cu.usbserial-A10KXYZ1 9600,cs8,-ixon,-ixoff
Si apre una finestra nera: premiamo Invio un paio di volte e deve comparire il prompt dell’apparato. Le impostazioni della console sono quasi sempre 8N1 (8 bit di dati, nessuna parità, 1 bit di stop) senza controllo di flusso; cambia la velocità:
| Velocità | Dove la troviamo |
|---|---|
9600 | Il valore predefinito della maggior parte degli switch e router (Cisco, Juniper, HPE/Aruba, molti firewall) |
115200 | Molti apparati recenti e quelli basati su Linux, alcuni access point, MikroTik, server e appliance |
19200, 38400, 57600 | Più rari; anche una console Cisco può essere stata configurata con un valore diverso |
Se vediamo caratteri senza senso, la velocità è sbagliata: chiudiamo e riproviamo con la successiva. Il valore giusto è sempre nel manuale dell’apparato.
I comandi di screen
Dentro screen tutto quello che digitiamo va all’apparato, tranne le combinazioni che iniziano con Ctrl+A: si preme Ctrl+A, si rilascia, poi si preme il tasto del comando.
| Tasti | Effetto |
|---|---|
Ctrl+A, poi k | Chiude la finestra (chiede conferma: y) e libera la porta |
Ctrl+A, poi Ctrl+\ | Chiude tutte le finestre ed esce da screen (chiede conferma) |
Ctrl+A, poi d | Stacca la sessione: resta attiva in background, con la porta occupata |
Ctrl+A, poi H (maiuscola) | Avvia o ferma la registrazione nel file screenlog.0 |
Ctrl+A, poi b | Invia un segnale di break (serve per il recupero password su molti apparati) |
Ctrl+A, poi a | Invia un Ctrl+A vero all’apparato |
Ctrl+A, poi ? | Mostra l’elenco delle combinazioni |
Se chiudiamo la finestra del Terminale senza uscire da screen, la sessione resta viva e la porta risulta occupata al tentativo successivo (Cannot open line … Resource busy). La ritroviamo così:
screen -ls # elenco delle sessioni
screen -r # riaggancia l'unica sessione staccata
screen -r 12345 # riaggancia una sessione precisa (il numero dall'elenco)
Il break merita una nota: è la sequenza che sui router Cisco, all’accensione, porta in ROMMON per il recupero della password. Non tutti gli adattatori USB lo trasmettono correttamente; se non funziona, proviamo con un cavo con chip FTDI. Il principio è lo stesso del recupero password sui server, di cui avevo parlato nella guida Recuperare la password su Linux.
Salvare la sessione in un file
Prima di toccare un apparato in produzione conviene registrare tutto (il classico show running-config prima delle modifiche):
cd ~/Documenti/console
screen -L /dev/cu.usbserial-A10KXYZ1 9600
Con -L screen scrive l’output in screenlog.0 nella cartella corrente; Ctrl+A poi H fa la stessa cosa a sessione già aperta. Attenzione: la versione di screen inclusa in macOS è la 4.00.03, molto vecchia, e non conosce l’opzione -Logfile delle versioni recenti per scegliere il nome del file. Rinominiamo il file a fine sessione, oppure installiamo una versione aggiornata con brew install screen.
Le alternative a screen
Anche cu è già nel sistema. Si esce digitando ~. all’inizio di una riga (prima Invio, poi tilde e punto):
cu -l /dev/cu.usbserial-A10KXYZ1 -s 9600
Se cu rifiuta di aprire la porta per un problema di permessi sul file di lock, eseguiamolo con sudo. Su una tastiera italiana la tilde si ottiene con Opzione+5.
minicom, familiare a chi viene da Linux, si installa con Homebrew:
brew install minicom
minicom -D /dev/cu.usbserial-A10KXYZ1 -b 9600
Il tasto di comando di minicom su macOS può essere diverso da quello di Linux (Ctrl+A): lo indica la riga di stato alla partenza. Infine esistono applicazioni grafiche per terminale seriale, gratuite o a pagamento (per esempio CoolTerm o Serial): comode per chi le preferisce, ma per il lavoro quotidiano screen basta e avanza.
SSH verso apparati datati
Un vecchio switch, ancora in servizio, rifiuta la connessione dal Mac con un messaggio come questo:
Unable to negotiate with 192.168.1.250 port 22: no matching key exchange method found.
Their offer: diffie-hellman-group14-sha1,diffie-hellman-group1-sha1
Il motivo: macOS 26 include OpenSSH 10.3, che non propone più per impostazione predefinita gli algoritmi basati su SHA-1, considerati deboli. L’apparato invece conosce solo quelli. Il messaggio ci dice già che cosa offre l’altra parte (Their offer): riabilitiamo solo quello che serve, con il + davanti, che aggiunge l’algoritmo all’elenco invece di sostituirlo.
ssh -oKexAlgorithms=+diffie-hellman-group14-sha1 \
-oHostKeyAlgorithms=+ssh-rsa \
-oPubkeyAcceptedAlgorithms=+ssh-rsa \
admin@192.168.1.250
Ogni opzione risponde a un errore diverso:
| Errore | Opzione |
|---|---|
no matching key exchange method found | KexAlgorithms=+diffie-hellman-group14-sha1 (sugli apparati molto vecchi +diffie-hellman-group1-sha1) |
no matching host key type found. Their offer: ssh-rsa | HostKeyAlgorithms=+ssh-rsa |
| Autenticazione con chiave RSA rifiutata | PubkeyAcceptedAlgorithms=+ssh-rsa |
no matching cipher found | Ciphers=+aes128-cbc (o +3des-cbc per i più antichi) |
Per non riscrivere tutto ogni volta, mettiamo le opzioni in ~/.ssh/config, solo per quell’host:
# Switch datato: algoritmi legacy SOLO per questo apparato
Host sw-magazzino
HostName 192.168.1.250
User admin
KexAlgorithms +diffie-hellman-group14-sha1
HostKeyAlgorithms +ssh-rsa
PubkeyAcceptedAlgorithms +ssh-rsa
# Impostazioni comuni per tutti gli altri host
Host *
ServerAliveInterval 30Ora basta ssh sw-magazzino. Per controllare quali algoritmi verranno davvero usati con quell’host: ssh -G sw-magazzino | grep -i -E "kex|hostkey"; per vedere quali conosce il nostro client: ssh -Q kex, ssh -Q cipher, ssh -Q key. Se qualcosa non va, ssh -vv mostra la negoziazione passo per passo.
Non mettiamo mai questi algoritmi sotto Host *: indeboliremmo tutte le connessioni, anche verso i server moderni. Usiamoli solo verso apparati raggiungibili da una rete di gestione, e programmiamo l’aggiornamento del firmware. Sugli apparati che lo permettono, rigenerare una chiave RSA da 2048 bit o più e aggiornare il software risolve alla radice. Le chiavi DSA (ssh-dss) non sono più supportate da OpenSSH 10: un apparato che offre solo quelle non è raggiungibile dal client del Mac, e va riconfigurato dalla console. Per la parte server, i criteri di una configurazione moderna sono nella guida SSH sicuro su Linux.
Telnet e prove sulle porte TCP
Il client telnet non è più incluso in macOS da molti anni (è sparito con High Sierra). Su alcuni apparati, però, serve ancora, e torna comodo per provare a mano un protocollo testuale. Abbiamo due strade:
brew install telnet
telnet 192.168.1.250 # sessione su un vecchio apparato
nc 192.168.1.250 23 # senza installare niente, con dei limiti
nc apre la connessione ma non gestisce la negoziazione delle opzioni telnet: su molti apparati vedremo caratteri strani all’inizio e il login potrebbe comportarsi in modo anomalo. Va bene per una prova veloce, non per lavorarci. Ricordiamo che telnet trasmette in chiaro anche le password: usiamolo solo dove SSH proprio non c’è.
Provare un servizio a mano
Il server di posta risponde? Colleghiamoci alla porta 25 e parliamo SMTP:
telnet mail.example.com 25 # oppure: nc mail.example.com 25
220 mail.example.com ESMTP
EHLO prova.example.com
250-mail.example.com
250-STARTTLS
...
QUIT
Sulle porte cifrate telnet e nc non bastano: dall’altra parte c’è TLS fin dal primo byte (porta 465) o dopo il comando STARTTLS (porta 587). Qui serve openssl s_client, che apre la sessione cifrata e poi ci lascia scrivere come in telnet:
openssl s_client -connect mail.example.com:465 -crlf
openssl s_client -connect mail.example.com:587 -starttls smtp -crlf
openssl s_client -connect mail.example.com:993 # IMAP su TLS
L’opzione -crlf manda i fine riga nel formato che i server di posta si aspettano. Nell’output troviamo anche il certificato presentato dal server, utile per capire se è scaduto o se il nome non corrisponde (ne parliamo nella guida Certificati e chiavi con OpenSSL dal Mac). Se ci basta sapere se la porta è aperta, nc -vz mail.example.com 465 è più rapido.
Trasferire configurazioni e firmware
Il server TFTP integrato
Molti apparati salvano la configurazione e caricano il firmware via TFTP. macOS ha un server TFTP già pronto, disattivato, che serve la cartella /private/tftpboot. Lo verifichiamo e lo avviamo così:
ls -l /System/Library/LaunchDaemons/tftp.plist
sudo launchctl load -F /System/Library/LaunchDaemons/tftp.plist
sudo lsof -nP -iUDP:69 # deve risultare in ascolto (lo tiene launchd)
-F forza il caricamento anche se il servizio è marcato come disattivato. load è la sintassi storica di launchctl, ancora funzionante ma deprecata: i dettagli e la sintassi nuova sono nella guida Servizi in background con launchctl. Il server resta attivo fino al riavvio, o fino a quando lo fermiamo:
sudo launchctl unload -F /System/Library/LaunchDaemons/tftp.plist
Il server TFTP di macOS, per sicurezza, non crea file nuovi: per ricevere una configurazione dall’apparato il file deve già esistere ed essere scrivibile da tutti. Prepariamolo prima:
sudo touch /private/tftpboot/sw-magazzino.cfg
sudo chmod 666 /private/tftpboot/sw-magazzino.cfg
# per servire un firmware all'apparato basta copiarlo nella cartella
sudo cp ~/Downloads/firmware-switch.bin /private/tftpboot/
sudo chmod 644 /private/tftpboot/firmware-switch.bin
A questo punto, dalla console dell’apparato (esempio con la sintassi Cisco IOS, con il Mac all’indirizzo 192.168.1.20):
copy running-config tftp://192.168.1.20/sw-magazzino.cfg
copy tftp://192.168.1.20/firmware-switch.bin flash:
Se il trasferimento va in timeout, controlliamo il firewall di macOS (Impostazioni di Sistema › Rete › Firewall): con l’opzione che blocca tutte le connessioni in entrata, il TFTP non passa. TFTP non ha autenticazione né cifratura: spegniamolo appena finito.
Su macOS 26 sia /System/Library/LaunchDaemons/tftp.plist sia /private/tftpboot sono presenti. Apple potrebbe però toglierli in futuro, come ha fatto con altri strumenti: se mancano, un server TFTP si può installare con Homebrew o lanciare in un’applicazione dedicata.
scp, quando l’apparato lo permette
Sugli apparati che hanno un server SCP attivo (su Cisco IOS si abilita con ip scp server enable) possiamo copiare i file con SSH, cifrati e autenticati:
scp -O sw-magazzino:running-config ./sw-magazzino.cfg
scp -O firmware-switch.bin sw-magazzino:flash:/firmware-switch.bin
L’opzione -O serve perché il client recente usa per impostazione predefinita il protocollo SFTP, che molti apparati non conoscono; -O torna al vecchio protocollo SCP. Le opzioni per gli algoritmi legacy le prende da ~/.ssh/config, come ssh. L’uso di scp tra server l’avevo descritto anche nella mia guida Backup con rsync tra server.
Problemi comuni
| Sintomo | Causa e soluzione |
|---|---|
Nessun /dev/cu.usbserial… dopo aver collegato il cavo | Cavo non riconosciuto o solo di ricarica. Controllare in Informazioni di sistema › USB; provare un’altra porta o un hub diverso; verificare il chip e, solo se serve, il driver del produttore |
| Schermo nero, nessun prompt | Premere Invio; verificare velocità, cavo rollover giusto e porta CONSOLE (non AUX) |
| Caratteri senza senso | Velocità sbagliata: riprovare con 9600, 115200 e le intermedie |
Cannot open line … Resource busy | Un’altra sessione usa la porta. screen -ls e screen -r, oppure chiudere il programma che la tiene aperta |
| Il Terminale si blocca aprendo la porta | Si sta usando /dev/tty.* che attende la portante: usare /dev/cu.* |
| Il break non porta in ROMMON | L’adattatore non trasmette il break correttamente: provare con un cavo FTDI |
no matching key exchange method found | Apparato con algoritmi SHA-1: opzioni legacy in ~/.ssh/config solo per quell’host |
telnet: command not found | Non è più in macOS: brew install telnet o nc per prove veloci |
scp: Connection closed verso un apparato | L’apparato non supporta SFTP: aggiungere -O; verificare che il server SCP sia abilitato |
TFTP: Access violation o file non scritto | Il file non esiste o non è scrivibile: touch e chmod 666 prima del trasferimento |
Il passo successivo
Una volta in console, il problema spesso è di instradamento: la guida La rete dal Terminale del Mac spiega come aggiungere le rotte verso le reti di gestione e diagnosticare con ping, traceroute e route -n get. Se configuriamo VPN sui router Cisco, le guide Tunnel GRE tra Cisco e Ubuntu e IPsec tra Cisco e Ubuntu partono proprio dalla console. Per i certificati dei servizi che proviamo con openssl s_client, proseguiamo con Certificati e chiavi con OpenSSL dal Mac.
Prova sempre la configurazione in laboratorio, salva quella attuale prima di modificarla e tieni un accesso di emergenza (console o accesso fuori banda) quando lavori su firewall e VPN da remoto.