
Router SSH consapevole della rete - instrada le connessioni verso diversi IP/porte/chiavi/host di salto in base alla VPN attiva o alla rete
| CI | Codice | OpenSpec | Sicurezza |
|---|---|---|---|
|
|
|
|
|
Router SSH consapevole della rete. Rileva la tua rete attiva o la VPN e seleziona automaticamente l'host, la porta, il file di identità e l'host di salto corretti per ogni connessione SSH — senza toccare ~/.ssh/config.
Definisci ogni host logico una sola volta con un profilo default e override opzionali per singola rete. A ogni connessione, sshroute rileva su quale rete ti trovi (VPN, LAN dell'ufficio, peer WireGuard, ecc.) e risolve i parametri SSH corretti prima di passare il controllo al vero /usr/bin/ssh.
ssh myserver
→ sshroute detects: corp-vpn is active
→ resolves: 10.100.0.50:2222 via bastion.corp.internal
→ exec /usr/bin/ssh -p 2222 -i ~/.ssh/corp_key -J bastion.corp.internal 10.100.0.50
Il tuo lab probabilmente ha almeno due realtà: sei a casa sulla LAN, oppure sei fuori e ti connetti tramite WireGuard o un'altra VPN. Il problema è che ~/.ssh/config non sa in quale delle due ti trovi — così finisci con alias separati (server-lan, server-vpn), oppure un jump host che funziona solo a metà, oppure semplicemente memorizzi gli IP.
sshroute risolve questo rilevando la tua rete attuale prima di ogni connessione. Quando l'interfaccia WireGuard è attiva e la route del peer esiste, si connette direttamente all'IP del tunnel. Quando sei sulla LAN, usa l'indirizzo locale. Quando nessuno dei due è raggiungibile, ricade sul nome host pubblico. Un alias, tre realtà, zero commutazione manuale.
Intercetta inoltre SSH in modo trasparente — git push, rsync, scp passano tutti attraverso di esso automaticamente una volta configurata la modalità shadow. Nessun wrapper, nessuna funzione shell, nessun pensiero.
Le reti enterprise sono peggiori. Hai l'internet pubblico, magari una VPN site-to-site, magari una VPN personale split-tunnel, e all'interno hai diversi jump host a seconda dell'ambiente di destinazione — dev, staging, prod, ciascuno con il proprio bastion e la propria chiave. Tenere tutto questo in ordine in ~/.ssh/config significa o un unico enorme config che si rompe ogni volta che l'infrastruttura cambia, oppure scrivere uno script che ogni membro del team mantiene in modo diverso.
sshroute ti permette di definire la logica di routing in modo dichiarativo, mantenerla in un file YAML versionato e condividerla con tutto il team. La stessa configurazione funziona per tutti — la rete corretta viene rilevata automaticamente in base a quali interfacce o route sono attive su ciascuna macchina. Chiavi, porte, utenti e jump host vengono risolti senza che l'utente debba pensarci.
| Funzionalità | ~/.ssh/config | Solo WireGuard | Teleport / Boundary | sshroute |
|---|---|---|---|---|
| Rileva la tua rete attuale | ❌ | ❌ | ❌ | ✅ |
| Sceglie automaticamente il percorso migliore | ❌ | ❌ | ❌ | ✅ |
| Ricade su alternative in caso di errore di connessione | ❌ | ❌ | ✅ | ✅ |
| Riconnessione automatica + ri-routing in caso di caduta | ❌ | ⚠️ roaming del tunnel | ⚠️ tramite proxy fisso | ✅ |
| Un comando per host, da qualsiasi posizione | ❌ | ⚠️ VPN deve essere attiva | ✅ | ✅ |
| Dimensione della config per 10 host × 4 percorsi | 📄 ~600 righe | 📄 ~600 righe + config VPN | 📄 config lato server | 📄 ~60 righe |
| Dispositivi mobili in roaming | ⚠️ alias manuali | ⚠️ VPN richiesta | ✅ | ✅ |
| Concatenamento automatico dei jump host | ⚠️ -J manuale | ➖ n/d | ✅ | ✅ |
| Funziona con scp / rsync / git / Ansible | ✅ | ✅ | ⚠️ parziale | ✅ |
| Nessuna installazione lato server sui target | ✅ | ❌ | ❌ | ✅ |
| Nessun auth server o daemon da eseguire | ✅ | ❌ | ❌ | ✅ |
| Nessun agente client | ✅ | ❌ | ❌ | ✅ |
| Open source, completamente self-hosted | ✅ | ✅ | ⚠️ open-core | ✅ |
Teleport e Boundary sono una categoria diversa — aggiungono controllo degli accessi, log di audit e autenticazione basata su certificati sopra al routing. Se è questo ciò di cui hai bisogno, usali. sshroute è per quando vuoi l'intelligenza di routing senza il carico operativo di gestire un auth server centrale.
Scarica l'ultima release da GitHub Releases. I binari sono disponibili per Linux, macOS e Android su AMD64 e ARM64.
go install github.com/thereisnotime/sshroute@latest
Scarica il tarball android_arm64 da GitHub Releases, estrailo e colloca il binario in ~/.local/bin:
mkdir -p ~/.local/bin
curl -Lo "$TMPDIR/sshroute.tar.gz" \
https://github.com/thereisnotime/sshroute/releases/latest/download/sshroute_android_arm64.tar.gz
tar -xzf "$TMPDIR/sshroute.tar.gz" -C ~/.local/bin sshroute
chmod +x ~/.local/bin/sshroute