Treci la conținut

Depanare

Vizualizați ca Markdown Editați pe GitHub Documentație la 1675df8

"spawn tmux ENOENT"

tmux nu este instalat sau nu se află în PATH. Termbridge afișează această eroare, dar continuă să ruleze fără să furnizeze un terminal (#4); apăsați Ctrl+C, instalați tmux și porniți din nou.

Shell
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

"spawn cloudflared ENOENT"

Clientul de tunel al Cloudflare nu este instalat sau nu se află în PATH. Este necesar doar pentru modul tunel; modurile directe --no-tunnel și Daytona nu au nevoie de cloudflared.

Shell
# macOS
brew install cloudflared

Pentru Linux, descărcați de la cloudflare.com/downloads.

Tunelul nu pornește

Câteva lucruri de verificat (omiteți această secțiune dacă folosiți modul sandbox direct):

  1. Verificați dacă cloudflared funcționează: cloudflared --version
  2. Asigurați-vă că puteți accesa https://trycloudflare.com
  3. Verificați dacă un firewall blochează conexiunile de ieșire

Dacă tunelul nu pornește, Termbridge afișează eroarea, oprește serverul și se închide cu starea 1. Nu trece la modul exclusiv local, iar serverul ascultă implicit numai pe 127.0.0.1, astfel că nici alte dispozitive din rețea nu îl pot accesa. Sesiunile tmux create pentru acea rulare rămân active (#4).

Pentru a folosi Termbridge fără tunelul Cloudflare, rulați-l cu --no-tunnel --public-url <url> în spatele propriului proxy invers sau tunel.

„429 Too Many Requests” de la trycloudflare

Cloudflare limitează frecvența tunelurilor fără cont. Dacă vedeți erori precum 429 Too Many Requests, încercați:

  1. Așteptați câteva minute și reîncercați
  2. Asigurați-vă că nu mai rulează procese cloudflared vechi
  3. Folosiți un token de tunel numit (recomandat pentru utilizare frecventă)

Ecran gol sau „Unable to load terminals”

De obicei, aceasta înseamnă că browserul nu are un cookie de sesiune valid, de exemplu pentru că a fost deschis fără să valorificați un link de partajare sau pentru că s-a schimbat URL tunelului:

  1. Verificați dacă serverul local încă rulează
  2. Căutați erori 401/403 în consola browserului
  3. Reporniți Termbridge pentru a obține un cod URL și QR nou

Nu apare nicio ieșire în terminal

Este posibil ca sesiunea tmux să nu ruleze:

Shell
# Check if sessions exist
tmux ls

Dacă sesiunile apar, dar terminalul este gol, încercați:

  • Reîncărcați pagina
  • Verificați dacă shell-ul acceptă TERM=xterm-256color

Codul QR este scanat, dar pagina este goală

Codul QR conține un token de unică folosință. Funcționează o singură dată și numai în primele 90 de secunde de la pornirea Termbridge. Un link folosit sau expirat returnează invalid token.

Soluție: reporniți Termbridge pentru a genera un cod QR nou și scanați-l imediat.

Erori node-pty despre spawn-helper

Termbridge încearcă să rezolve automat problema, dar dacă vedeți erori de permisiune:

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

Problema persistă?

Raportați problema la github.com/inline0/termbridge, incluzând:

  • Sistemul de operare și versiunea Node.js
  • Mesajul de eroare
  • Pașii pentru reproducerea problemei