Zum Inhalt springen

Fehlerbehebung

Als Markdown anzeigen Auf GitHub bearbeiten Dokumentation zu 1675df8

"spawn tmux ENOENT"

tmux ist nicht installiert oder befindet sich nicht in deinem PATH. Termbridge gibt diesen Fehler aus, läuft aber derzeit ohne Terminal weiter (#4); drücke Ctrl+C, installiere tmux und starte es erneut.

Shell
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

"spawn cloudflared ENOENT"

Der Tunnel-Client von Cloudflare ist nicht installiert oder befindet sich nicht in deinem PATH. Er wird nur im Tunnelmodus benötigt; --no-tunnel und der Daytona-Direktmodus benötigen cloudflared nicht.

Shell
# macOS
brew install cloudflared

Lade für Linux die Datei unter cloudflare.com/downloads herunter.

Tunnel startet nicht

Prüfe Folgendes (überspringe diesen Abschnitt, wenn du den direkten Sandbox-Modus verwendest):

  1. Prüfe, ob cloudflared funktioniert: cloudflared --version
  2. Stelle sicher, dass du https://trycloudflare.com erreichen kannst
  3. Prüfe, ob eine Firewall ausgehende Verbindungen blockiert

Wenn der Tunnel nicht startet, gibt Termbridge den Fehler aus, beendet den Server und schließt mit Status 1. Es wechselt nicht in einen lokalen Modus, und der Server lauscht standardmäßig nur auf 127.0.0.1. Andere Geräte in deinem Netzwerk können ihn daher ebenfalls nicht erreichen. Die für diesen Lauf erstellten tmux-Sitzungen bleiben geöffnet (#4).

Um Termbridge ohne Cloudflare-Tunnel zu verwenden, führe es mit --no-tunnel --public-url <url> hinter deinem eigenen Reverse-Proxy oder Tunnel aus.

„429 Too Many Requests“ von trycloudflare

Cloudflare begrenzt die Rate von Tunneln ohne Konto. Wenn du Fehler wie 429 Too Many Requests siehst, versuche Folgendes:

  1. Warte ein paar Minuten und versuche es erneut
  2. Stelle sicher, dass keine alten cloudflared-Prozesse mehr laufen
  3. Verwende ein Token für einen benannten Tunnel (empfohlen bei häufiger Nutzung)

Leerer Bildschirm oder „Unable to load terminals“

Das bedeutet meist, dass der Browser kein gültiges Sitzungscookie hat. Das kann zum Beispiel daran liegen, dass du ihn geöffnet hast, ohne zuvor einen Freigabelink einzulösen, oder dass sich der Tunnel URL geändert hat:

  1. Prüfe, ob der lokale Server noch läuft
  2. Suche in der Browserkonsole nach 401/403-Fehlern
  3. Starte Termbridge neu, um einen neuen URL- und QR-Code zu erhalten

Keine Ausgabe im Terminal

Die tmux-Sitzung läuft möglicherweise nicht:

Shell
# Check if sessions exist
tmux ls

Wenn Sitzungen angezeigt werden, das Terminal aber leer ist, versuche Folgendes:

  • Lade die Seite neu
  • Prüfe, ob deine Shell TERM=xterm-256color unterstützt

QR-Code wird gescannt, aber die Seite bleibt leer

Der QR-Code enthält ein einmaliges Token. Er funktioniert nur einmal und nur innerhalb von 90 Sekunden nach dem Start von Termbridge. Bei einem bereits verwendeten oder abgelaufenen Link wird invalid token angezeigt.

Lösung: Starte Termbridge neu, um einen neuen QR-Code zu erstellen, und scanne ihn sofort.

node-pty-Fehler zu spawn-helper

Termbridge versucht, das automatisch zu beheben. Falls Berechtigungsfehler auftreten:

Shell
chmod +x node_modules/node-pty/prebuilds/**/spawn-helper

Kommst du nicht weiter?

Melde das Problem unter github.com/inline0/termbridge mit folgenden Angaben:

  • Deinem Betriebssystem und der Node.js-Version
  • Der Fehlermeldung
  • Den Schritten zur Reproduktion