VNTerm-Dokumentation

Eine kurze Anleitung von der Installation bis zur Synchronisierung der Hosts zwischen deinen Geräten.

App installieren

Lade das Installationsprogramm für dein Betriebssystem auf der Seite Download herunter.

macOS (11+, Apple Silicon & Intel)

Öffne die Datei VNTerm_<Version>_aarch64.dmg und zieh VNTerm in den Ordner Applications.
Falls macOS beim ersten Öffnen meldet, dass der Entwickler nicht überprüft werden kann: Rechtsklick auf die App → Open.

Ubuntu / Debian (22.04+, x86_64)

sudo apt install ./vnterm_*_amd64.deb

Oder nutze die AppImage-Version ohne Installation:

chmod +x VNTerm_*_amd64.AppImage && ./VNTerm_*_amd64.AppImage

Windows 10/11 (x64)

Führe VNTerm_*_x64-setup.exe aus (oder VNTerm_*_x64_en-US.msi für die Verteilung per GPO/Intune). Falls SmartScreen eine Warnung zeigt, wähle More info → Run anyway.

Konto erstellen

Das Konto dient zur Synchronisierung des Vaults zwischen deinen Geräten. Du kannst dich direkt in der App oder auf der Registrierungsseite registrieren.

Das Master-Passwort (mindestens 8 Zeichen) verschlüsselt deinen gesamten Vault auf deinem Gerät. Es wird niemals an den Server gesendet, und wir können es nicht wiederherstellen.
Nach der Registrierung zeigt die App den Wiederherstellungsschlüssel genau einmal an – speichere ihn (siehe Wiederherstellungsschlüssel).
Melde dich auf einem anderen Gerät mit demselben Konto an, um alle Hosts, Schlüssel und Snippets zu erhalten. Die Geräteliste und die Widerrufen-Schaltfläche findest du auf der Seite Konto.

Host hinzufügen

Klicke im Bereich Hosts auf New host.
Gib Address (IP oder Hostname) und Label ein und wähle bei Bedarf Parent Group und Tags.
Lege den SSH-Port (Standard 22), Username und Password fest oder weise einen Schlüssel / eine Identity aus der Keychain zu.
Doppelklicke auf eine Host-Karte, um dich zu verbinden. Bei der ersten Verbindung zeigt die App den Fingerprint des Servers zur Bestätigung an; er wird unter Known Hosts gespeichert, und du wirst gewarnt, falls er sich ändert.

Schon eine Konfiguration vorhanden? Wähle New host → Import from ~/.ssh/config für einen Massenimport. Die erweiterten Host-Einstellungen bieten Agent Forwarding, Start-Snippets, Host Chaining (Jump Host), SOCKS5-/HTTP-Proxy und ein eigenes Terminal-Theme.

Keychain & Identity

Schlüssel erzeugen: Keychain → Generate key, ed25519 (empfohlen), ECDSA oder RSA wählen und optional eine Passphrase festlegen.
Schlüssel importieren: eine vorhandene Private-Key-Datei einfügen oder auswählen (OpenSSH / PEM).
Füge den Public Key zu ~/.ssh/authorized_keys auf dem Server hinzu und weise den Schlüssel dann im Bereich Credentials dem Host zu.
Identity bündelt Benutzername + Passwort/Schlüssel zu einem Satz, den du für viele Hosts wiederverwenden kannst: Passwort einmal ändern, und alle Hosts mit dieser Identity werden aktualisiert.

Quick connect: SSH, Mosh, Telnet

Gib eine Adresse in das Suchfeld auf der Hosts-Seite ein und drücke Enter oder Connect. Syntax:

[ssh|mosh|telnet] [user@]host[:port]
[email protected]
mosh [email protected]
telnet 10.0.0.5:23
[2001:db8::1]:2222

Ohne Protokollangabe fragt die App, ob du SSH, Mosh oder Telnet verwenden möchtest, und fragt bei Bedarf nach den Anmeldedaten.

SSH – Standardport 22, unterstützt Passwort, Schlüssel und Agent.
Mosh – startet den mosh-Client des Systems in einem Tab und hält die Sitzung bei instabilem Netz oder WLAN-Wechsel aufrecht. Erfordert mosh auf deinem Rechner und mosh-server auf dem Server.
Telnet – Standardport 23, für ältere Netzwerkgeräte. Telnet ist unverschlüsselt und sollte nur in vertrauenswürdigen Netzen genutzt werden.

SFTP

Öffne den Tab SFTP: links ist dein Rechner, rechts der gespeicherte Host. Du kannst Verzeichnisse durchsuchen, per Rechtsklickmenü hoch- und herunterladen, Ordner anlegen, umbenennen, löschen und Berechtigungen ändern (chmod). Halte beim Klicken ⌘/Ctrl gedrückt, um mehrere Dateien auszuwählen.

Port forwarding

Der Bereich Port Forwarding speichert Regeln im Vault; jede Regel lässt sich unabhängig ein- und ausschalten.

Typ	Entspricht	Einsatzzweck
Local (L)	`ssh -L 5432:db.internal:5432 host`	Greife über einen Port auf deinem Rechner auf Dienste hinter dem Server zu, z. B. eine interne Datenbank.
Remote (R)	`ssh -R 8080:localhost:3000 host`	Lass den Server auf einen Dienst zugreifen, der auf deinem Rechner läuft.
Dynamic (D)	`ssh -D 1080 host`	Erstellt einen lokalen SOCKS5-Proxy; der gesamte Traffic läuft über den Server.

Datenbanken

Der Bereich Databases verbindet sich mit MySQL, MariaDB, PostgreSQL und SQLite. Verbindungsdaten (einschließlich Passwörtern) liegen in Ihrem Vault und sind wie Hosts Ende-zu-Ende-verschlüsselt. Wählen Sie unter Über einen SSH-Host verbinden einen Host, um durch einen SSH-Tunnel zu gehen – ohne Port-Forwarding-Regel. Verfügbar am Desktop und auf dem Smartphone.

Baum links – Ordner → Verbindung → Datenbank → Tabellen, Views, Funktionen, Events, Abfragen. Jeder Eintrag öffnet sich in einem Tab; Rechtsklick (auf dem Smartphone langes Drücken) öffnet das Menü.
Daten – Zelle anklicken zum Bearbeiten, Zeiger wegbewegen zum Speichern; Zeile über ihre Nummer auswählen, dann fügen ⌘/Ctrl+C, ⌘/Ctrl+V eine neue Zeile hinzu. Filtern, Sortieren, Export als CSV / JSON / SQL und CSV-Import.
Tabellen-Designer – Felder, Indizes, Fremdschlüssel, Trigger, Prüfungen und Optionen; SQL-Vorschau vor dem Speichern.
Nur Lesen – Abfragen starten schreibgeschützt; schalten Sie die Option aus, um zu schreiben.

Serial

Hosts-Seite → Serial: Port (z. B. /dev/ttyUSB0, COM3) und Baudrate (300 – 921600, Standard 9600) wählen. Unter Advanced lassen sich Data Bits, Parität und Stop Bits einstellen. Unter Linux muss das Benutzerkonto zur Gruppe dialout gehören, um serielle Ports zu öffnen.

Remote Desktop

Steuern Sie Windows-Rechner direkt in einem Tab der Desktop-App. Unter Windows muss nichts installiert oder eingerichtet werden – Remote Desktop muss nur eingeschaltet (Settings → System → Remote Desktop) und Port 3389 erreichbar sein.

New host → Remote Desktop wählen, Adresse, Benutzername (bei Bedarf mit Domäne, z. B. CORP\admin) und Passwort eingeben.
Doppelklick auf den Host öffnet den Windows-Bildschirm. Die Auflösung folgt der Tab-Größe.
Die Tab-Leiste: Qualität (automatisch nach Netzgeschwindigkeit oder fest), GFX (RDP-8+-Grafik, standardmäßig an), eine Strg + Alt + Entf-Schaltfläche, geteilter Bildschirm, schwebendes Fenster und Freigabe.

Kopieren / Einfügen von Text funktioniert in beide Richtungen zwischen Ihrem Computer und Windows.
Tastenkürzel gehen an Windows. Auf dem Mac werden ⌘ + C / V / X / Z / A / F / S zu Strg, andere ⌘-Kombinationen zur Windows-Taste; ⌘ W schließt weiterhin den Tab.
Langsames Netz: Der Automatikmodus senkt die Bildqualität, damit alles flüssig bleibt, und hebt sie wieder, sobald das Netz besser wird.

Tabs & Tab-Gruppen

Jede Sitzung ist ein Tab; mehrere Sitzungen zum selben Host werden nummeriert, z. B. Onik (1), Onik (2).
Zieh einen Tab auf einen anderen, um sie zu einer Gruppe zusammenzufassen. Gruppen lassen sich wieder auflösen oder komplett auf einmal schließen.
Die Schaltfläche + in der Tab-Leiste öffnet Quick Connect oder ein lokales Terminal.

Schwebendes Fenster

Rechtsklick auf einen Tab → Float on top verschiebt ein Terminal (oder einen Remote-Desktop-Bildschirm) in ein kleines Fenster, das immer im Vordergrund bleibt – praktisch, um Logs oder einen Build zu beobachten. Beim Schließen kehrt die Sitzung in ihren Tab zurück.

Multiplayer

Rechtsklick auf einen Tab → Multiplayer erstellt einen Freigabelink. Empfänger öffnen ihn im Browser, ohne Konto. Die Inhalte sind Ende-zu-Ende-verschlüsselt, der Schlüssel steht hinter dem # des Links, der Server kann nichts lesen. Sie schalten Tippen (oder die Remote-Desktop-Steuerung) für Zuschauer ein und aus und können die Freigabe jederzeit beenden.

Themes & Darstellung

Wähle unter Settings das Standard-Terminal-Theme, die Schriftgröße und die Sprache der Oberfläche. Jeder Host kann ein eigenes Theme haben (im Host-Bearbeitungsbereich); Hosts ohne eigenes Theme verwenden das Standard-Theme des Kontos. Diese Einstellungen werden mit dem Vault synchronisiert.

Tastenkürzel

Aktion	macOS	Linux / Windows
Lokales Terminal öffnen	`⌘` `⇧` `T`	`Ctrl` `Shift` `T`
Im Terminal kopieren	`⌘` `C`	`Ctrl` `Shift` `C`
In Terminal einfügen	`⌘` `V`	`Ctrl` `Shift` `V`
Quick Connect aus dem Suchfeld	`Enter`
Panel / Dialog schließen, Suche abbrechen	`Esc`
Mehrere Dateien in SFTP auswählen	`⌘` + click	`Ctrl` + click

Synchronisierung & Ende-zu-Ende-Verschlüsselung

VNTerm verschlüsselt Ihren Tresor auf Ihrem Gerät: Der Server speichert nur verschlüsselte Daten und erhält nie Ihr Master-Passwort. Solange die Schnellanmeldung mit Google / Apple / Telegram aktiv ist (Standard), bewahrt der Server zusätzlich eine verschlüsselte Kopie Ihres Tresorschlüssels auf, um Ihren Tresor auf einem neuen Gerät zu öffnen — deaktivieren in der App: Einstellungen → Konto.

Master-Passwort → PBKDF2-SHA256 (600 000 Runden) → master key. Daraus werden der auth key (wird zur Anmeldung an den Server gesendet und dort als Argon2id gespeichert) und der enc key (bleibt nur auf deinem Gerät) abgeleitet.
Jeder Host, Schlüssel, jedes Snippet… wird vor der Synchronisierung mit einem zufälligen vault key per AES-256-GCM verschlüsselt. Der Vault Key ist mit dem Enc Key umhüllt.
Jede API-Anfrage wird innerhalb von HTTPS zusätzlich verschlüsselt (X25519 + AES-256-GCM, gebunden an Endpoint und Zeitpunkt, mit Replay-Schutz).
Revisionsbasierte Synchronisierung: Wird derselbe Eintrag gleichzeitig auf zwei Geräten bearbeitet, wird ein Konflikt erkannt, statt still zu überschreiben.

Wiederherstellungsschlüssel

Der Wiederherstellungsschlüssel ist die einzige Möglichkeit, deine Vault-Daten zu behalten, wenn du dein Master-Passwort vergisst.

Bewahre den Schlüssel (im Format XXXX-XXXX-…) an einem sicheren Ort auf: in einem Passwort-Manager oder ausgedruckt.
Passwort vergessen: Öffne Passwort vergessen, gib den 6-stelligen Code aus der E-Mail ein, setze ein neues Passwort und füge den Wiederherstellungsschlüssel ein – dein Vault bleibt erhalten.
Ohne Wiederherstellungsschlüssel: Der alte Vault wird gelöscht, du erhältst einen leeren Vault und einen neuen Wiederherstellungsschlüssel. Nach dem Zurücksetzen des Passworts werden alle Geräte abgemeldet.

Team vault

Schaltfläche Vaults ▾ in der oberen Leiste → Add vault: Namen vergeben und Mitglieder per E-Mail einladen.
Host-Menü → Move to vault legt den Host (mit seinen Schlüsseln / Identities) in einen Team-Tresor.
Im Menü Vaults ▾ einen Tresor anklicken, um ihn aus-/einzublenden, oder only, um nur ihn zu sehen. Das gilt nur für das aktuelle Gerät.
Manage vaults (Settings → Invite People) zeigt Mitglieder und offene Einladungen; wer entfernt wird, verliert sofort den Zugriff.

Neue Mitglieder öffnen die App einmal, um ihr Schlüsselpaar zu erzeugen; ein Mitglied mit Schlüssel versiegelt dann automatisch den Tresorschlüssel für sie.

Pläne & Abrechnung

Pläne ansehen und kaufen auf der Seite Preise. Bezahlen per Karte (Stripe) oder PayPal, monatlich oder jährlich; Rabattcodes möglich. Pläne sind im Voraus bezahlt und buchen nie automatisch ab – vor Ablauf kommt eine Erinnerung, verlängert wird auf der Seite Konto.

Funktionen werden in der App wenige Sekunden nach der Zahlung freigeschaltet (oder wenn Sie zur App zurückkehren).
Team-/Business-Pläne werden pro Platz berechnet; Mitglieder Ihres Team-Tresors nutzen die Funktionen des Plans.
Wenn ein Plan endet, geht nichts verloren: Ihr Tresor lädt weiterhin auf alle Geräte, nur die Funktionen des Plans werden wieder gesperrt.

Noch Fragen? Fehler melden oder Funktion vorschlagen.