Da Termius a Termix
La migrazione dei miei host SSH da un client commerciale in abbonamento a un server self-hosted sul NAS — compreso lo scavare nel database cifrato di un'app Mac App Store per tirarne fuori i dati.
Il problema
Da anni tengo la rotta verso le mie macchine — server, Raspberry, NAS, il telescopio — dentro Termius, un client SSH con sincronizzazione a pagamento. Funziona bene, ma i miei host, e le credenziali per raggiungerli, vivono sui server di qualcun altro, dietro un abbonamento. Volevo la stessa comodità (Mac, PC, telefono, sempre allineati) con i dati a casa mia: Termix, un gestore SSH open source da ospitare da sé, sul NAS.
Il piano
Un server Termix in un container sul NAS Synology, non esposto a Internet: dentro casa lo si raggiunge dalla rete locale, fuori casa solo tramite la VPN WireGuard. I client sono le app desktop (Mac e Windows) e il telefono, tutti sincronizzati con il server. Per l’astrofotografia c’è un caso particolare: in campagna non c’è Internet, quindi l’app desktop deve funzionare anche da sola e riallinearsi quando torna in rete. Per questo il Raspberry del telescopio compare due volte — “casa” e “campo” — con indirizzi diversi.
La parte difficile: far parlare Termius
Termius non offre un export pulito. Il percorso è stato estrarre il database locale dell’app, cifrato, e decifrarlo con lo stesso binario di Termius, poi convertirlo nel formato di import di Termix con un piccolo script. Tre ostacoli poco ovvi:
- La versione dell’App Store gira in una sandbox: può leggere e scrivere solo nel proprio contenitore. Decifrare i dati da fuori dà errore; funziona solo se file di lavoro e cartella temporanea stanno dentro il contenitore dell’app. Lo script di export si prepara lì dentro e ripulisce alla fine.
- Lo schema è cambiato: lo strumento di export open source che ho usato non trovava neanche un host sulla versione 10 di Termius, perché i dati sono ora spezzati in database separati (host, configurazioni SSH, identità, gruppi). Il convertitore rifà il “join” a mano, e gestisce anche le identità collegate solo tramite una tabella a parte.
- Le password vuote non sono vuote: dove in Termius non c’era nessuna password salvata, lo strumento “decifra” una stringa vuota e lascia in giro il testo cifrato, che sembra una password vera. Il convertitore lo riconosce dalla forma e lo tratta come “nessuna password” — 6 host hanno richiesto comunque una correzione a mano.
Un altro dettaglio: per i record rimasti a metà sincronizzazione, Termius conserva due versioni della stessa password, una locale e una dell’ultima sincronizzazione. Quella locale era quella giusta.
Un errore di sync poco chiaro
Dopo l’aggiornamento del server alla 2.9.0, l’app desktop ancora alla 2.8.0 rifiutava di sincronizzare con un generico errore 404: la nuova versione ha cambiato il protocollo di sincronizzazione. Il server e tutti i client devono quindi avere la stessa versione, da aggiornare insieme. Un tranello in più: i pacchetti di installazione delle due versioni hanno lo stesso nome di file, e si distinguono solo dall’indirizzo di download.
Pulizia
Il file di export contiene password in chiaro, quindi viene cancellato in modo sicuro
(rm -P, che lo sovrascrive) appena finito l’import, e lo script stesso elimina i file
temporanei decifrati anche in caso di errore. Nulla di tutto questo va mai su git.
Stato
Completato l’8 ottobre 2026. I 22 host SSH sono in Termix e funzionano tutti — il duplicato è stato eliminato — con le app desktop per Mac e Windows in modalità autonoma più sincronizzazione, e l’app per il telefono tramite la VPN. Il Raspberry del telescopio ha le sue due voci, “casa” e “campo”, con gli indirizzi definitivi, più un client SSH di riserva sul telefono per la campagna. La cartella dati di Termix — database, chiavi di cifratura e certificati — è nel backup del NAS, verificato. Qualche host Telnet è rimasto fuori di proposito. Resta solo una cosa, che non è tecnica: tenere Termius in parallelo ancora qualche settimana, e poi disdire l’abbonamento.
Stack
Node.js · zsh · SSH · Docker · Synology Container Manager · WireGuard