# Odpravljanje težav

## "spawn tmux ENOENT"

tmux ni nameščen ali ga ni v spremenljivki PATH. Termbridge izpiše to napako, vendar trenutno še naprej deluje, ne da bi ponujal terminal ([#4](https://github.com/inline0/termbridge/issues/4)); pritisnite `Ctrl+C`, namestite tmux in ga znova zaženite.

```bash
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux
```

## "spawn cloudflared ENOENT"

Odjemalec tunela za Cloudflare ni nameščen ali ga ni v spremenljivki PATH. Potreben je samo za način tunela; neposredna načina `--no-tunnel` in Daytona ne potrebujeta cloudflared.

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

Za Linux prenesite datoteko z naslova [cloudflare.com/downloads](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/).

## Tunela ni mogoče zagnati

Preverite nekaj stvari (to preskočite, če uporabljate neposredni način peskovnika):

1. Preverite, ali cloudflared deluje: `cloudflared --version`
2. Preverite, ali lahko dostopate do `https://trycloudflare.com`
3. Preverite, ali požarni zid blokira odhodne povezave

Če zagon tunela spodleti, Termbridge izpiše napako, ustavi strežnik in se konča s stanjem 1. Ne preklopi na način samo za lokalno uporabo; strežnik privzeto posluša samo na `127.0.0.1`, zato do njega ne morejo dostopati niti druge naprave v vašem omrežju. Seje tmux, ustvarjene za ta zagon, ostanejo aktivne ([#4](https://github.com/inline0/termbridge/issues/4)).

Če želite uporabljati Termbridge brez tunela Cloudflare, ga zaženite z `--no-tunnel --public-url <url>` za lastnim povratnim posredniškim strežnikom ali tunelom.

## "429 Too Many Requests" iz trycloudflare

Cloudflare omejuje število zahtev za tunele brez računa. Če se prikažejo napake, kot je `429 Too Many Requests`, poskusite:

1. Počakajte nekaj minut in poskusite znova
2. Preverite, ali še vedno delujejo stari procesi `cloudflared`
3. Uporabite žeton poimenovanega tunela (priporočeno za pogosto uporabo)

## Prazen zaslon ali »Unable to load terminals«

To običajno pomeni, da brskalnik nima veljavnega sejnega piškotka, na primer zato, ker je bil odprt brez uporabe povezave za skupno rabo ali ker se je spremenil tunel URL:

1. Preverite, ali lokalni strežnik še vedno deluje
2. V konzoli brskalnika poiščite napake 401/403
3. Znova zaženite Termbridge, da dobite novo kodo URL in QR

## V terminalu ni izpisa

Seja tmux morda ni aktivna:

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

Če so seje prikazane, terminal pa je prazen, poskusite:
- znova naložiti stran
- preveriti, ali vaša lupina podpira `TERM=xterm-256color`

## Koda QR se skenira, stran pa je prazna

Koda QR vsebuje enkratni žeton. Deluje samo enkrat in le v 90 sekundah po zagonu Termbridge. Uporabljena ali potekla povezava vrne `invalid token`.

Rešitev: Znova zaženite Termbridge, da ustvarite novo kodo QR, in jo takoj skenirajte.

## Napake node-pty v zvezi s spawn-helper

Termbridge to poskuša samodejno odpraviti, vendar če se prikažejo napake glede dovoljenj:

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

## Težave še vedno niste odpravili?

Prijavite težavo na naslovu [github.com/inline0/termbridge](https://github.com/inline0/termbridge/issues) in navedite:
- svoj operacijski sistem in različico Node.js
- sporočilo o napaki
- korake za ponovitev težave