# Hibaelhárítás

## "spawn tmux ENOENT"

A tmux nincs telepítve, vagy nem szerepel a PATH-ban. A Termbridge kiírja ezt a hibát, de jelenleg tovább fut terminál kiszolgálása nélkül ([#4](https://github.com/inline0/termbridge/issues/4)); nyomja meg a `Ctrl+C` billentyűt, telepítse a tmux eszközt, majd indítsa újra.

```bash
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux
```

## "spawn cloudflared ENOENT"

A Cloudflare alagútkliens nincs telepítve, vagy nem szerepel a PATH-ban. Erre csak alagút módban van szükség; a `--no-tunnel` és a Daytona közvetlen módhoz nem szükséges a cloudflared.

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

A Linux esetében töltse le innen: [cloudflare.com/downloads](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/).

## Nem indul el az alagút

Ellenőrizzen néhány dolgot (ha közvetlen sandboxmódot használ, ezt kihagyhatja):

1. Ellenőrizze, hogy működik-e a cloudflared: `cloudflared --version`
2. Győződjön meg róla, hogy eléri a `https://trycloudflare.com` címet
3. Ellenőrizze, nem blokkolja-e tűzfal a kimenő kapcsolatokat

Ha az alagút nem indul el, a Termbridge kiírja a hibát, leállítja a szerverét, és 1-es állapotkóddal kilép. Nem vált át csak helyi módra, és a szerver alapértelmezés szerint csak a `127.0.0.1` címen figyel, így a hálózat más eszközei sem érik el. Az adott futtatás során létrehozott tmux munkamenetek tovább futnak ([#4](https://github.com/inline0/termbridge/issues/4)).

A Cloudflare alagút nélkül a Termbridge saját fordított proxy vagy alagút mögött futtatható a `--no-tunnel --public-url <url>` használatával.

## „429 Too Many Requests” hiba a trycloudflare szolgáltatástól

A Cloudflare korlátozza a fiók nélküli alagutak sebességét. Ha ilyen hibákat lát: `429 Too Many Requests`, próbálja meg a következőket:

1. Várjon néhány percet, majd próbálja újra
2. Ellenőrizze, hogy nem fut-e még régi `cloudflared` folyamat
3. Használjon névvel ellátott alagúttokent (gyakori használat esetén ajánlott)

## Üres képernyő vagy „Unable to load terminals” hiba

Ez általában azt jelenti, hogy a böngészőben nincs érvényes munkamenet-süti, például mert a megosztási hivatkozás beváltása nélkül nyitották meg az oldalt, vagy megváltozott az alagút URL értéke:

1. Ellenőrizze, hogy a helyi szerver még fut-e
2. Keresse meg a böngésző konzoljában a 401/403 hibákat
3. Indítsa újra a Termbridge eszközt új URL és QR kód létrehozásához

## Nincs kimenet a terminálban

Lehet, hogy a tmux munkamenet nem fut:

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

Ha a munkamenetek megjelennek, de a terminál üres, próbálja meg:
- Az oldal újratöltését
- Annak ellenőrzését, hogy a parancsértelmező támogatja-e a `TERM=xterm-256color` értéket

## A QR kód beolvasása után üres az oldal

A QR kód egyszer használható tokent tartalmaz. Csak egyszer működik, és csak a Termbridge indulását követő 90 másodpercen belül. A felhasznált vagy lejárt hivatkozás `invalid token` választ ad.

Megoldás: Indítsa újra a Termbridge eszközt új QR kód létrehozásához, majd azonnal olvassa be.

## node-pty hibák a spawn-helperrel kapcsolatban

A Termbridge megpróbálja automatikusan kijavítani ezt, de ha jogosultsági hibát lát:

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

## Még mindig elakadt?

Nyisson hibajegyet itt: [github.com/inline0/termbridge](https://github.com/inline0/termbridge/issues), és adja meg a következőket:
- Az operációs rendszer és a Node.js verziója
- A hibaüzenet
- A hiba előidézésének lépései