Doku zu Shellvana

Gilt für Version 1.0.0. Zuletzt aktualisiert: 2026-10-05.

Shellvana ist ein SSH-Client für Smartphones. Er verbindet sich über normales SSH mit deinen eigenen Servern und stellt die Ausgabe als lesbaren Text dar. Diese Seite behandelt die Einrichtung und die tägliche Nutzung.

Was du brauchst

• Ein Smartphone. Ein iPhone mit iOS 15 oder neuer oder ein Android-Smartphone.
• Einen Host mit normalem sshd. Jeder Linux-, BSD- oder macOS-Rechner, den du schon per ssh erreichst, funktioniert. Auf dem Server musst du nichts installieren: keinen Agent, keinen Daemon, kein Plugin.
• Einen Netzwerkweg zu diesem Host. Shellvana verbindet sich direkt von deinem Smartphone mit der Adresse, die du eingibst. Ist der Host nur in deinem Heimnetz erreichbar, verbinde dich zuerst über dein eigenes VPN (WireGuard, Tailscale oder Ähnliches). Shellvana hat kein Relay und keinen Cloud-Dienst dazwischen.

Installation

Lade Shellvana im App Store oder bei Google Play herunter. Die App ist kostenlos. Du musst kein Konto anlegen und dich nirgends anmelden.

Host hinzufügen

• Tippe in der Hostliste auf +, um Add host (Host hinzufügen) zu öffnen.
• Fülle Name (eine beliebige Bezeichnung), Host (eine Adresse oder ein Hostname), Port (meist 22) und User (Benutzer) aus.
• Wähle unter Auth (Anmeldung) entweder Password (Passwort) oder einen deiner SSH-Schlüssel. Hast du noch keine Schlüssel, bietet die Liste nur Password an. Siehe SSH-Schlüssel.
• Lege unter Grid (Raster) die Terminalgröße fest, die Shellvana beim Server anfragt. Console (Konsole) hat 132 Spalten und 40 Zeilen und passt für die normale Arbeit in der Shell. AI agent (KI-Agent) hat 60 Spalten und 40 Zeilen und passt für Terminalassistenten im Vollbild, die eine Seitenleiste zeichnen. Mit Custom (Benutzerdefiniert) stellst du Cols (Spalten) und Rows (Zeilen) selbst ein.
• Tippe auf Save (Speichern) und dann auf den Host, um dich zu verbinden.

Erste Verbindung und Host-Schlüssel

Bei der ersten Verbindung zeigt Shellvana den Host-Schlüssel-Algorithmus und den Fingerabdruck des Servers und fragt Trust this host? (Diesem Host vertrauen?). Vergleiche den Fingerabdruck mit dem auf dem Server, zum Beispiel mit ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub, und tippe dann auf Trust (Vertrauen).

Shellvana merkt sich diesen Schlüssel. Legt der Server später einen anderen vor, siehst du die Warnung HOST KEY CHANGED mit dem bisherigen und dem neuen Fingerabdruck, und die Sitzung öffnet sich nur, wenn du den Hostnamen eintippst, um den neuen Schlüssel zu akzeptieren. Wenn du den Server nicht neu installiert oder seine Host-Schlüssel nicht neu erzeugt hast, akzeptiere ihn nicht.

Schwache oder veraltete Host-Schlüssel-Algorithmen werden abgelehnt. Siehst du „Host key algorithm ... is not allowed“, aktiviere auf dem Server einen modernen Host-Schlüssel wie Ed25519.

Eine Sitzung lesen

• Leseansicht. Jede Sitzung öffnet sich in der Leseansicht. Fließtext und Markdown brechen in Proportionalschrift um, die für ein Smartphone bemessen ist. Tabellen, Diffs, Baumausgaben und alles Spaltenbündige bleiben in Festbreitenschrift mit ihrem exakten Abstand.
• Terminalansicht. Tippe in der oberen Leiste auf das Terminal-Symbol, um das exakte Raster zu sehen, das der Server gesendet hat. Tippe auf das Lese-Symbol, um zurückzukehren. Beide Ansichten zeigen dieselbe Sitzung, du verlierst beim Umschalten also nichts.
• Lesefont und Größe. Tippe in der oberen Leiste auf das Symbol Reading font (Lesefont), um Schriftart und Lesegröße zu ändern.
• Vollbildprogramme. Programme wie vim, htop und tmux laufen ganz normal. Übernimmt eines den Bildschirm, weist Shellvana darauf hin, dass sein Layout das Raster braucht, und bietet eine Schaltfläche Grid an.
• Links. Ein Link in der Ausgabe öffnet sich erst, nachdem du bestätigt hast, wohin er führt, und er öffnet sich in deinem eigenen Browser, außerhalb der App.

Befehle eingeben

• Tippe unten in das Eingabefeld (Type a command, also „Befehl eingeben“) und dann auf die Senden-Schaltfläche.
• Die Tastenreihe über dem Eingabefeld sendet Tasten, die einer Smartphone-Tastatur fehlen, etwa Strg-C, Tab, Esc, die Pfeiltasten, Strg-D und Strg-Z.
• Sieht die Ausgabe wie eine Passwortabfrage aus, bietet Shellvana Secure input (Sichere Eingabe) an. Auf diesem Weg eingegebener Text wird an den Server gesendet, aber nicht gespeichert und landet nicht im Transkript.

SSH-Schlüssel

Öffne in der Hostliste das Menü (drei Punkte) und wähle SSH keys (SSH-Schlüssel).

• Schlüssel importieren. Tippe auf Import, füge einen privaten OpenSSH-Schlüssel ein und gib seine Passphrase ein, falls er eine hat. Der Schlüssel wird verschlüsselt auf dem Gerät gespeichert.
• Hardware-Schlüssel erzeugen (Pro). Generate secure key (Sicheren Schlüssel erzeugen) legt einen Schlüssel in der sicheren Hardware des Smartphones an: der Secure Enclave beim iPhone oder StrongBox bzw. dem hardwaregestützten Keystore unter Android. Die private Hälfte kann das Gerät nicht verlassen. Diese Schlüssel sind ECDSA P-256, was auf dem Server als ecdsa-sha2-nistp256 erscheint.
• Den öffentlichen Teil auf dem Server installieren. Öffne das Menü des Schlüssels, wähle Copy public key (Öffentlichen Schlüssel kopieren) und füge diese Zeile in ~/.ssh/authorized_keys für deinen Benutzer auf dem Server ein. Verbinde dich dafür beim ersten Mal mit einem Passwort.
• Den Schlüssel verwenden. Bearbeite den Host und wähle unter Auth statt Password den Schlüssel.

Arbeit über Verbindungsabbrüche hinweg erhalten

Ein Smartphone verliert Verbindungen: Der Bildschirm sperrt sich, das Netzwerk wechselt, die App geht in den Hintergrund. Verbindet sich Shellvana neu, gibt der Server dir eine frische Shell. Alles, was in der alten Shell lief, ist weg, außer es lief unter einem Terminal-Multiplexer.

Starte alles, was lange läuft, auf dem Server in tmux oder screen. Führe zum Beispiel nach dem Verbinden tmux new -A -s main aus. Bricht die Verbindung ab, verbinde dich erneut und führe denselben Befehl aus, um dort weiterzumachen, wo du aufgehört hast.

Sicherheitseinstellungen pro Host

• Entsperrung zum Verbinden verlangen. Standardmäßig aus. Schaltest du sie für einen Host ein, fragt Shellvana nach Fingerabdruck, Gesicht oder Bildschirmsperre, bevor es dort eine Sitzung öffnet.
• Screenshots blockieren. Standardmäßig an. Screenshots und die Vorschau einer Sitzung im App-Wechsler sind gesperrt. Du kannst das pro Host ausschalten.
• Connect (incognito) (Pro). Im Menü eines Hosts öffnet dies eine Sitzung, die gar kein Transkript schreibt.

Verlauf und deine Daten

• Sitzungstranskripte werden nur auf dem Smartphone gespeichert, verschlüsselt mit SQLCipher. Transkripte, die älter als 30 Tage sind, löschen sich selbst.
• Um die gespeicherten Transkripte eines Hosts zu entfernen, öffne das Menü dieses Hosts und wähle Clear this host's history (Verlauf dieses Hosts löschen). Um alles zu entfernen, öffne das Hauptmenü und wähle Clear all history (Gesamten Verlauf löschen).
• Beim Löschen eines Hosts verschwindet er aus der Liste, aber seine gespeicherten Transkripte und sein vertrauter Host-Schlüssel bleiben erhalten. Lösche zuerst den Verlauf, wenn auch diese verschwinden sollen.
• Shellvana hat kein Konto, keine Analyse und keine Absturzberichte. Die Datenschutzerklärung listet jede Netzwerkverbindung auf, die die App aufbaut.

Gratis und Pro

• Gratis. Eine Live-Sitzung, Anmeldung mit Passwort und Schlüssel, Host-Profile und die komplette lesbare Darstellung. Die Lesbarkeit ist nicht der bezahlte Teil.
• Pro. Ein einziger Einmalkauf, kein Abo. Er bringt bis zu vier gleichzeitige Sitzungen, Anmeldung mit hardwaregestütztem Schlüssel, alle Lesefonts und Inkognito-Sitzungen.
• Kaufen oder wiederherstellen. Öffne in der Hostliste das Menü und wähle Shellvana Pro. Tippe auf einem neuen Smartphone in diesem Dialog auf Restore purchase (Kauf wiederherstellen).

Fehlerbehebung

• Die Verbindung läuft in ein Timeout. Prüfe, ob das Smartphone den Host überhaupt erreicht. Liegt der Host in einem privaten Netz, schalte zuerst dein VPN ein und prüfe, ob der Port zu dem passt, auf dem sshd lauscht.
• Der Schlüssel wird abgelehnt. Prüfe, ob der öffentliche Schlüssel aus Copy public key in einer einzigen Zeile in ~/.ssh/authorized_keys steht, und zwar für denselben Benutzer, den das Host-Profil nennt, und ob der Server diesen Schlüsseltyp erlaubt.
• Das Layout eines Programms sieht in der Leseansicht falsch aus. Wechsle in die Terminalansicht. Vollbildprogramme sind für ein Raster gezeichnet, und das Raster ist immer die exakte Ausgabe.
• Ein Vollbild-Assistent ist abgeschnitten. Bearbeite den Host, stelle Grid auf AI agent um und verbinde dich neu.
• „No previous purchase found.“ Stelle sicher, dass das Smartphone mit demselben App-Store- oder Google-Play-Konto angemeldet ist, mit dem du Pro gekauft hast, und versuche Restore purchase dann noch einmal.

Hilfe bekommen

Schreib an [email protected] und nenne dein Gerätemodell und deine iOS- oder Android-Version, oder sieh auf der Support-Seite nach.