# Řešení problémů

## "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](https://github.com/inline0/termbridge/issues/4)); stiskněte `Ctrl+C`, nainstalujte tmux a spusťte ho znovu.

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

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

Pro Linux stáhněte aplikaci z [cloudflare.com/downloads](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/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](https://github.com/inline0/termbridge/issues/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ěží:

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

```bash
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](https://github.com/inline0/termbridge/issues) a uveďte:
- Svůj operační systém a verzi Node.js
- Chybovou zprávu
- Kroky k reprodukci problému