Gå til indhold

Fejlfinding

"spawn tmux ENOENT"

tmux er ikke installeret eller findes ikke i din PATH. Termbridge viser denne fejl, men fortsætter i øjeblikket med at køre uden at stille en terminal til rådighed (#4); tryk på Ctrl+C, installer tmux, og start igen.

Shell
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

"spawn cloudflared ENOENT"

Cloudflare's tunnelklient er ikke installeret eller findes ikke i din PATH. Den kræves kun i tunneltilstand; direkte tilstand med --no-tunnel og Daytona behøver ikke cloudflared.

Shell
# macOS
brew install cloudflared

For Linux kan du downloade fra cloudflare.com/downloads.

Tunnelen starter ikke

Her er et par ting, du kan kontrollere (spring over, hvis du bruger direkte sandboxtilstand):

  1. Kontrollér, at cloudflared fungerer: cloudflared --version
  2. Sørg for, at du kan nå https://trycloudflare.com
  3. Kontrollér, om en firewall blokerer udgående forbindelser

Hvis tunnelen ikke starter, viser Termbridge fejlen, stopper sin server og afslutter med status 1. Den skifter ikke til en lokal tilstand, og serveren lytter som standard kun på 127.0.0.1, så andre enheder på dit netværk kan heller ikke få adgang til den. De tmux-sessioner, der blev oprettet under kørslen, fortsætter (#4).

Hvis du vil bruge Termbridge uden Cloudflare-tunnelen, skal du køre det med --no-tunnel --public-url <url> bag din egen reverse proxy eller tunnel.

"429 For mange anmodninger" fra trycloudflare

Cloudflare begrænser hastigheden for tunneler uden konto. Hvis du ser fejl som 429 Too Many Requests, kan du prøve:

  1. Vent et par minutter, og prøv igen
  2. Sørg for, at ingen gamle cloudflared-processer stadig kører
  3. Brug et token til en navngiven tunnel (anbefales ved hyppig brug)

Tom skærm eller "Kan ikke indlæse terminaler"

Det betyder som regel, at browseren ikke har en gyldig sessionscookie, for eksempel fordi den blev åbnet uden at indløse et delingslink, eller fordi tunnelen URL blev ændret:

  1. Kontrollér, om den lokale server stadig kører
  2. Se efter 401/403-fejl i browserkonsollen
  3. Genstart Termbridge for at få en ny URL- og QR-kode

Intet output i terminalen

tmux-sessionen kører muligvis ikke:

Shell
# Check if sessions exist
tmux ls

Hvis sessionerne vises, men terminalen er tom, kan du prøve:

  • At genindlæse siden
  • At kontrollere, at din shell understøtter TERM=xterm-256color

QR-koden scannes, men siden er tom

QR-koden indeholder et engangstoken. Den virker én gang og kun inden for 90 sekunder efter, at Termbridge er startet. Et brugt eller udløbet link returnerer invalid token.

Løsning: Genstart Termbridge for at generere en ny QR-kode, og scan den med det samme.

node-pty-fejl om spawn-helper

Termbridge forsøger at løse dette automatisk, men hvis du ser tilladelsesfejl:

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

Stadig problemer?

Opret et issue på github.com/inline0/termbridge med:

  • Dit operativsystem og Node.js-version
  • Fejlmeddelelsen
  • Trin til at genskabe problemet