Gemeinsame Remote-Sitzungen

zshell-server hält Shell und Prozesse auf einem macOS- oder Linux-Host am Leben. Beide Terminal-Backends von Zshell können sich verbinden. Beim Schließen des Clients oder bei einem Netzwerkausfall laufen Aufgaben weiter. Eine erneute Verbindung stellt Bildschirm, Verlauf, Cursor und Terminalmodi wieder her.

InstallationLink kopieren

Wählen Sie in Remote-Hosts… Server installieren / aktualisieren über SSH. Für einen Mac gleicher Architektur wird das mitgelieferte Programm verwendet. Für Linux wählen Sie das passende zshell-server für Plattform und Architektur. Upload und Kompatibilität werden vor dem Ersetzen geprüft. Ein aktiver Daemon behält seine Version bis zum Neustart, der seine Terminalaufgaben beendet. Ein Build direkt auf dem Host ist ebenfalls möglich:

cargo build --locked --release --manifest-path remote/Cargo.toml
install -d "$HOME/.local/bin"
install -m 755 remote/target/release/zshell-server "$HOME/.local/bin/zshell-server"

Clients erhalten Zugriff auf Shell und Dateien des ausführenden Kontos. macOS und Linux werden unterstützt.

SSHLink kopieren

Prüfen Sie zunächst Hostschlüssel und Schlüssel- oder Agent-Authentifizierung:

ssh devbox true

Öffnen Sie die Remote-Hosts im Netzwerkmenü der Seitenleiste. Tragen Sie Name, ssh://me@devbox:22 oder SSH-Alias und ~/.local/bin/zshell-server ein. Das Verbinden lädt vorhandene Projekte und Sitzungen. Ein Remote-Verzeichnis wie ~/repo und das Öffnen des Remote-Projekts erstellen eine neue Shell. Leerzeichen in Pfaden werden unterstützt; neue Tabs und geteilte Bereiche laufen ebenfalls auf dem Host.

SSH startet den Daemon automatisch und nutzt Ihre OpenSSH-Konfiguration, Schlüssel, den Agent und vertraute Hostschlüssel. Unbekannte Schlüssel und Anmeldefehler erscheinen als Fehler. Dateien und Git verwenden SSH zum selben Host, auch bei einer Tailscale-Terminalverbindung. Remote-Pfade greifen niemals auf Mac-Dateien zu. ZSHELL_SSH_CONFIG_FILE kann eine separate lesbare OpenSSH-Datei als absoluten Pfad auswählen.

TailscaleLink kopieren

Melden Sie beide Geräte bei Tailscale an und starten Sie den privaten Listener vor dem Erstellen von Sitzungen:

zshell-server serve --listen tailscale://:7373

Fügen Sie tailscale://devbox:7373 hinzu. MagicDNS und Tailscale-IPv4/IPv6 funktionieren, öffentliche Adressen werden abgelehnt. Standardmäßig sind nur unmarkierte Geräte des Hostbesitzers erlaubt. --allow-user erlaubt einen weiteren exakten Anmeldenamen; markierte Clients bleiben gesperrt. Auf dem Server selbst verwenden Sie SSH. Tailnet-ACLs gelten weiterhin. Berechtigte Clients können das Unix-Konto des Dienstes bedienen.

Melden Sie Tailscale an und wählen Sie Diesen Mac teilen in Remote-Hosts…. Port und erlaubte exakte Anmeldenamen sind einstellbar. Teilen startet nur auf Anforderung; Teilen beenden oder Beenden von Zshell beendet die geteilten Sitzungen.

Teilen und beendenLink kopieren

Alle Clients erhalten dieselbe Ausgabe. Durch Fokussieren oder Übernehmen der Terminalsteuerung erhält ein Client Eingabe und Größensteuerung. Trennt er sich, übernimmt der älteste verbleibende Client. Das Info-Panel zeigt Zustand, Clientzahl und Steuerung und bietet Trennen und Wiederverbinden. Netzfehler werden automatisch erneut versucht; Offline-Eingaben werden verworfen. Gespeicherte Layouts verbinden dieselbe Remote-UUID erneut.

Das Schließen von Bereich, Projekt oder Fenster sowie beide Optionen zum Beenden der App trennen nur die Verbindung. Das Beenden einer Remote-Sitzung verlangt Bestätigung und stoppt Shell und Aufgaben für alle Clients. Auf dem Host geht das mit zshell-server terminate --project ~/repo --session UUID.

Dateien und BildschirmfotosLink kopieren

Kopieren Sie reguläre Dateien oder Bildschirmfotos und fügen Sie sie im Remote-Bereich ein. Nach dem Upload in ein privates Hostverzeichnis werden für dessen Shell zitierte Pfade eingefügt. Maximal 32 Dateien, je 32 MiB und insgesamt 64 MiB; Ordner und symbolische Links werden abgelehnt. Geteilte Uploads bleiben sieben Tage verfügbar. Normale Unix-SSH-Bereiche unterstützen dies ebenfalls.

Remote-Agent-GesprächeLink kopieren

Aktivität, Fortschritt, Freigabeanfragen und Abschluss von Remote-Agents nutzen vorhandene Statusanzeigen und Mitteilungen. Agent-Gesprächsverlauf enthält Hostgespräche von Claude Code, Codex, OpenCode und Pi. Fortsetzen verbindet ein lebendes Gespräch oder startet genau dessen Sitzung auf dem ursprünglichen Host und Verzeichnis. Gesprächsverlauf überlebt Daemon-Neustarts; Terminalaufgaben und Scrollverlauf nicht. Anbieterprogramm und ursprüngliche Konfiguration oder Sitzungsdatei müssen verfügbar sein.

GrenzenLink kopieren

Die Sitzung bleibt nur während der Lebenszeit des Daemons bestehen, nicht über Host-Neustarts, Abstürze oder Daemon-Neustarts hinweg. Fehlende Sitzungen werden gemeldet und nicht still ersetzt. Grenzen: 128 Sitzungen, 16 MiB Terminal-Snapshot, 1 MiB Live-Warteschlange pro Client. Langsame Clients blockieren die anderen nicht. Der Verlauf bleibt im Host-RAM. Dienstkonfiguration und CLI stehen in der Serverreferenz.