# Tuneluri cu nume

În mod implicit, Termbridge folosește Quick Tunnels fără cont ale Cloudflare (`trycloudflare.com`). Sunt convenabile, dar utilizarea intensă poate duce la limitarea numărului de solicitări.

Dacă folosiți frecvent Termbridge, configurați un tunel cu nume folosind contul dvs. Cloudflare.

## De ce să folosiți un tunel cu nume?

- **Fără limite de solicitări**: În cazul utilizării intense, Quick Tunnels pot returna erori 429
- **URL consecvent**: Obțineți un subdomeniu stabil în locul unor șiruri aleatorii
- **Domeniu personalizat**: Folosiți propriul domeniu, precum `term.example.com`
- **Fiabilitate mai bună**: Tunelurile cu nume sunt mai stabile pentru sesiunile lungi

## Configurare

### 1. Creați un cont Cloudflare

Înregistrați-vă la [cloudflare.com](https://cloudflare.com) dacă nu aveți deja un cont.

### 2. Creați un tunel în Zero Trust

1. Accesați [Cloudflare Zero Trust](https://one.dash.cloudflare.com/)
2. Navigați la **Networks** → **Tunnels**
3. Faceți clic pe **Create a tunnel**
4. Alegeți **Cloudflared** ca conector
5. Dați un nume tunelului (de ex. e.g, `termbridge`)
6. Copiați tokenul tunelului

### 3. Adăugați un nume de gazdă public

1. În setările tunelului, accesați **Public Hostname**
2. Adăugați un nume de gazdă care să indice către `http://localhost:8080` (sau portul ales)
3. Folosiți un subdomeniu precum `term.example.com`

### 4. Rulați Termbridge cu tokenul dvs.

```bash
termbridge --port 8080 --tunnel-token <TOKEN> --tunnel-url https://term.example.com
```

Sau folosiți variabile de mediu:

```bash
export TERMBRIDGE_TUNNEL_TOKEN=<TOKEN>
export TERMBRIDGE_TUNNEL_URL=https://term.example.com

termbridge --port 8080
```

> **Notă**
> Indicatorul `--port` este obligatoriu pentru tunelurile cu nume, deoarece numele de gazdă este configurat să indice către un anumit port.


## Opțiuni de configurare

| Indicator | Variabilă de mediu | Descriere |
|------|---------------------|-------------|
| `--port <port>` | - | Port local (obligatoriu pentru tunelurile cu nume) |
| `--tunnel-token <token>` | `TERMBRIDGE_TUNNEL_TOKEN` | Tokenul tunelului dvs. |
| `--tunnel-url <url>` | `TERMBRIDGE_TUNNEL_URL` | Numele dvs. de gazdă public URL |

## Dezactivarea completă a tunelului

Dacă aveți propriul proxy invers sau propriul URL public:

```bash
termbridge --no-tunnel --public-url https://your-server.com
```

Sau:

```bash
export TERMBRIDGE_TUNNEL=none
export TERMBRIDGE_PUBLIC_URL=https://your-server.com

termbridge
```

Termbridge va omite pornirea unui tunel și va folosi propriul URL pentru codul QR.

## Depanare

### „429 Prea multe solicitări”

Aceasta înseamnă că Quick Tunnels au limite de solicitări. Soluții:

1. Așteptați câteva minute și încercați din nou
2. Opriți procesele `cloudflared` rămase active: `pkill cloudflared`
3. Treceți la un tunel cu nume (recomandat)

### Tunelul pornește, dar URL nu funcționează

- Verificați dacă numele gazdei din Cloudflare corespunde cu `--tunnel-url`
- Verificați dacă portul din Cloudflare corespunde cu `--port`
- Asigurați-vă că cloudflared este actualizat: `cloudflared update`

### Tunelul cu nume nu se conectează

- Verificați dacă tokenul este corect
- Verificați dacă există erori în tabloul de bord Cloudflare Zero Trust
- Încercați să rulați direct `cloudflared tunnel run <TOKEN>` pentru a vedea mesajele de eroare