# Nimetyt tunnelit

Oletusarvoisesti Termbridge käyttää Cloudflare-palvelun tiliä vaatimattomia Quick Tunnels -tunneleita (`trycloudflare.com`). Ne ovat käteviä, mutta runsas käyttö voi johtaa nopeusrajoituksiin.

Jos käytät Termbridge-ohjelmaa usein, määritä nimetty tunneli Cloudflare-tililläsi.

## Miksi käyttää nimettyä tunnelia?

- **Ei nopeusrajoituksia**: Quick Tunnels voi aiheuttaa 429-virheitä runsaan käytön yhteydessä
- **Yhtenäinen URL**: Saat pysyvän aliverkkotunnuksen satunnaisen merkkijonon sijaan
- **Oma verkkotunnus**: Käytä omaa verkkotunnustasi, kuten `term.example.com`
- **Parempi luotettavuus**: Nimetyt tunnelit toimivat vakaammin pitkissä istunnoissa

## Määritys

### 1. Luo Cloudflare-tili

Rekisteröidy osoitteessa [cloudflare.com](https://cloudflare.com), jos sinulla ei vielä ole tiliä.

### 2. Luo tunneli Zero Trustissa

1. Siirry osoitteeseen [Cloudflare Zero Trust](https://one.dash.cloudflare.com/)
2. Siirry kohtaan **Networks** → **Tunnels**
3. Napsauta **Create a tunnel**
4. Valitse yhdistäjäksi **Cloudflared**
5. Anna tunnelille nimi (e.g., `termbridge`)
6. Kopioi tunnelin tunniste

### 3. Lisää julkinen isäntänimi

1. Siirry tunnelin asetuksissa kohtaan **Public Hostname**
2. Lisää isäntänimi, joka osoittaa kohteeseen `http://localhost:8080` (tai valitsemaasi porttiin)
3. Käytä aliverkkotunnusta, kuten `term.example.com`

### 4. Suorita Termbridge tunnisteellasi

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

Tai käytä ympäristömuuttujia:

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

termbridge --port 8080
```

> **Huomautus**
> `--port`-valitsin on pakollinen nimettyjen tunnelien yhteydessä, sillä isäntänimi on määritetty osoittamaan tiettyyn porttiin.


## Asetusvaihtoehdot

| Valitsin | Ympäristömuuttuja | Kuvaus |
|------|---------------------|-------------|
| `--port <port>` | - | Paikallinen portti (pakollinen nimetyille tunneleille) |
| `--tunnel-token <token>` | `TERMBRIDGE_TUNNEL_TOKEN` | Tunnelin tunniste |
| `--tunnel-url <url>` | `TERMBRIDGE_TUNNEL_URL` | Julkinen isäntänimesi URL |

## Tunnelin poistaminen käytöstä

Jos käytössäsi on oma käänteinen välityspalvelin tai julkinen URL:

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

Tai:

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

termbridge
```

Termbridge ohittaa tunnelin käynnistämisen ja käyttää antamaasi URL-arvoa QR-koodia varten.

## Vianmääritys

### "429 Liian monta pyyntöä"

Tämä tarkoittaa, että Quick Tunnels -tunneleihin sovelletaan nopeusrajoituksia. Ratkaisut:

1. Odota muutama minuutti ja yritä uudelleen
2. Lopeta kaikki vanhat `cloudflared`-prosessit: `pkill cloudflared`
3. Siirry käyttämään nimettyä tunnelia (suositeltavaa)

### Tunneli käynnistyy, mutta URL ei toimi

- Varmista, että kohteen Cloudflare isäntänimi vastaa kohteen `--tunnel-url` isäntänimeä
- Tarkista, että kohteen Cloudflare portti vastaa kohteen `--port` porttia
- Varmista, että cloudflared on ajan tasalla: `cloudflared update`

### Nimetty tunneli ei muodosta yhteyttä

- Varmista, että tunniste on oikea
- Tarkista, näkyykö Cloudflare Zero Trust-hallintapaneelissa virheitä
- Kokeile suorittaa `cloudflared tunnel run <TOKEN>` suoraan nähdäksesi virheilmoitukset