# Depanare

## "spawn tmux ENOENT"

tmux nu este instalat sau nu se află în PATH. Termbridge afișează această eroare, dar continuă să ruleze fără să furnizeze un terminal ([#4](https://github.com/inline0/termbridge/issues/4)); apăsați `Ctrl+C`, instalați tmux și porniți din nou.

```bash
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux
```

## "spawn cloudflared ENOENT"

Clientul de tunel al Cloudflare nu este instalat sau nu se află în PATH. Este necesar doar pentru modul tunel; modurile directe `--no-tunnel` și Daytona nu au nevoie de cloudflared.

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

Pentru Linux, descărcați de la [cloudflare.com/downloads](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/).

## Tunelul nu pornește

Câteva lucruri de verificat (omiteți această secțiune dacă folosiți modul sandbox direct):

1. Verificați dacă cloudflared funcționează: `cloudflared --version`
2. Asigurați-vă că puteți accesa `https://trycloudflare.com`
3. Verificați dacă un firewall blochează conexiunile de ieșire

Dacă tunelul nu pornește, Termbridge afișează eroarea, oprește serverul și se închide cu starea 1. Nu trece la modul exclusiv local, iar serverul ascultă implicit numai pe `127.0.0.1`, astfel că nici alte dispozitive din rețea nu îl pot accesa. Sesiunile tmux create pentru acea rulare rămân active ([#4](https://github.com/inline0/termbridge/issues/4)).

Pentru a folosi Termbridge fără tunelul Cloudflare, rulați-l cu `--no-tunnel --public-url <url>` în spatele propriului proxy invers sau tunel.

## „429 Too Many Requests” de la trycloudflare

Cloudflare limitează frecvența tunelurilor fără cont. Dacă vedeți erori precum `429 Too Many Requests`, încercați:

1. Așteptați câteva minute și reîncercați
2. Asigurați-vă că nu mai rulează procese `cloudflared` vechi
3. Folosiți un token de tunel numit (recomandat pentru utilizare frecventă)

## Ecran gol sau „Unable to load terminals”

De obicei, aceasta înseamnă că browserul nu are un cookie de sesiune valid, de exemplu pentru că a fost deschis fără să valorificați un link de partajare sau pentru că s-a schimbat URL tunelului:

1. Verificați dacă serverul local încă rulează
2. Căutați erori 401/403 în consola browserului
3. Reporniți Termbridge pentru a obține un cod URL și QR nou

## Nu apare nicio ieșire în terminal

Este posibil ca sesiunea tmux să nu ruleze:

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

Dacă sesiunile apar, dar terminalul este gol, încercați:
- Reîncărcați pagina
- Verificați dacă shell-ul acceptă `TERM=xterm-256color`

## Codul QR este scanat, dar pagina este goală

Codul QR conține un token de unică folosință. Funcționează o singură dată și numai în primele 90 de secunde de la pornirea Termbridge. Un link folosit sau expirat returnează `invalid token`.

Soluție: reporniți Termbridge pentru a genera un cod QR nou și scanați-l imediat.

## Erori node-pty despre spawn-helper

Termbridge încearcă să rezolve automat problema, dar dacă vedeți erori de permisiune:

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

## Problema persistă?

Raportați problema la [github.com/inline0/termbridge](https://github.com/inline0/termbridge/issues), incluzând:
- Sistemul de operare și versiunea Node.js
- Mesajul de eroare
- Pașii pentru reproducerea problemei