# Elnevezett alagutak

Alapértelmezés szerint a Termbridge a Cloudflare fiók nélküli Quick Tunneljeit (`trycloudflare.com`) használja. Ezek kényelmesek, de intenzív használat esetén sebességkorlátozás alá eshetnek.

Ha gyakran használja a Termbridge-t, állítson be elnevezett alagutat a Cloudflare-fiókjával.

## Miért érdemes elnevezett alagutat használni?

- **Nincsenek sebességkorlátozások**: intenzív használat esetén a Quick Tunnel 429 hibákat adhat vissza
- **Kiszámítható URL**: véletlenszerű karakterláncok helyett állandó aldomaint kap
- **Egyéni domain**: használja saját domainjét, például `term.example.com`
- **Nagyobb megbízhatóság**: az elnevezett alagutak stabilabbak hosszú munkamenetekhez

## Beállítás

### 1. Hozzon létre egy Cloudflare-fiókot

Regisztráljon itt: [cloudflare.com](https://cloudflare.com), ha még nincs fiókja.

### 2. Hozzon létre alagutat a Zero Trustban

1. Lépjen ide: [Cloudflare Zero Trust](https://one.dash.cloudflare.com/)
2. Navigáljon a **Networks** → **Tunnels** menüpontra
3. Kattintson a **Create a tunnel** lehetőségre
4. Csatlakozóként válassza a **Cloudflared** lehetőséget
5. Nevezze el az alagutat (e.g. `termbridge`)
6. Másolja ki az alagút tokenjét

### 3. Adjon hozzá nyilvános állomásnevet

1. A tunnel beállításaiban lépjen a **Public Hostname** részhez
2. Adjon meg egy gazdagépnevet, amely erre mutat: `http://localhost:8080` (vagy az Ön által választott portra)
3. Használjon ilyen aldomaint: `term.example.com`

### 4. Futtassa a Termbridge-t a tokenjével

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

Vagy használjon környezeti változókat:

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

termbridge --port 8080
```

> **Megjegyzés**
> Az elnevezett alagutakhoz szükség van a `--port` kapcsolóra, mert az állomásnév egy adott portra van beállítva.


## Konfigurációs lehetőségek

| Kapcsoló | Környezeti változó | Leírás |
|------|---------------------|-------------|
| `--port <port>` | - | Helyi port (elnevezett alagutakhoz kötelező) |
| `--tunnel-token <token>` | `TERMBRIDGE_TUNNEL_TOKEN` | Az alagút tokenje |
| `--tunnel-url <url>` | `TERMBRIDGE_TUNNEL_URL` | Nyilvános állomásnév: URL |

## Az alagút teljes kikapcsolása

Ha saját fordított proxyval vagy nyilvános URL-vel rendelkezik:

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

Vagy:

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

termbridge
```

A Termbridge kihagyja az alagút indítását, és az Ön által megadott URL értéket használja a QR kódhoz.

## Hibaelhárítás

### „429 Too Many Requests”

Ez azt jelenti, hogy a Quick Tunnel sebességkorlátozás alá esik. Megoldások:

1. Várjon néhány percet, majd próbálja újra
2. Állítsa le az összes elavult `cloudflared`-folyamatot: `pkill cloudflared`
3. Váltson elnevezett alagútra (ajánlott)

### Elindul az alagút, de a URL nem működik

- Ellenőrizze, hogy a Cloudflare-ban szereplő állomásnév megegyezik-e ezzel: `--tunnel-url`
- Ellenőrizze, hogy a Cloudflare-ben megadott port megegyezik-e ezzel: `--port`
- Győződjön meg róla, hogy a cloudflared naprakész: `cloudflared update`

### Nem sikerül csatlakozni az elnevezett alagúthoz

- Ellenőrizze, hogy helyes-e a token
- Ellenőrizze, vannak-e hibák a Cloudflare Zero Trust vezérlőpultján
- Futtassa közvetlenül a `cloudflared tunnel run <TOKEN>`-t a hibaüzenetek megtekintéséhez