Hoppa till innehåll

Felsökning

Visa som Markdown Redigera på GitHub Dokumentation på 1675df8

"spawn tmux ENOENT"

tmux är inte installerat eller finns inte i PATH. Termbridge visar det här felet men fortsätter för närvarande att köras utan att tillhandahålla en terminal (#4); tryck på Ctrl+C, installera tmux och starta det igen.

Shell
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

"spawn cloudflared ENOENT"

Tunnelklienten för Cloudflare är inte installerad eller finns inte i PATH. Den behövs bara i tunnelläget; direktlägena --no-tunnel och Daytona kräver inte cloudflared.

Shell
# macOS
brew install cloudflared

För Linux laddar du ned från cloudflare.com/downloads.

Tunneln startar inte

Här är några saker att kontrollera (hoppa över detta om du använder direkt sandlådeläge):

  1. Kontrollera att cloudflared fungerar: cloudflared --version
  2. Kontrollera att du kan nå https://trycloudflare.com
  3. Kontrollera om en brandvägg blockerar utgående anslutningar

Om tunneln inte startar visar Termbridge felet, stoppar servern och avslutas med status 1. Programmet växlar inte till ett läge som bara använder lokal åtkomst, och servern lyssnar som standard bara på 127.0.0.1, så andra enheter i nätverket kan inte heller nå den. Sessionerna tmux som skapats för körningen fortsätter att köras (#4).

Om du vill använda Termbridge utan tunneln Cloudflare kör du det bakom en egen omvänd proxy eller tunnel med --no-tunnel --public-url <url>.

"429 För många förfrågningar" från trycloudflare

Cloudflare begränsar hastigheten för tunnlar utan konto. Om du ser fel som 429 Too Many Requests kan du prova att:

  1. Vänta några minuter och försök igen
  2. Kontrollera att inga gamla cloudflared-processer fortfarande körs
  3. Använda en namngiven tunneltoken (rekommenderas vid frekvent användning)

Tom skärm eller "Det går inte att läsa in terminaler"

Det betyder oftast att webbläsaren saknar en giltig sessionscookie, till exempel för att sidan öppnades utan att en delningslänk löstes in eller för att tunnelns URL har ändrats:

  1. Kontrollera om den lokala servern fortfarande körs
  2. Titta efter fel i webbläsarens konsol av typen 401/403
  3. Starta om Termbridge för att få en ny URL- och QR-kod

Ingen utdata i terminalen

tmux-sessionen kanske inte körs:

Shell
# Check if sessions exist
tmux ls

Om sessionerna visas men terminalen är tom kan du prova att:

  • Läsa in sidan igen
  • Kontrollera att skalet har stöd för TERM=xterm-256color

QR-koden skannas men sidan är tom

QR-koden innehåller en engångstoken. Den fungerar en gång och bara inom 90 sekunder efter att Termbridge har startat. En använd eller utgången länk ger invalid token.

Lösning: Starta om Termbridge för att skapa en ny QR-kod och skanna den direkt.

node-pty-fel om spawn-helper

Termbridge försöker åtgärda detta automatiskt, men om du ser behörighetsfel:

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

Problem kvarstår?

Skapa ett ärende på github.com/inline0/termbridge med:

  • Din version av OS och Node.js
  • Felmeddelandet
  • Stegen för att återskapa problemet