# Trikčių šalinimas

## "spawn tmux ENOENT"

tmux neįdiegta arba jos nėra PATH kelyje. Termbridge parodo šią klaidą, tačiau kol kas tęsia darbą neaptarnaudama terminalo ([#4](https://github.com/inline0/termbridge/issues/4)); paspauskite `Ctrl+C`, įdiekite tmux ir paleiskite iš naujo.

```bash
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux
```

## "spawn cloudflared ENOENT"

Cloudflare tunelio klientas neįdiegtas arba jo nėra PATH kelyje. Jis reikalingas tik tunelio režimu; `--no-tunnel` ir Daytona tiesioginiam režimui cloudflared nereikia.

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

Jei naudojate Linux, atsisiųskite iš [cloudflare.com/downloads](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/).

## Nepavyksta paleisti tunelio

Patikrinkite kelis dalykus (jei naudojate tiesioginį smėlio dėžės režimą, šį skyrių praleiskite):

1. Patikrinkite, ar veikia cloudflared: `cloudflared --version`
2. Įsitikinkite, kad galite pasiekti `https://trycloudflare.com`
3. Patikrinkite, ar ugniasienė neblokuoja išeinančiųjų ryšių

Jei tunelio nepavyksta paleisti, Termbridge išveda klaidą, sustabdo serverį ir baigia darbą su būsena 1. Jis nepersijungia į režimą tik vietiniam naudojimui, o serveris pagal numatytuosius nustatymus klausosi tik `127.0.0.1`, todėl kiti įrenginiai jūsų tinkle taip pat negali jo pasiekti. Tą kartą sukurtos tmux sesijos lieka veikti ([#4](https://github.com/inline0/termbridge/issues/4)).

Norėdami naudoti Termbridge be Cloudflare tunelio, paleiskite jį su `--no-tunnel --public-url <url>` už savo atvirkštinio tarpinio serverio arba tunelio.

## „429 Per daug užklausų“ iš trycloudflare

Cloudflare riboja tunelių be paskyros užklausų dažnį. Jei matote tokias klaidas kaip `429 Too Many Requests`, pabandykite:

1. Palaukite kelias minutes ir bandykite dar kartą
2. Įsitikinkite, kad neveikia seni `cloudflared` procesai
3. Naudokite pavadinto tunelio prieigos raktą (rekomenduojama dažnai naudojant)

## Tuščias ekranas arba „Nepavyko įkelti terminalų“

Paprastai tai reiškia, kad naršyklėje nėra galiojančio sesijos slapuko, pavyzdžiui, jei ji atidaryta nepanaudojus bendrinimo nuorodos arba pasikeitė tunelio URL:

1. Patikrinkite, ar vietinis serveris vis dar veikia
2. Naršyklės konsolėje ieškokite 401/403 klaidų
3. Paleiskite Termbridge iš naujo, kad gautumėte naują URL ir QR kodą

## Terminale nieko nerodoma

Gali būti, kad tmux sesija neveikia:

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

Jei sesijos rodomos, bet terminalas tuščias, pabandykite:
- Iš naujo įkelti puslapį
- Patikrinti, ar jūsų apvalkalas palaiko `TERM=xterm-256color`

## QR kodas nuskaitomas, bet puslapis tuščias

QR kode yra vienkartinis prieigos raktas. Jis veikia tik vieną kartą ir tik per 90 sekundžių nuo Termbridge paleidimo. Panaudota arba nebegaliojanti nuoroda grąžina `invalid token`.

Sprendimas: paleiskite Termbridge iš naujo, kad sugeneruotumėte naują QR kodą, ir iškart jį nuskaitykite.

## node-pty klaidos, susijusios su spawn-helper

Termbridge bando tai ištaisyti automatiškai, bet jei matote leidimų klaidų:

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

## Vis dar nepavyksta?

Pateikite problemos aprašą adresu [github.com/inline0/termbridge](https://github.com/inline0/termbridge/issues) ir nurodykite:
- Savo OS ir Node.js versiją
- Klaidos pranešimą
- Veiksmus problemai atkartoti