v0.3.0 Open Source · MIT · selbst gehostet
Keyway ist dein Web-Client für SSH, Bildschirm (VNC) und Dateien – 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
Funktionen
01 — Terminal
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 — Bildschirm (VNC)
Sieh und bediene den Bildschirm von Raspberry Pi, HMI-Panel oder PC – wie mit RealVNC Viewer, nur im Browser. Standardmässig über SSH getunnelt: verschlüsselt und ohne offenen VNC-Port im Netz.
03 — Befehlshilfe
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.
0:42 · Keyway im Einsatz · ohne Ton
Film und Szenenbilder mit KI erstellt (Higgsfield); 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.
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
Nichts. Keyway ist Open Source unter der MIT-Lizenz. Du betreibst es auf deiner eigenen Hardware, ohne Cloud-Dienst und ohne Konto bei Dritten.
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.
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 RealVNC mit RSA-AES reicht Keyway an den Browser durch.
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.