# Nazwane tunele

Domyślnie Termbridge korzysta z szybkich tuneli Quick Tunnels Cloudflare, które nie wymagają konta (`trycloudflare.com`). Są wygodne, ale przy intensywnym użyciu mogą obowiązywać limity żądań.

Jeśli często korzystasz z Termbridge, skonfiguruj nazwany tunel na swoim koncie Cloudflare.

## Dlaczego warto używać nazwanego tunelu?

- **Brak limitów żądań**: Przy intensywnym użyciu Quick Tunnels mogą zwracać błędy 429
- **Stały adres URL**: Uzyskaj stabilną subdomenę zamiast losowego ciągu znaków
- **Własna domena**: Użyj własnej domeny, takiej jak `term.example.com`
- **Większa niezawodność**: Nazwane tunele są stabilniejsze podczas długich sesji

## Konfiguracja

### 1. Utwórz konto Cloudflare

Zarejestruj się na [cloudflare.com](https://cloudflare.com), jeśli nie masz jeszcze konta.

### 2. Utwórz tunel w Zero Trust

1. Przejdź do [Cloudflare Zero Trust](https://one.dash.cloudflare.com/)
2. Przejdź do **Networks** → **Tunnels**
3. Kliknij **Create a tunnel**
4. Wybierz **Cloudflared** jako łącznik
5. Nadaj nazwę tunelowi (np. e.g., `termbridge`)
6. Skopiuj token tunelu

### 3. Dodaj publiczną nazwę hosta

1. W ustawieniach tunelu przejdź do **Public Hostname**
2. Dodaj nazwę hosta kierującą do `http://localhost:8080` (lub wybranego portu)
3. Użyj subdomeny, takiej jak `term.example.com`

### 4. Uruchom Termbridge z tokenem

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

Możesz też użyć zmiennych środowiskowych:

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

termbridge --port 8080
```

> **Uwaga**
> Flaga `--port` jest wymagana w przypadku nazwanych tuneli, ponieważ nazwa hosta jest skonfigurowana dla konkretnego portu.


## Opcje konfiguracji

| Flaga | Zmienna środowiskowa | Opis |
|------|---------------------|-------------|
| `--port <port>` | - | Lokalny port (wymagany dla nazwanych tuneli) |
| `--tunnel-token <token>` | `TERMBRIDGE_TUNNEL_TOKEN` | Token tunelu |
| `--tunnel-url <url>` | `TERMBRIDGE_TUNNEL_URL` | Publiczna nazwa hosta URL |

## Całkowite wyłączenie tunelu

Jeśli masz własny reverse proxy lub publiczny adres URL:

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

Lub:

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

termbridge
```

Termbridge pominie uruchamianie tunelu i użyje podanego URL dla kodu QR.

## Rozwiązywanie problemów

### „429 Too Many Requests”

Oznacza to, że obowiązują limity żądań dla Quick Tunnels. Możliwe rozwiązania:

1. Odczekaj kilka minut i spróbuj ponownie
2. Zakończ wszystkie nieaktualne procesy `cloudflared`: `pkill cloudflared`
3. Przełącz się na nazwany tunel (zalecane)

### Tunel się uruchamia, ale URL nie działa

- Sprawdź, czy nazwa hosta w Cloudflare jest zgodna z `--tunnel-url`
- Sprawdź, czy port w Cloudflare jest zgodny z `--port`
- Upewnij się, że cloudflared jest aktualne: `cloudflared update`

### Nie można połączyć się z nazwanym tunelem

- Sprawdź, czy token jest prawidłowy
- Sprawdź, czy na pulpicie nawigacyjnym Cloudflare Zero Trust są błędy
- Uruchom bezpośrednio `cloudflared tunnel run <TOKEN>`, aby zobaczyć komunikaty o błędach