Erste Schritte

Voraussetzungen installieren

Installiere für die standardmäßige lokale Tunneleinrichtung diese Tools auf deinem Computer:

Node.js 20+

Lade es von nodejs.org herunter oder verwende deinen Paketmanager.

# Check if installed
node --version

tmux

Der Terminal-Multiplexer, der Termbridge-Sitzungen ermöglicht.

# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

cloudflared

Erstellt den sicheren Tunnel zu deinem Terminal (im direkten Sandbox-Modus nicht erforderlich).

# macOS
brew install cloudflared

# Linux - see cloudflare.com/downloads

cloudflared herunterladen

Termbridge ausführen

npx termbridge

Die Ausgabe sieht etwa so aus:

┌─────────────────────────────────────────┐
│  Termbridge                             │
│                                         │
│  Local:   http://127.0.0.1:51234        │
│  Public:  https://abc123.trycloudflare.com │
│                                         │
│  ██████████████                         │
│  ██          ██  <- Scan this QR code   │
│  ██████████████                         │
│                                         │
└─────────────────────────────────────────┘

Hinweis Das trycloudflare.com URL ist ein temporärer Tunnel, für den kein Konto erforderlich ist. Wenn du Termbridge häufig verwendest, richte ein Token für einen benannten Cloudflare-Tunnel ein, um Ratenbegrenzungen zu vermeiden.

Mit deinem Smartphone verbinden

1. Öffne die Kamera deines Smartphones
2. Richte sie auf den QR-Code
3. Tippe auf den angezeigten Link
4. Dein Terminal wird im Browser geladen

Das war's – du bist verbunden!

Was ist gerade passiert?

1. Termbridge hat einen lokalen Server auf deinem Rechner gestartet
2. Für dein Terminal wurde eine tmux-Sitzung erstellt
3. Cloudflare hat einen sicheren Tunnel eingerichtet (den trycloudflare.com URL)
4. Der QR-Code enthält ein einmaliges Token für den sicheren Zugriff. Es funktioniert nur einmal und läuft 90 Sekunden nach dem Start ab. Scanne den Code daher zeitnah. Ist er abgelaufen, starte Termbridge neu, um einen neuen zu erhalten
5. Beim Scannen hast du ein Sitzungscookie erhalten und dich verbunden

Probier es aus

Probiere nach dem Verbinden ein paar Befehle aus:

# See system info
htop

# Check a git repo
cd ~/your-project && git status

# Run any CLI tool

Das Terminal unterstützt alle Farben, TUIs und Tasten, die du erwartest.

Weiterlaufen lassen

Termbridge muss laufen, damit die Verbindung funktioniert. Wenn du fertig bist:

• Drücke Ctrl+C im Terminal, in dem Termbridge läuft
• Der Tunnel wird geschlossen und die Verbindung beendet
• Deine tmux-Sitzung bleibt aktiv (sofern du nicht --kill-on-exit verwendet hast)

Verhalten der ersten Sitzung

• Termbridge erstellt eine tmux-Sitzung (der Standardname leitet sich vom Port ab)
• Das erste Terminal in der Liste wird automatisch geladen
• Beim Start kannst du mehrere Sitzungen erstellen, indem du TERMBRIDGE_SESSIONS=2 festlegst

Vorhandene tmux-Sitzung verwenden

Wenn du --session <name> angibst und diese Sitzung bereits besteht, verbindet sich Termbridge mit ihr, statt eine neue zu erstellen. Das ist praktisch, wenn du bereits gestartete, länger laufende Prozesse überwachen möchtest.

Nächste Schritte

Steuerung auf Mobilgeräten

Tipps zur Verwendung von Termbridge auf Smartphones und Tablets

Mehrere Terminals

Führe mehrere Sitzungen aus und wechsle zwischen ihnen

Vorschau des Dev-Servers

Zeige deine Vite-App neben dem Terminal in der Vorschau an

CLI-Referenz

Alle verfügbaren Flags und Optionen ansehen