← Tutti i progetti
Completato ottobre 2026

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.

Node.jsShellSSHDockerSynologySelf-hosting

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:

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