thereisnotime/sshrouteNetzwerkbewusster SSH-Router - leitet Verbindungen zu verschiedenen IPs/Ports/Keys/Sprunghosts basierend auf dem aktiven VPN oder Netzwerk um.
# sshroute
<table>
<tr>
<th>CI</th>
<th>Code</th>
<th>OpenSpec</th>
<th>Security</th>
</tr>
<tr>
<td>
<a href="https://github.com/thereisnotime/sshroute/actions/workflows/ci.yaml"><img src="https://github.com/thereisnotime/sshroute/actions/workflows/ci.yaml/badge.svg" alt="CI"></a><br>
<a href="https://github.com/thereisnotime/sshroute/actions/workflows/release.yaml"><img src="https://github.com/thereisnotime/sshroute/actions/workflows/release.yaml/badge.svg" alt="Release"></a><br>
<a href="https://github.com/thereisnotime/sshroute/actions/workflows/openspec-badge.yaml"><img src="https://github.com/thereisnotime/sshroute/actions/workflows/openspec-badge.yaml/badge.svg" alt="OpenSpec Badge"></a><br>
<a href="https://github.com/thereisnotime/sshroute/actions/workflows/scorecard.yaml"><img src="https://github.com/thereisnotime/sshroute/actions/workflows/scorecard.yaml/badge.svg" alt="Scorecard"></a>
</td>
<td>
<a href="https://github.com/thereisnotime/sshroute/releases/latest"><img src="https://img.shields.io/github/v/release/thereisnotime/sshroute" alt="Latest Release"></a><br>
<a href="https://codecov.io/gh/thereisnotime/sshroute"><img src="https://codecov.io/gh/thereisnotime/sshroute/branch/main/graph/badge.svg" alt="codecov"></a><br>
<a href="https://goreportcard.com/report/github.com/thereisnotime/sshroute"><img src="https://goreportcard.com/badge/github.com/thereisnotime/sshroute" alt="Go Report Card"></a><br>
<a href="https://pkg.go.dev/github.com/thereisnotime/sshroute"><img src="https://pkg.go.dev/badge/github.com/thereisnotime/sshroute.svg" alt="Go Reference"></a>
</td>
<td>
<a href="https://github.com/thereisnotime/sshroute/blob/main/openspec/specs"><img src="https://raw.githubusercontent.com/thereisnotime/sshroute/gh-pages/badges/number_of_specs.svg" alt="Specs"></a><br>
<a href="https://github.com/thereisnotime/sshroute/blob/main/openspec/specs"><img src="https://raw.githubusercontent.com/thereisnotime/sshroute/gh-pages/badges/number_of_requirements.svg" alt="Requirements"></a><br>
<a href="https://github.com/thereisnotime/sshroute/blob/main/openspec/changes"><img src="https://raw.githubusercontent.com/thereisnotime/sshroute/gh-pages/badges/tasks_status.svg" alt="Tasks"></a><br>
<a href="https://github.com/thereisnotime/sshroute/blob/main/openspec/changes"><img src="https://raw.githubusercontent.com/thereisnotime/sshroute/gh-pages/badges/open_changes.svg" alt="Open Changes"></a>
</td>
<td>
<a href="https://scorecard.dev/viewer/?uri=github.com/thereisnotime/sshroute"><img src="https://api.scorecard.dev/projects/github.com/thereisnotime/sshroute/badge" alt="OpenSSF Scorecard"></a><br>
<a href="https://www.bestpractices.dev/projects/12389"><img src="https://www.bestpractices.dev/projects/12389/badge" alt="CII Best Practices"></a><br>
<a href="https://github.com/thereisnotime/sshroute/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License: Apache 2.0"></a>
</td>
</tr>
</table>
Netzwerkbewusster SSH-Router. Erkennt Ihr aktives Netzwerk oder VPN und wählt automatisch den richtigen Host, Port, Identity File und Jump-Host für jede SSH-Verbindung aus – ohne `~/.ssh/config` anfassen zu müssen.
## So funktioniert es
Definieren Sie jeden logischen Host einmal mit einem `default`-Profil und optionalen netzwerkspezifischen Überschreibungen. Bei jeder Verbindung erkennt sshroute, in welchem Netzwerk Sie sich befinden (VPN, Büro-LAN, WireGuard-Peer usw.) und löst die korrekten SSH-Parameter auf, bevor es an das echte `/usr/bin/ssh` übergibt.
```
ssh myserver
→ sshroute erkennt: corp-vpn ist aktiv
→ löst auf: 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
```
## Warum sshroute?
### Für Homelab-Betreiber
Ihr Labor hat wahrscheinlich mindestens zwei Realitäten: Entweder Sie sitzen zu Hause im LAN oder Sie sind unterwegs und kommen über WireGuard oder ein anderes VPN herein. Das Problem: `~/.ssh/config` weiß nicht, in welchem Sie sich befinden – also landen Sie bei separaten Aliasen (`server-lan`, `server-vpn`), einem Jump-Host, der nur halb funktioniert, oder Sie merken sich einfach IPs.
sshroute löst dies, indem es vor jeder Verbindung Ihr aktuelles Netzwerk erkennt. Wenn das WireGuard-Interface aktiv ist und die Peer-Route existiert, verbindet es direkt zur Tunnel-IP. Wenn Sie im LAN sind, verwendet es die lokale Adresse. Wenn keines erreichbar ist, fällt es auf den öffentlichen Hostnamen zurück. Ein Alias, drei Realitäten, null manuelles Umschalten.
Außerdem fängt sshroute SSH transparent ab – `git push`, `rsync`, `scp` werden automatisch darüber geleitet, sobald Sie den Schattenmodus eingerichtet haben. Keine Wrapper, keine Shell-Funktionen, kein Nachdenken.
### Für Unternehmensumgebungen
Unternehmensnetzwerke sind noch schlimmer. Sie haben das öffentliche Internet, vielleicht ein Site-to-Site-VPN, vielleicht ein persönliches VPN mit Split-Tunnel, und darin verschiedene Jump-Hosts, je nachdem, welche Umgebung Sie anvisieren – Dev, Staging, Prod, jede mit eigener Bastion und eigenem Schlüssel. Das in `~/.ssh/config` gerade zu halten bedeutet entweder eine riesige Konfiguration, die bei jeder Infrastrukturänderung kaputt geht, oder ein Skript, das jedes Teammitglied anders pflegt.
sshroute ermöglicht es Ihnen, die Routinglogik deklarativ zu definieren, in einer versionierten YAML-Datei zu speichern und im Team zu teilen. Die gleiche Konfiguration funktioniert für alle – das richtige Netzwerk wird automatisch erkannt, basierend darauf, welche Interfaces oder Routen auf jedem Rechner aktiv sind. Schlüssel, Ports, Benutzer und Jump-Hosts werden aufgelöst, ohne dass der Benutzer darüber nachdenken muss.
## Vergleich
| Funktion | `~/.ssh/config` | Nur WireGuard | Teleport / Boundary | sshroute |
|---|---|---|---|---|
| Erkennt Ihr aktuelles Netzwerk | ❌ | ❌ | ❌ | ✅ |
| Wählt automatisch den besten Pfad | ❌ | ❌ | ❌ | ✅ |
| Fallback bei Verbindungsfehler | ❌ | ❌ | ✅ | ✅ |
| Automatische Wiederverbindung + Neurouting bei Trennung | ❌ | ⚠️ Tunnel roamt | ⚠️ via festem Proxy | ✅ |
| Ein Befehl pro Host, von überall | ❌ | ⚠️ VPN muss aktiv sein | ✅ | ✅ |
| Konfigurationsgröße für 10 Hosts × 4 Pfade | 📄 ~600 Zeilen | 📄 ~600 Zeilen + VPN-Konfig | 📄 Server-seitige Konfig | 📄 ~60 Zeilen |
| Mobile Geräte im Roaming | ⚠️ manuelle Aliase | ⚠️ VPN erforderlich | ✅ | ✅ |
| Automatisches Chaining von Jump-Hosts | ⚠️ manuelles `-J` | ➖ n/a | ✅ | ✅ |
| Funktioniert mit scp / rsync / git / Ansible | ✅ | ✅ | ⚠️ teilweise | ✅ |
| Keine Server-Installation auf Zielen | ✅ | ❌ | ❌ | ✅ |
| Kein Authentifizierungsserver oder Daemon erforderlich | ✅ | ❌ | ❌ | ✅ |
| 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 zum Routing hinzu. Wenn Sie das brauchen, nutzen Sie sie. sshroute ist für diejenigen, die die Routing-Intelligenz wollen, ohne den Betriebsaufwand eines zentralen Auth-Servers.
## Installation
### Binär-Download
Laden Sie die neueste Veröffentlichung von [GitHub Releases](https://github.com/thereisnotime/sshroute/releases) herunter. Binärdateien sind für Linux, macOS und Android auf AMD64 und ARM64 verfügbar.
### Go install
```sh
go install github.com/thereisnotime/sshroute@latest
```
### Android (Termux)
Laden Sie das `android_arm64`-Tarball von [GitHub Releases](https://github.com/thereisnotime/sshroute/releases) herunter, extrahieren Sie es und legen Sie die Binärdatei in `~/.local/bin` ab:
```sh
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
```
Fügen Sie `~/.local/bin` zu Ihrem `PATH` in `~/.bashrc` oder `~/.profile` hinzu, falls noch nicht geschehen:
```sh
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
```
Alternativ können Sie mit Termux' Go aus dem Quellcode kompilieren. Da die offizielle Go-Toolchain keine android/arm64-Binärdateien veröffentlicht, setzen Sie `GOTOOLCHAIN=local`, um die von Termux mitgelieferte Version zu verwenden:
```sh
GOTOOLCHAIN=local go install github.com/thereisnotime/sshroute@latest
```
Setzen Sie nach der Installation den SSH-Binärpfad, da Termux kein `/usr/bin/ssh` hat:
```yaml
# ~/.config/sshroute/config.yaml
ssh_binary: /data/data/com.termux/files/usr/bin/ssh
```
Oder per Umgebungsvariable: `export SSHROUTE_SSH=$(which ssh)`
### Docker
```sh
docker run --rm -v ~/.config/sshroute:/root/.config/sshroute \
ghcr.io/thereisnotime/sshroute network
```
### Podman
```sh
podman run --rm -v ~/.config/sshroute:/root/.config/sshroute \
ghcr.io/thereisnotime/sshroute network
```
Auf Systemen mit SELinux (Fedora, RHEL usw.) fügen Sie dem Volume-Flag `:Z` hinzu:
```sh
podman run --rm -v ~/.config/sshroute:/root/.config/sshroute:Z \
ghcr.io/thereisnotime/sshroute network
```
### Schattenmodus (transparenter SSH-Ersatz)
Installieren Sie sshroute als `ssh` weiter vorne in Ihrem `$PATH`. Alle SSH-Aufrufe – vom Terminal, von `git`, `rsync`, `scp` – werden automatisch abgefangen. Hosts, die nicht in Ihrer Konfiguration stehen, werden unverändert an `/usr/bin/ssh` durchgereicht.
```sh
mkdir -p ~/.local/bin
ln -s $(which sshroute) ~/.local/bin/ssh
# In ~/.bashrc oder ~/.zshrc hinzufügen, falls nicht vorhanden:
export PATH="$HOME/.local/bin:$PATH"
```
## Schnellstart
```sh
# Einen Host mit einem Standardprofil hinzufügen
sshroute add myserver --host myserver.example.com --user alice --key ~/.ssh/id_ed25519
# Eine VPN-spezifische Überschreibung hinzufügen
sshroute add myserver --network vpn --host 10.8.0.50 --port 2222 --jump bastion.vpn
# Verbinden – Netzwerk wird automatisch erkannt
sshroute connect myserver
# Den aufgelösten Befehl anzeigen, ohne ihn auszuführen
sshroute connect myserver --dry-run
# Sehen, welches Netzwerk gerade aktiv ist
sshroute network
```
## Befehle
### Globale Flags
Diese Flags gelten für jeden Befehl:
| Flag | Umgebungsvariable | Standard | Beschreibung |
|---|---|---|---|
| `--config` | `SSHROUTE_CONFIG` | `~/.config/sshroute/config.yaml` | Pfad zur Konfigurationsdatei |
| `-o, --output` | | `table` | Ausgabeformat: `table`, `json`, `yaml` |
| `-v, --verbose` | `SSHROUTE_VERBOSE=1` | `false` | Debug-Ausgabe nach stderr |
| `--dry-run` | | `false` | Aufgelösten SSH-Befehl ausgeben, ohne ihn auszuführen |
### `init`
Erstellt eine Startkonfigurationsdatei mit kommentierten Beispielen. Schlägt fehl, wenn die Datei bereits existiert.
| Flag | Standard | Beschreibung |
|---|---|---|
| `--force` | `false` | Vorhandene Konfigurationsdatei überschreiben |
### `connect <alias>`
Erkennt das aktive Netzwerk, löst die SSH-Parameter für `alias` auf und führt die echte SSH-Binärdatei aus. Zusätzliche Argumente nach dem Alias werden unverändert an SSH durchgereicht.
| Flag | Standard | Beschreibung |
|---|---|---|
| `--fallback` | `false` | Jedes Profil in der Prioritätsreihenfolge versuchen und nur bei einem Verbindungsfehler (Exit 255) zum nächsten wechseln |
| `--reconnect` | `false` | Verbindung überwachen und bei Trennung automatisch wieder verbinden, dabei das aktive Netzwerk neu erkennen und die Route jedes Mal neu auflösen |
| `--reconnect-delay` | `2s` | Wartezeit zwischen Wiederverbindungsversuchen, wenn `--reconnect` gesetzt ist |
Mit `--reconnect` hält sshroute die SSH-Verbindung über abgebrochene Verbindungen hinweg aufrecht (Laptop-Schlaf, WLAN-Handover, Roaming zwischen Netzwerken). Da es bei jeder Wiederverbindung das Netzwerk neu erkennt, folgt es Ihnen auf eine andere Route: Werden Sie z. B. im LAN schlafen und an einem Hotspot aufwachen, wird über die öffentliche Route neu verbunden, anstatt die jetzt unerreichbare LAN-Adresse erneut zu versuchen. Ein sauberer Logout (Exit 0) oder ein Fehler bei Authentifizierung/Remote-Befehl stoppt die Schleife; nur echte Verbindungsabbrüche lösen eine Wiederverbindung aus. Der Wiederverbindungsmodus startet ssh als Unterprozess (wie `--fallback`), sodass sshroute für die Sitzung resident bleibt; `SIGINT`/`SIGTERM` beendet es. Der Sitzungszustand über den Aussetzer hinweg ist Aufgabe Ihres Multiplexers (tmux/zellij); kombinieren Sie `--reconnect` mit `-- tmux attach` oder `-- zellij attach -c <name>`, um direkt in Ihre Sitzung zurückzukehren:
```sh
sshroute connect myserver --reconnect --fallback -- zellij attach -c work
```
### `list`
Listet alle konfigurierten Hosts und die SSH-Parameter auf, die im aktuellen Netzwerk verwendet würden. Unterstützt `-o table|json|yaml`.
### `add <alias>`
Fügt einen Host hinzu oder aktualisiert einen vorhandenen. Ausgelassene Flags behalten ihren aktuellen Wert. Führen Sie den Befehl mehrmals mit verschiedenen `--network`-Werten aus, um netzwerkspezifische Überschreibungen zu erstellen.
| Flag | Standard | Beschreibung |
|---|---|---|
| `--host` | | Hostname oder IP-Adresse |
| `--port` | `22` | SSH-Port |
| `--user` | | SSH-Benutzername |
| `--key` | | Pfad zur Identity-Datei (unterstützt `~`) |
| `--jump` | | Jump-Host – wird als `-J` an SSH übergeben |
| `--network` | `default` | Netzwerkprofil, in das die Parameter geschrieben werden |
### `remove <alias>`
Entfernt alle Profile für `alias` aus der Konfiguration.
### `network`
Gibt den Namen des aktuell erkannten Netzwerks aus (oder `default`, wenn keins passt).
### `network list`
Listet alle konfigurierten Netzwerke mit ihrer Priorität, Prüfregeln und aktuellem Aktivitätsstatus auf. Unterstützt `-o table|json|yaml`.
### `network test <name>`
Führt jede Prüfung für das Netzwerk `name` aus und gibt bestanden/nicht bestanden pro Regel aus. Nützlich zum Debuggen der Erkennungslogik.
### `config`
Gibt den aufgelösten Pfad zur Konfigurationsdatei aus.
### `config edit`
Öffnet die Konfigurationsdatei in `$EDITOR` (fällt auf `nano` zurück). Erstellt die Datei und das übergeordnete Verzeichnis, falls sie nicht existieren.
### `resolve <alias>`
Gibt die SSH-Parameter aus, die für `alias` im aktuellen Netzwerk verwendet würden. Nützlich zum Debuggen und für Skripte. Verwenden Sie `--network <name>`, um das erkannte Netzwerk zu überschreiben. Unterstützt `-o table|json|yaml`.
| Flag | Standard | Beschreibung |
|---|---|---|
| `--network` | automatische Erkennung | Netzwerkprofil, gegen das aufgelöst werden soll |
### `copy <alias> <src> <dst>`
Kopiert Dateien zu oder von einem konfigurierten Host mit `scp` unter Verwendung derselben aufgelösten Parameter (Schlüssel, Port, Jump) wie `connect`. Verwenden Sie die Syntax `<alias>:<pfad>` für entfernte Pfade:
```sh
sshroute copy myserver ./local.txt myserver:/remote/path/
sshroute copy myserver myserver:/remote/file.txt ./local/
```
Die Umgebungsvariable `SSHROUTE_SCP` überschreibt die verwendete `scp`-Binärdatei.
### `version`
Gibt Version, Git-Commit, Build-Datum und Go-Laufzeitinformationen aus.
### `update`
Aktualisiert sshroute direkt auf die neueste GitHub-Version. Es lädt das Archiv für Ihre Plattform herunter, überprüft dessen sha256 gegen `checksums.txt` und – falls [`cosign`](https://github.com/sigstore/cosign) installiert ist – die Cosign-Signatur der Version, bevor es die laufende Binärdatei atomar ersetzt.
```sh
sshroute update # neueste Version herunterladen, verifizieren und installieren
sshroute update --check # nur melden, ob eine neuere Version verfügbar ist
sshroute update --force # neueste Version auch neu installieren, wenn bereits aktuell
```
Wenn die sha256-Prüfung (oder Cosign, falls vorhanden) fehlschlägt, wird das Update abgebrochen und die Binärdatei bleibt unberührt. Dieses Ziel sind Installationen der Release-Binärdatei; wenn Sie über `go install` oder einen Paketmanager installiert haben, aktualisieren Sie damit.
## Konfigurationsdatei
Standardpfad: `~/.config/sshroute/config.yaml`
```yaml
networks:
corp-vpn:
priority: 10 # niedriger = zuerst geprüft
checks:
- type: interface
match: wg0
- type: route
match: 10.100.0.0
office:
priority: 20
checks:
- type: ping
host: 192.168.1.1
timeout: 500ms
hosts:
myserver:
default: # erforderlich – wird verwendet, wenn kein Netzwerk passt
host: myserver.example.com
port: 22
user: alice
key: ~/.ssh/id_ed25519
options: # optional – als SSH -o Key=Value Flags übergeben
ConnectTimeout: "10"
ServerAliveInterval: "30"
corp-vpn:
host: 10.100.0.50
port: 2222
key: ~/.ssh/corp_key
jump: bastion.corp.internal
options:
ConnectTimeout: "5" # überschreibt den Standard nur für dieses Netzwerk
office:
host: 192.168.1.50
```
Jeder Host muss ein `default`-Profil haben. Netzwerkprofile müssen nur die Felder angeben, die vom Standard abweichen – nicht gesetzte Felder erben vom `default`.
### Felder des Host-Profils
| Feld | Typ | Beschreibung |
|---|---|---|
| `host` | string | Hostname oder IP-Adresse |
| `port` | int | SSH-Port (Standard: 22) |
| `user` | string | SSH-Benutzer |
| `key` | string | Pfad zur Identity-Datei (`~` wird expandiert) |
| `jump` | string | Jump-Host-Alias oder `user@host` |
| `options` | map | Beliebige SSH `-o Key=Value` Flags (z.B. `ConnectTimeout`, `StrictHostKeyChecking`) |
| `comment` | string | Beschreibung, die in `sshroute list` angezeigt wird |
| `tags` | list | Tags zum Filtern mit `sshroute list --tag` |
Die `options`-Schlüssel werden vom `default`-Profil in die Netzwerkprofile gemergt – Netzwerkeinträge überschreiben übereinstimmende Schlüssel, nicht überlappende Schlüssel werden vererbt.
## Netzwerkerkennung
Netzwerke werden in der Reihenfolge der `priority` ausgewertet (niedrigster Wert zuerst). Alphabetische Reihenfolge entscheidet bei Gleichstand. Das erste Netzwerk, dessen Prüfungen alle bestehen, wird verwendet; wenn keins passt, gilt `default`.
| Prüftyp | Besteht, wenn | Erforderliche Felder |
|---|---|---|
| `route` | Subnetz/IP in der Kernel-Routing-Tabelle erscheint | `match` |
| `interface` | Benanntes Interface existiert und ist betriebsbereit | `match` |
| `ping` | Host innerhalb des Timeouts auf ICMP-Echo antwortet | `host`, `timeout` (optional, Standard 2s) |
| `exec` | Shell-Befehl mit Exit-Code 0 beendet | `command` |
Mehrere Prüfungen innerhalb einer Netzwerkdefinition verwenden **UND**-Logik – alle müssen bestehen.
## Beispiele
Gebrauchsfertige Konfigurationsdateien befinden sich in [`examples/`](https://github.com/thereisnotime/sshroute/blob/main/examples):
| Datei | Anwendungsfall |
|---|---|
| [`basic.yaml`](https://github.com/thereisnotime/sshroute/blob/main/examples/basic.yaml) | Einzelner Host, VPN vs. öffentlicher Fallback |
| [`multi-network.yaml`](https://github.com/thereisnotime/sshroute/blob/main/examples/multi-network.yaml) | Büro-LAN, Firmen-VPN, Remote-VPN, öffentlich |
| [`wireguard-backconnect.yaml`](https://github.com/thereisnotime/sshroute/blob/main/examples/wireguard-backconnect.yaml) | WireGuard-Peer, der sich zu Ihnen zurückverbindet |
| [`jump-hosts.yaml`](https://github.com/thereisnotime/sshroute/blob/main/examples/jump-hosts.yaml) | Verschiedene Bastionen pro Netzwerk |
| [`multi-zone-roaming.yaml`](https://github.com/thereisnotime/sshroute/blob/main/examples/multi-zone-roaming.yaml) | Multi-Zonen-Homelab mit WireGuard-Gateway und mobilen Geräten im Roaming |
## Dokumentation
Ausführliche Anleitungen finden Sie in [`docs/`](https://github.com/thereisnotime/sshroute/blob/main/docs):
| Anleitung | Beschreibung |
|---|---|
| [Homelab-Einrichtung](https://github.com/thereisnotime/sshroute/blob/main/docs/homelab.md) | Multi-Zonen-Homelab mit WireGuard, Jump-Hosts, NAS, k3s-Knoten |
| [Multi-Zonen-Roaming](https://github.com/thereisnotime/sshroute/blob/main/docs/multi-zone-roaming.md) | Mehrere LANs, WireGuard-Gateway, mobile Geräte, die zwischen Netzwerken roamieren |
| [Unternehmen / Multi-Umgebung](https://github.com/thereisnotime/sshroute/blob/main/docs/corporate.md) | Dev/Staging/Prod mit umgebungsspezifischen Bastionen und VPN-Erkennung |
| [Schattenmodus](https://github.com/thereisnotime/sshroute/blob/main/docs/shadow-mode.md) | Transparenter SSH-Ersatz – git, rsync, scp, Ansible |
| [Shell-Vervollständigung](https://github.com/thereisnotime/sshroute/blob/main/docs/shell-completion.md) | Dynamische Alias-Vervollständigung für bash, zsh, fish |
| [Skripterstellung und Automatisierung](https://github.com/thereisnotime/sshroute/blob/main/docs/scripting.md) | Verwendung von `resolve` und `copy` in Skripten und CI-Pipelines |
## Ausgabeformate
Alle List-Befehle unterstützen mehrere Ausgabeformate:
```sh
sshroute list # Tabelle (Standard)
sshroute list -o json # JSON – für Skripte
sshroute list -o yaml # YAML
sshroute network list -o json
```
## Community
**Software herunterladen** – Laden Sie eine vorkompilierte Binärdatei von [Releases](https://github.com/thereisnotime/sshroute/releases) herunter, installieren Sie mit `go install github.com/thereisnotime/sshroute@latest` oder [bauen Sie aus dem Quellcode](#aus-dem-quellcode-bauen).
**Feedback und Fehlerberichte** – Öffnen Sie ein Issue auf [GitHub Issues](https://github.com/thereisnotime/sshroute/issues). Verwenden Sie die Bug-Report-Vorlage für unerwartetes Verhalten und die Feature-Request-Vorlage für Ideen.
**Mitwirken** – Siehe [CONTRIBUTING.md](https://github.com/thereisnotime/sshroute/blob/main/CONTRIBUTING.md) für die Einrichtung des Projekts, das Ausführen von Tests und das Öffnen eines Pull Requests. Sicherheitslücken sollten privat über [GitHub Security Advisories](https://github.com/thereisnotime/sshroute/security/advisories/new) gemeldet werden.
## Aus dem Quellcode bauen
Erfordert [Go 1.22+](https://go.dev/dl/) und [just](https://just.systems/).
```sh
git clone [email protected]:thereisnotime/sshroute.git
cd sshroute
just build # Ausgabe: bin/sshroute
just build-all # Cross-Kompilierung linux/darwin × amd64/arm64
just test # Tests mit Race-Detector ausführen
just install # go install mit eingefügten Versions-ldflags
```