# Riešenie problémov

## "spawn tmux ENOENT"

tmux nie je nainštalovaný alebo sa nenachádza vo vašej premennej PATH. Termbridge vypíše túto chybu, ale zatiaľ pokračuje v behu bez spustenia terminálu ([#4](https://github.com/inline0/termbridge/issues/4)); stlačte `Ctrl+C`, nainštalujte tmux a znova ho spustite.

```bash
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux
```

## "spawn cloudflared ENOENT"

Klient tunela Cloudflare nie je nainštalovaný alebo sa nenachádza vo vašej premennej PATH. Vyžaduje sa iba pre režim tunela; režimy `--no-tunnel` a Daytona direct tunel cloudflared nepotrebujú.

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

Pre Linux si stiahnite súbor z adresy [cloudflare.com/downloads](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/).

## Tunel sa nespustí

Skontrolujte niekoľko vecí (ak používate priamy režim sandboxu, tento krok preskočte):

1. Overte, či cloudflared funguje: `cloudflared --version`
2. Skontrolujte, či sa dokážete pripojiť k `https://trycloudflare.com`
3. Skontrolujte, či firewall neblokuje odchádzajúce pripojenia

Ak sa tunel nepodarí spustiť, Termbridge vypíše chybu, zastaví svoj server a skončí so stavom 1. Neprepne sa do režimu iba pre lokálny prístup a server predvolene počúva iba na `127.0.0.1`, takže sa k nemu nedostanú ani ostatné zariadenia vo vašej sieti. Relácie tmux vytvorené pri tomto spustení zostanú spustené ([#4](https://github.com/inline0/termbridge/issues/4)).

Ak chcete používať Termbridge bez tunela Cloudflare, spustite ho cez vlastný reverzný proxy server alebo tunel pomocou `--no-tunnel --public-url <url>`.

## „429 Too Many Requests“ od trycloudflare

Cloudflare obmedzuje počet požiadaviek v tuneloch bez účtu. Ak sa zobrazia chyby ako `429 Too Many Requests`, skúste:

1. Počkajte niekoľko minút a skúste to znova
2. Skontrolujte, či ešte nebežia staré procesy `cloudflared`
3. Použite token pomenovaného tunela (odporúča sa pri častom používaní)

## Prázdna obrazovka alebo „Unable to load terminals“

Zvyčajne to znamená, že prehliadač nemá platný súbor cookie relácie, napríklad preto, že ste ho otvorili bez uplatnenia zdieľacieho odkazu alebo sa zmenil tunel URL:

1. Skontrolujte, či lokálny server stále beží
2. V konzole prehliadača vyhľadajte chyby 401/403
3. Znova spustite Termbridge, aby ste získali nový URL a kód QR

## V termináli sa nič nezobrazuje

Relácia tmux možno nie je spustená:

```bash
# Check if sessions exist
tmux ls
```

Ak sa relácie zobrazujú, ale terminál je prázdny, skúste:
- Znova načítať stránku
- Skontrolovať, či váš shell podporuje `TERM=xterm-256color`

## Kód QR sa naskenuje, ale stránka je prázdna

Kód QR obsahuje jednorazový token. Funguje iba raz a len do 90 sekúnd od spustenia Termbridge. Pri použití odkazu po jeho uplatnení alebo po uplynutí platnosti sa zobrazí `invalid token`.

Riešenie: Znova spustite Termbridge, aby sa vygeneroval nový kód QR, a hneď ho naskenujte.

## Chyby node-pty týkajúce sa spawn-helper

Termbridge sa to pokúsi opraviť automaticky, ale ak sa zobrazia chyby oprávnení:

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

## Stále sa vám nedarí?

Vytvorte hlásenie na [github.com/inline0/termbridge](https://github.com/inline0/termbridge/issues) a uveďte:
- Váš operačný systém a verziu Node.js
- Chybovú správu
- Kroky na zopakovanie problému