# Pojmenované tunely

Ve výchozím nastavení používá Termbridge rychlé tunely Cloudflare bez účtu (`trycloudflare.com`). Jsou praktické, ale při intenzivním používání mohou podléhat limitům požadavků.

Pokud Termbridge používáte často, nastavte si pojmenovaný tunel pomocí účtu Cloudflare.

## Proč používat pojmenovaný tunel?

- **Bez limitů požadavků**: Rychlé tunely mohou při intenzivním používání vracet chyby 429
- **Stálé URL**: Získejte stabilní subdoménu místo náhodných řetězců
- **Vlastní doména**: Použijte vlastní doménu, například `term.example.com`
- **Vyšší spolehlivost**: Pojmenované tunely jsou stabilnější při dlouhých relacích

## Nastavení

### 1. Vytvoření účtu Cloudflare

Pokud účet ještě nemáte, zaregistrujte se na [cloudflare.com](https://cloudflare.com)

### 2. Vytvoření tunelu v Zero Trust

1. Přejděte na [Cloudflare Zero Trust](https://one.dash.cloudflare.com/)
2. Přejděte na **Networks** → **Tunnels**
3. Klikněte na **Create a tunnel**
4. Jako konektor vyberte **Cloudflared**
5. Pojmenujte tunel (e.g., `termbridge`)
6. Zkopírujte token tunelu

### 3. Přidání veřejného názvu hostitele

1. V nastavení tunelu přejděte na **Public Hostname**
2. Přidejte název hostitele, který odkazuje na `http://localhost:8080` (nebo na zvolený port)
3. Použijte subdoménu, například `term.example.com`

### 4. Spuštění Termbridge s tokenem

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

Nebo použijte proměnné prostředí:

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

termbridge --port 8080
```

> **Poznámka**
> Při použití pojmenovaných tunelů je příznak `--port` povinný, protože název hostitele je nastaven tak, aby odkazoval na konkrétní port.


## Možnosti konfigurace

| Příznak | Proměnná prostředí | Popis |
|------|---------------------|-------------|
| `--port <port>` | - | Místní port (povinný u pojmenovaných tunelů) |
| `--tunnel-token <token>` | `TERMBRIDGE_TUNNEL_TOKEN` | Token vašeho tunelu |
| `--tunnel-url <url>` | `TERMBRIDGE_TUNNEL_URL` | Váš veřejný název hostitele URL |

## Úplné vypnutí tunelu

Pokud máte vlastní reverzní proxy nebo veřejné URL:

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

Nebo:

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

termbridge
```

Termbridge přeskočí spuštění tunelu a pro kód QR použije zadané URL.

## Řešení problémů

### „429 Too Many Requests“

To znamená, že rychlé tunely podléhají limitům požadavků. Řešení:

1. Počkejte několik minut a zkuste to znovu
2. Ukončete všechny zastaralé procesy `cloudflared`: `pkill cloudflared`
3. Přejděte na pojmenovaný tunel (doporučeno)

### Tunel se spustí, ale URL nefunguje

- Ověřte, že název hostitele v Cloudflare odpovídá `--tunnel-url`
- Zkontrolujte, zda port v Cloudflare odpovídá `--port`
- Ujistěte se, že cloudflared je aktuální: `cloudflared update`

### Pojmenovaný tunel se nepřipojí

- Ověřte, že je váš token správný
- Zkontrolujte, zda se na řídicím panelu Cloudflare Zero Trust nezobrazují chyby
- Zkuste spustit `cloudflared tunnel run <TOKEN>` přímo a podívejte se na chybová hlášení