Przejdź do treści

Rozwiązywanie problemów

Wyświetl jako Markdown Edytuj w GitHub Dokumentacja: 1675df8

"spawn tmux ENOENT"

tmux nie jest zainstalowany lub nie ma go w PATH. Termbridge wyświetla ten błąd, ale obecnie nadal działa, nie udostępniając terminala (#4). Naciśnij Ctrl+C, zainstaluj tmux i uruchom ponownie.

Powłoka
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

"spawn cloudflared ENOENT"

Klient tunelu Cloudflare nie jest zainstalowany lub nie ma go w PATH. Jest wymagany tylko w trybie tunelu; tryby bezpośrednie --no-tunnel i Daytona go nie potrzebują cloudflared.

Powłoka
# macOS
brew install cloudflared

W przypadku Linux pobierz pliki z cloudflare.com/downloads.

Tunel się nie uruchamia

Sprawdź kilka rzeczy (pomiń ten krok, jeśli używasz bezpośredniego trybu piaskownicy):

  1. Sprawdź, czy cloudflared działa: cloudflared --version
  2. Upewnij się, że możesz połączyć się z https://trycloudflare.com
  3. Sprawdź, czy zapora sieciowa nie blokuje połączeń wychodzących

Jeśli tunel nie uruchomi się, Termbridge wyświetla błąd, zatrzymuje serwer i kończy działanie ze statusem 1. Nie przełącza się na tryb działający tylko lokalnie, a serwer domyślnie nasłuchuje wyłącznie na 127.0.0.1, więc inne urządzenia w Twojej sieci również nie mogą uzyskać do niego dostępu. Sesje tmux utworzone podczas tego uruchomienia pozostają aktywne (#4).

Aby używać Termbridge bez tunelu Cloudflare, uruchom go z --no-tunnel --public-url <url> za własnym odwrotnym serwerem proxy lub tunelem.

„429 Zbyt wiele żądań” z trycloudflare

Cloudflare ogranicza liczbę tuneli bez konta. Jeśli pojawią się błędy takie jak 429 Too Many Requests, spróbuj:

  1. Odczekać kilka minut i spróbować ponownie
  2. Upewnić się, że nie działają żadne stare procesy cloudflared
  3. Użyć tokenu nazwanego tunelu (zalecane przy częstym używaniu)

Pusty ekran lub „Nie można wczytać terminali”

Zwykle oznacza to, że przeglądarka nie ma prawidłowego pliku cookie sesji. Może tak być na przykład wtedy, gdy została otwarta bez wymiany linku udostępniania lub zmienił się tunel URL:

  1. Sprawdź, czy serwer lokalny nadal działa
  2. Sprawdź błędy 401/403 w konsoli przeglądarki
  3. Uruchom ponownie Termbridge, aby wygenerować nowy kod URL i QR

Brak danych wyjściowych w terminalu

Sesja tmux może nie działać:

Powłoka
# Check if sessions exist
tmux ls

Jeśli sesje są widoczne, ale terminal jest pusty, spróbuj:

  • Ponownie wczytać stronę
  • Sprawdzić, czy Twoja powłoka obsługuje TERM=xterm-256color

Kod QR został zeskanowany, ale strona jest pusta

Kod QR zawiera jednorazowy token. Działa tylko raz i tylko przez 90 sekund od uruchomienia Termbridge. Użyty lub wygasły link zwraca invalid token.

Rozwiązanie: uruchom ponownie Termbridge, aby wygenerować nowy kod QR, i od razu go zeskanuj.

Błędy node-pty dotyczące spawn-helper

Termbridge próbuje naprawić ten problem automatycznie, ale jeśli pojawią się błędy uprawnień:

Powłoka
chmod +x node_modules/node-pty/prebuilds/**/spawn-helper

Nadal masz problem?

Zgłoś problem w github.com/inline0/termbridge, podając:

  • swój system operacyjny i wersję Node.js
  • treść błędu
  • kroki pozwalające odtworzyć problem