# Pomenované tunely

Predvolene Termbridge používa rýchle tunely Cloudflare bez účtu (`trycloudflare.com`). Sú praktické, no pri intenzívnom používaní môžu podliehať obmedzeniam počtu požiadaviek.

Ak Termbridge používate často, nastavte si pomenovaný tunel pomocou svojho účtu Cloudflare.

## Prečo používať pomenovaný tunel?

- **Bez obmedzení počtu požiadaviek**: Rýchle tunely môžu pri intenzívnom používaní vracať chyby 429
- **Stála adresa URL**: Získajte stabilnú subdoménu namiesto náhodných reťazcov
- **Vlastná doména**: Použite vlastnú doménu, napríklad `term.example.com`
- **Vyššia spoľahlivosť**: Pomenované tunely sú stabilnejšie pri dlhých reláciách

## Nastavenie

### 1. Vytvorte si účet Cloudflare

Zaregistrujte sa na [cloudflare.com](https://cloudflare.com), ak ešte účet nemáte.

### 2. Vytvorte tunel v službe Zero Trust

1. Prejdite na [Cloudflare Zero Trust](https://one.dash.cloudflare.com/)
2. Prejdite do sekcie **Networks** → **Tunnels**
3. Kliknite na **Create a tunnel**
4. Ako konektor vyberte **Cloudflared**
5. Pomenujte tunel (napr. e.g., `termbridge`)
6. Skopírujte token tunela

### 3. Pridajte verejný názov hostiteľa

1. V nastaveniach tunela prejdite na **Public Hostname**
2. Pridajte názov hostiteľa, ktorý smeruje na `http://localhost:8080` (alebo na zvolený port)
3. Použite subdoménu, napríklad `term.example.com`

### 4. Spustite Termbridge pomocou tokenu

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

Alebo použite premenné prostredia:

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

termbridge --port 8080
```

> **Poznámka**
> Pri pomenovaných tuneloch je príznak `--port` povinný, pretože názov hostiteľa je nastavený tak, aby smeroval na konkrétny port.


## Možnosti konfigurácie

| Príznak | Premenná prostredia | Opis |
|------|---------------------|-------------|
| `--port <port>` | - | Lokálny port (povinný pri pomenovaných tuneloch) |
| `--tunnel-token <token>` | `TERMBRIDGE_TUNNEL_TOKEN` | Token vášho tunela |
| `--tunnel-url <url>` | `TERMBRIDGE_TUNNEL_URL` | Váš verejný názov hostiteľa URL |

## Úplné vypnutie tunela

Ak máte vlastný reverzný proxy server alebo verejný URL:

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

Alebo:

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

termbridge
```

Termbridge preskočí spustenie tunela a použije zadaný URL pre kód QR.

## Riešenie problémov

### „429 Too Many Requests“

Znamená to, že rýchle tunely podliehajú obmedzeniam počtu požiadaviek. Riešenia:

1. Počkajte niekoľko minút a skúste to znova
2. Ukončite všetky zastarané procesy `cloudflared`: `pkill cloudflared`
3. Prejdite na pomenovaný tunel (odporúčané)

### Tunel sa spustí, ale URL nefunguje

- Overte, či sa názov hostiteľa v Cloudflare zhoduje s `--tunnel-url`
- Skontrolujte, či sa port v Cloudflare zhoduje s `--port`
- Uistite sa, že cloudflared je aktuálny: `cloudflared update`

### Pomenovaný tunel sa nepripojí

- Overte, či je váš token správny
- Skontrolujte, či sa na nástenke Cloudflare Zero Trust nezobrazujú chyby
- Skúste spustiť `cloudflared tunnel run <TOKEN>` priamo a pozrite si chybové hlásenia