# Poimenovani tuneli

Privzeto Termbridge uporablja Cloudflare hitre tunele brez računa (`trycloudflare.com`). Ti so priročni, vendar je njihova uporaba lahko omejena pri intenzivni uporabi.

Če pogosto uporabljate Termbridge, nastavite poimenovani tunel z računom Cloudflare.

## Zakaj uporabiti poimenovani tunel?

- **Brez omejitev hitrosti**: Pri intenzivni uporabi lahko hitri tuneli Quick Tunnels vrnejo napake 429
- **Stalen URL**: Pridobite stabilno poddomeno namesto naključnih nizov
- **Domena po meri**: Uporabite svojo domeno, na primer `term.example.com`
- **Večja zanesljivost**: Poimenovani tuneli so stabilnejši pri dolgotrajnih sejah

## Nastavitev

### 1. Ustvarite račun Cloudflare

Če še nimate računa, se registrirajte na [cloudflare.com](https://cloudflare.com).

### 2. Ustvarite tunel v Zero Trust

1. Odprite [Cloudflare Zero Trust](https://one.dash.cloudflare.com/)
2. Pomaknite se do **Omrežja** → **Tuneli**
3. Kliknite **Ustvari tunel**
4. Za povezovalnik izberite **Cloudflared**
5. Poimenujte tunel (npr. e.g., `termbridge`)
6. Kopirajte žeton tunela

### 3. Dodajte javno ime gostitelja

1. V nastavitvah tunela odprite **Javno ime gostitelja**
2. Dodajte ime gostitelja, ki kaže na `http://localhost:8080` (ali izbrana vrata)
3. Uporabite poddomeno, kot je `term.example.com`

### 4. Zaženite Termbridge s svojim žetonom

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

Lahko pa uporabite spremenljivke okolja:

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

termbridge --port 8080
```

> **Opomba**
> Pri poimenovanih tunelih je zastavica `--port` obvezna, ker je ime gostitelja nastavljeno tako, da kaže na določena vrata.


## Možnosti konfiguracije

| Zastavica | Spremenljivka okolja | Opis |
|------|---------------------|-------------|
| `--port <port>` | - | Lokalna vrata (obvezno pri poimenovanih tunelih) |
| `--tunnel-token <token>` | `TERMBRIDGE_TUNNEL_TOKEN` | Vaš žeton tunela |
| `--tunnel-url <url>` | `TERMBRIDGE_TUNNEL_URL` | Vaše javno ime gostitelja URL |

## Popoln izklop tunela

Če imate lasten povratni posredniški strežnik ali javni URL:

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

Ali pa:

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

termbridge
```

Termbridge ne bo zagnal tunela in bo uporabil vaš URL za kodo QR.

## Odpravljanje težav

### "429 Preveč zahtev"

To pomeni, da za hitre tunele Quick Tunnels veljajo omejitve hitrosti. Rešitve:

1. Počakajte nekaj minut in poskusite znova
2. Ustavite morebitne zastarele procese `cloudflared`: `pkill cloudflared`
3. Preklopite na poimenovani tunel (priporočeno)

### Predor se zažene, vendar URL ne deluje

- Preverite, ali se ime gostitelja v Cloudflare ujema z `--tunnel-url`
- Preverite, ali se vrata v Cloudflare ujemajo z `--port`
- Prepričajte se, da je cloudflared posodobljen: `cloudflared update`

### Povezava z imenovanim predorom ni mogoča

- Preverite, ali je vaš žeton pravilen
- Na nadzorni plošči Cloudflare Zero Trust preverite, ali so prikazane napake
- Poskusite neposredno zagnati `cloudflared tunnel run <TOKEN>`, da preverite sporočila o napakah