# Nimega tunnelid

Vaikimisi kasutab Termbridge Cloudflare kontota kiirtunneleid (`trycloudflare.com`). Need on mugavad, kuid suure kasutuskoormuse korral võidakse neile kehtestada kiiruspiirang.

Kui kasutate Termbridge sageli, seadistage oma Cloudflare kontoga nimega tunnel.

## Miks kasutada nimega tunnelit?

- **Kiiruspiiranguid pole**: suure kasutuskoormuse korral võivad kiirtunnelid tagastada 429 tõrkeid
- **Püsiv URL**: saate juhuslike stringide asemel stabiilse alamdomeeni
- **Kohandatud domeen**: kasutage enda domeeni, näiteks `term.example.com`
- **Suurem töökindlus**: nimega tunnelid on pikkade seansside ajal stabiilsemad

## Seadistamine

### 1. Looge Cloudflare konto

Kui teil pole kontot, registreeruge aadressil [cloudflare.com](https://cloudflare.com)

### 2. Looge Zero Trustis tunnel

1. Avage [Cloudflare Zero Trust](https://one.dash.cloudflare.com/)
2. Liikuge jaotisse **Networks** → **Tunnels**
3. Klõpsake **Create a tunnel**
4. Valige ühenduseks **Cloudflared**
5. Pange tunnelile nimi (e.g., `termbridge`)
6. Kopeerige tunneli luba

### 3. Lisage avalik hostinimi

1. Avage tunneli seadetes **Public Hostname**
2. Lisage hostinimi, mis suunab aadressile `http://localhost:8080` (või valitud porti)
3. Kasutage alamdomeeni, näiteks `term.example.com`

### 4. Käivitage Termbridge oma loaga

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

Või kasutage keskkonnamuutujaid:

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

termbridge --port 8080
```

> **Märkus**
> Nimega tunnelite puhul on lipp `--port` kohustuslik, sest hostinimi on seadistatud suunama kindlale pordile.


## Seadistusvalikud

| Lipp | Keskkonnamuutuja | Kirjeldus |
|------|---------------------|-------------|
| `--port <port>` | - | Kohalik port (nimega tunnelite puhul kohustuslik) |
| `--tunnel-token <token>` | `TERMBRIDGE_TUNNEL_TOKEN` | Teie tunneli luba |
| `--tunnel-url <url>` | `TERMBRIDGE_TUNNEL_URL` | Teie avalik hostinimi URL |

## Tunneli täielik keelamine

Kui teil on oma pöördpuhverserver või avalik URL:

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

Või:

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

termbridge
```

Termbridge jätab tunneli käivitamata ja kasutab QR koodi jaoks teie antud URL väärtust.

## Tõrkeotsing

### „429 Too Many Requests“

See tähendab, et kiirtunnelitele kehtib kiiruspiirang. Lahendused:

1. Oodake mõni minut ja proovige uuesti
2. Sulgege kõik aegunud `cloudflared` protsessid: `pkill cloudflared`
3. Lülituge nimega tunnelile (soovitatav)

### Tunnel käivitub, kuid URL ei tööta

- Kontrollige, et Cloudflare hostinimi vastaks `--tunnel-url`-le
- Kontrollige, et Cloudflare port vastaks `--port`-le
- Veenduge, et cloudflared oleks ajakohane: `cloudflared update`

### Nimega tunnel ei loo ühendust

- Kontrollige, kas teie luba on õige
- Kontrollige Cloudflare Zero Trust armatuurlaualt, kas seal on tõrkeid
- Proovige käivitada `cloudflared tunnel run <TOKEN>` otse, et näha tõrketeateid