
Netzwerkbewusster SSH-Router - leitet Verbindungen zu verschiedenen IPs/Ports/Keys/Sprunghosts basierend auf dem aktiven VPN oder Netzwerk um.
| CI | Code | OpenSpec | Security |
|---|---|---|---|
|
|
|
|
|
Netzwerkbewusster SSH-Router. Erkennt dein aktives Netzwerk oder VPN und wählt automatisch den richtigen Host, Port, die richtige Identitätsdatei und den richtigen Jump-Host für jede SSH-Verbindung aus – ohne ~/.ssh/config anzutasten.
Definiere jeden logischen Host einmal mit einem default-Profil und optionalen netzwerkspezifischen Überschreibungen. Bei jeder Verbindung erkennt sshroute, in welchem Netzwerk du dich befindest (VPN, Büro-LAN, WireGuard-Peer usw.), und löst die korrekten SSH-Parameter auf, bevor die Übergabe an das echte /usr/bin/ssh erfolgt.
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
Dein Lab hat wahrscheinlich mindestens zwei Realitäten: Entweder du sitzt zu Hause im LAN oder du bist unterwegs und kommst über WireGuard oder ein anderes VPN herein. Das Problem ist, dass ~/.ssh/config nicht weiß, in welcher du dich befindest – also endest du mit separaten Aliasen (server-lan, server-vpn), oder einem Jump Host, der nur die Hälfte der Zeit funktioniert, oder du merkst dir einfach die IPs.
sshroute löst das, indem es dein aktuelles Netzwerk vor jeder Verbindung erkennt. Wenn das WireGuard-Interface aktiv ist und die Peer-Route existiert, verbindet es direkt zur Tunnel-IP. Wenn du im LAN bist, verwendet es die lokale Adresse. Wenn keines von beiden erreichbar ist, fällt es auf den öffentlichen Hostnamen zurück. Ein Alias, drei Realitäten, null manuelles Umschalten.
Es fängt SSH außerdem transparent ab – git push, rsync, scp laufen alle automatisch darüber, sobald du den Shadow-Modus eingerichtet hast. Keine Wrapper, keine Shell-Funktionen, kein Nachdenken.
Unternehmensnetzwerke sind schlimmer. Du hast das öffentliche Internet, vielleicht ein Site-to-Site-VPN, vielleicht ein persönliches VPN mit Split-Tunnel, und darin hast du verschiedene Jump Hosts, je nachdem, welche Umgebung du anvisierst – Dev, Staging, Prod, jede mit ihrem eigenen Bastion und Schlüssel. Das in ~/.ssh/config gerade zu halten bedeutet entweder eine riesige Konfiguration, die bei jeder Infrastrukturänderung bricht, oder ein Skript, das jedes Teammitglied anders pflegt.
sshroute lässt dich die Routing-Logik deklarativ definieren, in einer versionierten YAML-Datei halten und im Team teilen. Dieselbe Konfiguration funktioniert für alle – das richtige Netzwerk wird automatisch anhand der aktiven Interfaces oder Routen auf jedem Rechner erkannt. Schlüssel, Ports, Benutzer und Jump Hosts werden aufgelöst, ohne dass der Benutzer darüber nachdenken muss.
| Funktion | ~/.ssh/config | Nur WireGuard | Teleport / Boundary | sshroute |
|---|---|---|---|---|
| Erkennt dein aktuelles Netzwerk | ❌ | ❌ | ❌ | ✅ |
| Wählt automatisch den besten Pfad | ❌ | ❌ | ❌ | ✅ |
| Fällt bei Verbindungsfehler zurück | ❌ | ❌ | ✅ | ✅ |
| Automatische Wiederverbindung + Neu-Routing bei Abbruch | ❌ | ⚠️ Tunnel-Roaming | ⚠️ über festen Proxy | ✅ |
| Ein Befehl pro Host, an jedem Standort | ❌ | ⚠️ VPN muss aktiv sein | ✅ | ✅ |
| Konfigurationsgröße für 10 Hosts × 4 Pfade | 📄 ~600 Zeilen | 📄 ~600 Zeilen + VPN-Konfiguration | 📄 serverseitige Konfiguration | 📄 ~60 Zeilen |
| Roaming mobiler Geräte | ⚠️ manuelle Aliase | ⚠️ VPN erforderlich | ✅ | ✅ |
| Automatische Jump-Host-Verkettung | ⚠️ manuell -J | ➖ n/a | ✅ | ✅ |
| Funktioniert mit scp / rsync / git / Ansible | ✅ | ✅ | ⚠️ teilweise | ✅ |
| Keine serverseitige Installation auf Zielen | ✅ | ❌ | ❌ | ✅ |
| Kein Auth-Server oder Daemon nötig | ✅ | ❌ | ❌ | ✅ |
| Kein Client-Agent | ✅ | ❌ | ❌ | ✅ |
| Open Source, vollständig selbst gehostet | ✅ | ✅ | ⚠️ Open-Core | ✅ |
Teleport und Boundary sind eine andere Kategorie – sie fügen Zugriffskontrolle, Audit-Logs und zertifikatsbasierte Authentifizierung zusätzlich zum Routing hinzu. Wenn du das brauchst, verwende sie. sshroute ist für den Fall, dass du die Routing-Intelligenz willst, ohne den operativen Aufwand eines zentralen Auth-Servers.
Lade die neueste Version von GitHub Releases herunter. Binaries sind für Linux, macOS und Android auf AMD64 und ARM64 verfügbar.
go install github.com/thereisnotime/sshroute@latest
Laden Sie das android_arm64-Tarball von GitHub Releases herunter, entpacken Sie es und legen Sie die Binärdatei in ~/.local/bin ab:
Entdecken Sie die meistgenutzten Tools unserer Community.
Noch keine Beliebtheitsdaten.