# Rozwiązywanie problemów

## "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](https://github.com/inline0/termbridge/issues/4)). Naciśnij `Ctrl+C`, zainstaluj tmux i uruchom ponownie.

```bash
# 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.

```bash
# macOS
brew install cloudflared
```

W przypadku Linux pobierz pliki z [cloudflare.com/downloads](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/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](https://github.com/inline0/termbridge/issues/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ć:

```bash
# 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ń:

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

## Nadal masz problem?

Zgłoś problem w [github.com/inline0/termbridge](https://github.com/inline0/termbridge/issues), podając:
- swój system operacyjny i wersję Node.js
- treść błędu
- kroki pozwalające odtworzyć problem