Přejít k obsahu

Řešení problémů

Zobrazit jako Markdown Upravit na GitHub Dokumentace na 1675df8

"spawn tmux ENOENT"

tmux není nainstalován nebo není v proměnné PATH. Termbridge tuto chybu vypíše, ale zatím běží dál bez zpřístupnění terminálu (#4); stiskněte Ctrl+C, nainstalujte tmux a spusťte ho znovu.

Shell
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

"spawn cloudflared ENOENT"

Tunelovací klient Cloudflare není nainstalován nebo není v proměnné PATH. Je potřeba pouze pro režim tunelu; přímý režim --no-tunnel a Daytona nevyžaduje cloudflared.

Shell
# macOS
brew install cloudflared

Pro Linux stáhněte aplikaci z cloudflare.com/downloads.

Tunel se nespustí

Zkontrolujte několik věcí (tento krok přeskočte, pokud používáte přímý režim sandboxu):

  1. Ověřte, že cloudflared funguje: cloudflared --version
  2. Zkontrolujte, zda se můžete připojit k https://trycloudflare.com
  3. Zjistěte, zda firewall neblokuje odchozí připojení

Pokud se tunel nepodaří spustit, Termbridge vypíše chybu, zastaví server a skončí se stavem 1. Nepřepne se do režimu pouze pro místní připojení; server navíc ve výchozím nastavení naslouchá pouze na 127.0.0.1, takže se k němu nedostanou ani ostatní zařízení ve vaší síti. Relace tmux vytvořené při tomto spuštění zůstanou aktivní (#4).

Chcete-li používat Termbridge bez tunelu Cloudflare, spusťte ho s --no-tunnel --public-url <url> za vlastním reverzním proxy serverem nebo tunelem.

Chyba „429 Too Many Requests“ ze služby trycloudflare

Cloudflare omezuje počet požadavků pro tunely bez účtu. Pokud se zobrazí chyby jako 429 Too Many Requests, zkuste:

  1. Počkejte několik minut a zkuste to znovu
  2. Ověřte, že neběží žádné staré procesy cloudflared
  3. Použijte token pojmenovaného tunelu (doporučeno pro časté používání)

Prázdná obrazovka nebo „Terminály se nepodařilo načíst“

To obvykle znamená, že prohlížeč nemá platnou relační cookie, například protože byl otevřen bez použití odkazu ke sdílení nebo se změnil tunel URL:

  1. Zkontrolujte, zda místní server stále běží
  2. V konzoli prohlížeče vyhledejte chyby 401/403
  3. Restartujte Termbridge, abyste získali nový kód URL a QR

V terminálu se nic nezobrazuje

Relace tmux možná neběží:

Shell
# Check if sessions exist
tmux ls

Pokud se relace zobrazují, ale terminál je prázdný, zkuste:

  • Znovu načíst stránku
  • Zkontrolovat, zda váš shell podporuje TERM=xterm-256color

Kód QR se naskenuje, ale stránka je prázdná

Kód QR obsahuje jednorázový token. Funguje pouze jednou a jen do 90 sekund od spuštění Termbridge. Použitý nebo prošlý odkaz vrátí invalid token.

Řešení: Restartujte Termbridge, vygenerujte nový kód QR a hned ho naskenujte.

Chyby node-pty týkající se spawn-helper

Termbridge se to pokouší automaticky opravit, ale pokud se zobrazí chyby oprávnění:

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

Stále se nedaří problém vyřešit?

Vytvořte hlášení na github.com/inline0/termbridge a uveďte:

  • Svůj operační systém a verzi Node.js
  • Chybovou zprávu
  • Kroky k reprodukci problému