v0.3.0 Open Source · MIT · selbst gehostet
Keyway ist dein Web-Client für SSH, Bildschirm (VNC) und Dateien (SFTP) – mit verschlüsseltem Tresor und einer Befehlshilfe, die offline funktioniert. Am Rechner und auf dem Telefon. Ein Container, keine Cloud, kein Konto.
$ curl -fsSLO https://raw.githubusercontent.com/uiff/ssh-app/main/compose.yml $ docker compose up -d ✓ Container ssh-app Started › https://<adresse>:8443
linux/amd64 · linux/arm64 · Deutsch & Englisch
Ein Werkzeug für alles mit SSH oder VNC
Was ist Keyway?
Keyway ist eine kostenlose, quelloffene Webanwendung, die SSH-Terminal, Fernbildschirm (VNC), Dateiverwaltung (SFTP), einen verschlüsselten Tresor für Zugangsdaten und eine Offline-Befehlshilfe in einem Browser-Tab vereint. Sie läuft als ein kleiner Docker-Container auf deiner eigenen Hardware und funktioniert am Rechner, auf dem Tablet und auf dem Telefon. Eine komplette Terminal-Suite – direkt im Browser.
Funktionen
01 — SSH-Terminal im Browser
Tabs, 256 Farben, top, htop und vi. Sitzungen laufen bis zu 12 Stunden auf dem Server weiter und hängen sich nach einem Neuladen mit dem bisherigen Bildschirm wieder an.
rm -rf, dd oder reboot nach
02 — VNC im Browser
Sieh und bediene den Bildschirm von Raspberry Pi, HMI-Panel oder PC – direkt im Browser. Standardmässig über SSH getunnelt: verschlüsselt und ohne offenen VNC-Port im Netz.
03 — Befehlshilfe offline
Rund 7000 Befehle aus den tldr-pages, offline und auf Deutsch, wo es eine Übersetzung gibt. Keyway erklärt die Schalter in deiner aktuellen Zeile und füllt Beispiele mit Platzhaltern.
StrgUmschaltK durchsucht Hosts, Snippets und Befehle
Hochladen per Ziehen und Ablegen, Herunterladen, Umbenennen. Die Dateileiste folgt deinem cd im Terminal, sicheres Ersetzen schützt Rechte und Bind-Mounts.
Passwörter und Schlüssel mit AES-256-GCM, der Schlüssel per Argon2id aus deinem Passwort abgeleitet. ed25519-Schlüssel erzeugen und mit einem Klick auf dem Host hinterlegen.
SPS, HMI, Gateway, Wallbox oder Wechselrichter – jedes Gerät mit eigenem Symbol, in Ordnern, mit Tags, Farben und Notizen. Das Adressfeld versteht auch ssh -p 2222 user@host.
Mit dem Tag kritisch fragt Keyway nach, bevor ein gefährlicher Befehl aus Snippet, Befehlshilfe oder «An alle senden» ankommt.
Hosts, Ordner, Zugänge, Snippets und Host-Schlüssel verschlüsselt in einer Datei – auf einem neuen System mit dem Sicherheitsschlüssel wiederherstellen.
Die Oberfläche folgt der Browsersprache, auch die Meldungen vom Server. Akzentfarbe nach Wahl: Violett, Blau, Türkis, Grün, Bernstein oder Rosa.
Im Einsatz
Ein Techniker, drei Geräte, ein Tab: Terminal auf dem Raspberry Pi, Bildschirm des HMI-Panels, Befehlshilfe am Webserver.
Server, SPS und HMI-Panels, in einem Browser-Tab. Das ist Keyway. Terminal, Dateien und Befehlshilfe nebeneinander, direkt am Schaltschrank. Die Befehlshilfe erklärt jeden Schalter – rund siebentausend Befehle, komplett offline. Das HMI-Panel? Keyway tunnelt VNC durch SSH, ohne offenen Port. Nur ansehen, Zwischenablage, Sondertasten: das Panel im Tab, neben deinen Terminals. Unterwegs? Dasselbe Panel auf dem Telefon, mit Gesten und Tastenleiste. Hosts, Terminal und Bildschirm, auf jedem Gerät. Ein Container. Keine Cloud. Kein Konto. Keyway – Open Source und kostenlos.
Film und Szenenbilder mit KI erstellt (Higgsfield), Sprecher von ElevenLabs; die Oberflächen sind echte Bildschirmfotos von Keyway.
Auf dem Telefon
Tastenleiste mit Esc, Tab, Strg, Alt und Pfeilen. Gesten für den Fernbildschirm: Tippen klickt, langes Drücken klickt rechts, zwei Finger scrollen. Jede Trefferfläche ist mindestens 44 px gross – und auf dem Startbildschirm läuft Keyway wie eine eigene App.
Einsatzszenarien
Shell des SPS-Gateways öffnen, Logs prüfen, eine Konfigurationsdatei kopieren und den HMI-Bildschirm von Linie 2 ansehen – in einem Tab am Schaltschrank, ohne Software auf Kundengeräten.
Vor Ort oder im Pikett sind dieselben Hosts und Bildschirme auf dem Telefon, mit Tastenleiste und Gesten für den Fernbildschirm.
Raspberry Pis, Gateways und Edge-Geräte in Ordnern mit Gerätetyp und Tags. «An alle senden» führt einen Befehl auf vielen Geräten aus.
Ein Container auf NAS oder Mini-PC gibt Haushalt oder Büro einen zentralen, verschlüsselten Ort für SSH- und VNC-Zugriffe.
Sicherheit
AES-256-GCM · Argon2id
Passwörter und private Schlüssel liegen nur verschlüsselt in der Datenbank. Der Schlüssel lebt nur im Speicher und verschwindet, wenn der Tresor sperrt.
5 Versuche · 15 Minuten
Nach fünf Fehlversuchen von einer Adresse ist die Anmeldung 15 Minuten gesperrt. HttpOnly- und SameSite-Cookies, CSRF-Schutz und eine strenge Content Security Policy.
30 Minuten
Ohne Bedienung meldet Keyway dich ab und sperrt den Tresor. Laufende Terminal-Sitzungen laufen weiter und sind nach der Anmeldung wieder da.
SSH-Tunnel
Der Bildschirm reist im verschlüsselten SSH-Kanal. Das VNC-Passwort erreicht den Browser nie, und Keyway verbindet sich nur mit dem gespeicherten Ziel.
Nutzer 65532
Image ohne Shell, unprivilegierter Nutzer, schreibgeschütztes Dateisystem und keine Linux-Capabilities in der Compose-Datei.
SBOM · Provenance
Jedes Image baut GitHub Actions aus dem Repository, testet es vor der Veröffentlichung und versieht es mit Provenance-Nachweis und SBOM.
Keyway ist für dein eigenes Netz gedacht. Stell es nicht ungeschützt ins Internet – für den Zugriff von unterwegs eignen sich ein VPN oder ein Reverse-Proxy mit eigenem Zertifikat.
Installation
Compose-Datei laden und starten. Das Image gibt es für amd64 und arm64 – vom Server bis zum Raspberry Pi.
https://<adresse>:8443 öffnen und Benutzer und Passwort wählen. Bis dahin kann jeder, der die Adresse erreicht, das Konto anlegen. Den Sicherheitsschlüssel zeigt Keyway nur einmal – sicher aufbewahren.
Gerätetyp wählen, Adresse und Benutzer eintragen – fertig.
mkdir keyway && cd keyway
curl -fsSLO https://raw.githubusercontent.com/uiff/ssh-app/main/compose.yml
docker compose up -ddocker run -d --name ssh-app -p 8443:8443 \
-v ssh-app-daten:/data --restart unless-stopped \
--stop-timeout 30 iotuelich/keyway:latestImages: iotuelich/keyway auf Docker Hub · gleich auch als ghcr.io/uiff/keyway · Betrieb hinter Reverse-Proxy
Whitepaper
Zehn Seiten zu Architektur, Sicherheitsmodell und Betrieb – mit Empfehlungen, wie Keyway in Industrienetzen mit Zonen und Conduits platziert wird.
Keyway ist ein kostenloser, quelloffener, selbst gehosteter Web-Client für SSH, VNC und SFTP. Er vereint SSH-Terminal, Fernbildschirm, Dateiverwaltung, einen verschlüsselten Tresor für Zugangsdaten und eine Offline-Befehlshilfe in einem Browser-Tab und läuft als ein Docker-Container auf deiner eigenen Hardware.
Nichts. Keyway ist Open Source unter der MIT-Lizenz. Du betreibst es auf deiner eigenen Hardware, ohne Cloud-Dienst und ohne Konto bei Dritten.
Für den Alltag ja: Keyway deckt SSH-Terminal, Dateien per SFTP und Fernbildschirm per VNC ab – im Browser statt in getrennten Desktop-Programmen, auf jedem Gerät inklusive Telefon und auf dem eigenen Server. RDP und X11-Weiterleitung gehören nicht zu Keyway.
Nein. Keyway unterstützt SSH (Terminal und SFTP) und VNC. Für Windows-Remotedesktop (RDP) eignet sich ein eigenes RDP-Gateway.
Nein. Keyway läuft in deinem Netz, auch die Befehlshilfe mit rund 7000 Befehlen funktioniert offline.
Überall, wo Docker läuft: Fertige Images gibt es für linux/amd64 und linux/arm64, also auch für einen Raspberry Pi oder einen Industrie-PC.
Zugangsdaten liegen mit AES-256-GCM verschlüsselt. Der Schlüssel wird per Argon2id aus deinem Anmeldepasswort abgeleitet, lebt nur im Speicher und verschwindet, wenn der Tresor sperrt – automatisch nach 30 Minuten ohne Bedienung.
Nicht ungeschützt. Für den Zugriff von unterwegs eignet sich ein VPN oder ein Reverse-Proxy wie Caddy, nginx oder Traefik mit eigenem Zertifikat. Die Anleitung steht im README.
Keyway meldet sich selbst an (RFB 3.3, 3.7 und 3.8 mit None und VNC-Authentication). Andere Verfahren wie RSA-AES reicht Keyway an den Browser durch. Standardmässig läuft VNC durch SSH, im Netz muss also kein VNC-Port offen sein.
Ja. Keyway hat eine Tastenleiste mit Esc, Tab, Strg, Alt und Pfeilen, Gesten für den Fernbildschirm und Trefferflächen von mindestens 44 px. Auf dem Startbildschirm abgelegt, läuft es wie eine App.
Backup in den Einstellungen herunterladen und beim ersten Start auf dem neuen System mit dem Sicherheitsschlüssel wiederherstellen.
Ja, SSH-App. Repository, Programm und Container heissen weiterhin ssh-app, bestehende Installationen und Backups laufen unverändert weiter.
Kostenlos, quelloffen unter MIT-Lizenz, auf deiner eigenen Hardware.