Ga naar de inhoud

Problemen oplossen

Bekijken als Markdown Bewerken op GitHub Documentatie op 1675df8

"spawn tmux ENOENT"

tmux is niet geïnstalleerd of staat niet in je PATH. Termbridge geeft deze foutmelding, maar blijft momenteel draaien zonder een terminal aan te bieden (#4); druk op Ctrl+C, installeer tmux en start opnieuw.

Shell
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

"spawn cloudflared ENOENT"

De tunnelclient van Cloudflare is niet geïnstalleerd of staat niet in je PATH. Deze is alleen vereist voor de tunnelmodus; --no-tunnel en de directe modus van Daytona hebben cloudflared niet nodig.

Shell
# macOS
brew install cloudflared

Download voor Linux van cloudflare.com/downloads.

Tunnel start niet

Een paar dingen om te controleren (sla dit over als je de directe sandboxmodus gebruikt):

  1. Controleer of cloudflared werkt: cloudflared --version
  2. Controleer of je https://trycloudflare.com kunt bereiken
  3. Controleer of een firewall uitgaande verbindingen blokkeert

Als de tunnel niet start, geeft Termbridge de foutmelding weer, stopt de server en wordt afgesloten met status 1. Er wordt niet teruggevallen op een modus die alleen lokaal werkt. De server luistert standaard alleen op 127.0.0.1, zodat andere apparaten in je netwerk er ook niet bij kunnen. De tmux-sessies die voor die uitvoering zijn gemaakt, blijven actief (#4).

Als je Termbridge zonder de Cloudflare-tunnel wilt gebruiken, voer het dan uit met --no-tunnel --public-url <url> achter je eigen reverse proxy of tunnel.

"429 Too Many Requests" van trycloudflare

Cloudflare beperkt de snelheid van tunnels zonder account. Als je foutmeldingen zoals 429 Too Many Requests ziet, probeer dan het volgende:

  1. Wacht een paar minuten en probeer het opnieuw
  2. Controleer of er nog oude cloudflared-processen actief zijn
  3. Gebruik een benoemd tunneltoken (aanbevolen bij regelmatig gebruik)

Leeg scherm of "Unable to load terminals"

Dit betekent meestal dat de browser geen geldige sessiecookie heeft, bijvoorbeeld omdat de pagina is geopend zonder een deellink te gebruiken, of omdat de tunnel URL is gewijzigd:

  1. Controleer of de lokale server nog actief is
  2. Controleer de browserconsole op 401/403-fouten
  3. Start Termbridge opnieuw om een nieuwe URL- en QR-code te krijgen

Geen uitvoer in de terminal

De tmux-sessie is mogelijk niet actief:

Shell
# Check if sessions exist
tmux ls

Als er sessies verschijnen maar de terminal leeg is, probeer dan het volgende:

  • De pagina opnieuw laden
  • Controleren of je shell TERM=xterm-256color ondersteunt

QR-code wordt gescand maar de pagina is leeg

De QR-code bevat een eenmalig token. Deze werkt één keer en alleen binnen 90 seconden nadat Termbridge is gestart. Een gebruikte of verlopen link geeft invalid token terug.

Oplossing: start Termbridge opnieuw om een nieuwe QR-code te genereren en scan deze meteen.

node-pty-fouten over spawn-helper

Termbridge probeert dit automatisch op te lossen, maar als je fouten over rechten ziet:

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

Nog steeds vastgelopen?

Meld een probleem op github.com/inline0/termbridge met:

  • Je besturingssysteem en Node.js-versie
  • De foutmelding
  • De stappen om het probleem te reproduceren