Bring dein Terminal auf ein anderes Gerät
Termbridge startet einen lokalen Server, tunnelt ihn über Cloudflare und überträgt deine tmux-Sitzung in jeden Browser.
npx termbridgeNeueste Version 0.3.13 MIT Node 20+, tmux, cloudflared
# Create a tmux session and start the agent
tmux new-session -d -s claude "claude"
# Then attach Termbridge to it
termbridge --session claudeIn der Praxis
Starte das Programm auf deinem Computer und öffne das Terminal dann auf einem anderen Gerät.
Vom Laptop aufs Smartphone
npx termbridge startet einen lokalen Server, eine tmux-Sitzung und einen Cloudflare-Tunnel. Anschließend gibt es einen QR-Code mit einem einmal verwendbaren Anmeldelink aus.
Beim Scannen des Codes wird das Token eingelöst und eine Cookie-Sitzung erstellt. Füge --proxy 5173 hinzu, um deinen Entwicklungsserver neben dem Terminal in einer Vorschau anzuzeigen.
npx termbridge# Start your Vite app first
cd my-app && npm run dev # runs on port 5173
# Then start Termbridge with proxy
termbridge --proxy 5173Für Mobilgeräte geeignet
Scanne den QR-Code und öffne dein Terminal im Browser auf deinem Smartphone.
Echtes Terminal
tmux + node-pty leiten ein echtes PTY mit Farben und TUIs in xterm.js weiter.
Cloudflare-Tunnel
Quick Tunnel macht deinen lokalen Server ohne Portweiterleitung öffentlich erreichbar.
Anmeldung per Token
Der QR-Link enthält ein einmal verwendbares Token, das 90 Sekunden gültig ist. Beim Einlösen wird ein HttpOnly- und Secure-Sitzungs-Cookie gesetzt. Zusätzlich gelten CSRF-Prüfungen und ein Limit von 5 Einlösungen pro Minute. Sitzungen laufen nicht ab.
Mehrere Sitzungen
Ein Server kann mehrere tmux-Sitzungen mit Wechsel direkt in der App hosten.
Ein Befehl
npx termbridge startet den Server, den Cloudflare-Tunnel und den QR-Code. Erfordert Node 20+, tmux und cloudflared unter macOS oder Linux; Windows wird nicht unterstützt.
CLI zuerst
Als terminalorientiertes Werkzeug mit TTY-Status und QR-Ausgabe entwickelt.
QR-Übergabe
Bei jedem Start wird ein QR-Code mit einmal verwendbarem Anmeldelink ausgegeben. Scanne ihn mit dem Gerät, das du verwenden möchtest.
Dev-Server-Vorschau
Leite deine lokale Vite-App über einen Proxy weiter und zeige sie neben dem Terminal in der Vorschau an.
HMR-Durchleitung
Durch den WebSocket-Proxy funktioniert Vites Hot Module Replacement weiterhin.
Ansichtswechsel
Wechsle über das Ansichten-Menü in der unteren Leiste zwischen Terminal und Vorschau.
Full-Stack-Arbeitsablauf
Führe Terminalbefehle aus und beobachte, wie deine App sich in Echtzeit aktualisiert.
Warum Termbridge
Keine Portweiterleitung oder VPN
Ein kontoloser Cloudflare Quick Tunnel macht deinen lokalen Server über HTTPS URL öffentlich erreichbar. Auf dem anderen Gerät brauchst du nur einen Browser.
Vollbildprogramme funktionieren
node-pty verbindet sich mit tmux und meldet ein Terminal mit 256 Farben. So verhalten sich TUIs wie htop und vim wie auf deinem lokalen Rechner.
Sitzungen überdauern die Verbindung
Ctrl+C schließt den Tunnel und den Server, lässt deine tmux-Sitzungen aber weiterlaufen. Starte es erneut mit --session, um eine bestehende Sitzung aufzurufen.
Läuft auf deinem Rechner
Der Server, der WebSocket und die Terminalregistrierung laufen auf deinem Computer und lauschen standardmäßig auf 127.0.0.1. Termbridge betreibt kein eigenes Backend.
Im Vergleich zu
Andere Möglichkeiten, von einem anderen Gerät auf ein Terminal zuzugreifen – und worin sich Termbridge unterscheidet.
| Werkzeug | Gut geeignet für | Unterschiede zu Termbridge |
|---|---|---|
| ttyd | Gut geeignet fürttyd teilt jeden Befehl über das Web und unterstützt dabei CJK- und IME-Eingaben, ZMODEM- und trzsz-Dateiübertragungen, Sixel-Bilder, SSL und einfache Authentifizierung. Es läuft auf macOS, Linux, den BSDs, OpenWrt und Windows. | Unterschiede zu TermbridgeTermbridge ergänzt den Tunnel, einen einmal verwendbaren QR-Anmeldelink und eine Steuerleiste fürs Smartphone. Die Shell läuft in tmux und bleibt nach einem Neustart erhalten. Entwickelt für macOS und Linux. |
| sshx | Gut geeignet fürsshx teilt ein Terminal mit nur einem Befehl mit beliebigen Personen. Auf einer unbegrenzten Arbeitsfläche sehen alle Beteiligten die Cursor der anderen. Mit Ende-zu-Ende-Verschlüsselung und Binärdateien für Linux, macOS und Windows. | Unterschiede zu TermbridgeTermbridge ermöglicht dir den Zugriff auf dein eigenes Terminal: Bei jedem Start wird ein einmal verwendbarer Anmeldelink ausgegeben. Der Datenverkehr läuft über einen Cloudflare-Tunnel zum Server auf deinem Rechner. |
| Tailscale SSH | Gut geeignet fürTailscale SSH überlässt Tailscale die Authentifizierung und Autorisierung von SSH-Verbindungen in deinem Tailnet. Die Verbindung wird mit WireGuard und Knotenschlüsseln verschlüsselt und funktioniert auf jedem Gerät mit Tailscale. | Unterschiede zu TermbridgeTermbridge erfordert auf dem anderen Gerät weder einen Client noch ein privates Netzwerk. Du erhältst ein öffentliches URL und einen QR-Code. Das Terminal öffnet sich im Browser. |
Quellen, ausgewählt
Fragen und Antworten
Kurze Antworten aus der Termbridge-Dokumentation.
Im Standardmodus läuft der Datenverkehr auf dem Weg zum Termbridge-Server auf deinem Computer durch einen Cloudflare Quick Tunnel. Termbridge betreibt kein eigenes Backend. Im Daytona-Sandbox-Modus läuft das Terminal in einer Sandbox in deinem Daytona-Konto. Im direkten Modus läuft dort auch der Server, und du stellst die Verbindung über den Daytona-Vorschau-Link her.
Der QR-Link enthält ein einmal verwendbares Token, das 90 Sekunden gültig ist. Beim Einlösen wird ein HttpOnly-Sitzungs-Cookie gesetzt. Auch für Terminal-WebSocket-Verbindungen ist ein CSRF-Token erforderlich. Teile den QR-Code oder den URL nicht mit Personen, denen du nicht vertraust.
Ja. Setze TERMBRIDGE_SESSIONS=3, um drei tmux-Sitzungen zu starten, und wechsle dann in der App mit dem Terminalwechsler zwischen ihnen.
Offiziell nicht. Termbridge wurde für macOS und Linux entwickelt. Mit WSL könnte es funktionieren, wurde aber nicht getestet.
Noch nicht. Cloudflare ist der einzige Tunnel-Anbieter. Du kannst einen benannten Cloudflare-Tunnel mit deinem eigenen Hostnamen verwenden, den Tunnel deaktivieren und deine eigene öffentliche URL angeben oder den direkten Daytona-Modus nutzen.
Im lokalen Modus besteht die Verbindung, solange Termbridge läuft. Sie wird getrennt, sobald der Computer in den Ruhezustand wechselt oder Termbridge beendet wird. Deine tmux-Sitzungen bleiben aktiv. Du kannst Termbridge erneut starten, den neuen QR-Code scannen und mit --session eine Sitzung aufrufen. Im direkten Daytona-Modus läuft der Server in der Sandbox.
Installiere Node 20+, tmux und cloudflared, führe npx termbridge aus und scanne den QR-Code, um dein Terminal im Browser auf deinem Smartphone zu öffnen.