# Pavadinti tuneliai

Pagal numatytuosius nustatymus Termbridge naudoja paskyros nereikalaujančius Cloudflare sparčiuosius tunelius (`trycloudflare.com`). Jie patogūs, tačiau intensyviai naudojant gali būti taikomi užklausų dažnio apribojimai.

Jei dažnai naudojate Termbridge, nustatykite pavadintą tunelį savo Cloudflare paskyroje.

## Kodėl verta naudoti pavadintą tunelį?

- **Nėra užklausų dažnio apribojimų**: intensyviai naudojant sparčiuosius tunelius gali būti grąžinamos 429 klaidos
- **Nuoseklus URL**: gaukite pastovų padomenį, o ne atsitiktinę simbolių eilutę
- **Pasirinktinis domenas**: naudokite savo domeną, pvz., `term.example.com`
- **Didesnis patikimumas**: pavadinti tuneliai yra stabilesni ilgoms sesijoms

## Nustatymas

### 1. Sukurkite Cloudflare paskyrą

Jei paskyros neturite, užsiregistruokite adresu [cloudflare.com](https://cloudflare.com).

### 2. Sukurkite tunelį Zero Trust

1. Eikite į [Cloudflare Zero Trust](https://one.dash.cloudflare.com/)
2. Eikite į **Networks** → **Tunnels**
3. Spustelėkite **Create a tunnel**
4. Kaip jungtį pasirinkite **Cloudflared**
5. Pavadinkite tunelį (pvz., e.g, `termbridge`)
6. Nukopijuokite tunelio prieigos raktą

### 3. Pridėkite viešąjį pagrindinio kompiuterio vardą

1. Tunelio nustatymuose eikite į **Public Hostname**
2. Pridėkite pagrindinio kompiuterio vardą, nukreipiantį į `http://localhost:8080` (arba jūsų pasirinktą prievadą)
3. Naudokite padomenį, pvz., `term.example.com`

### 4. Paleiskite Termbridge su savo prieigos raktu

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

Arba naudokite aplinkos kintamuosius:

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

termbridge --port 8080
```

> **Pastaba**
> Pavadintiems tuneliams būtina nurodyti vėliavėlę `--port`, nes pagrindinio kompiuterio vardas sukonfigūruotas konkrečiam prievadui.


## Konfigūracijos parinktys

| Vėliavėlė | Aplinkos kintamasis | Aprašymas |
|------|---------------------|-------------|
| `--port <port>` | - | Vietinis prievadas (būtinas pavadintiems tuneliams) |
| `--tunnel-token <token>` | `TERMBRIDGE_TUNNEL_TOKEN` | Jūsų tunelio prieigos raktas |
| `--tunnel-url <url>` | `TERMBRIDGE_TUNNEL_URL` | Jūsų viešasis pagrindinio kompiuterio vardas URL |

## Visiškas tunelio išjungimas

Jei turite savo atvirkštinį tarpinį serverį arba viešąjį URL:

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

Arba:

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

termbridge
```

Termbridge praleis tunelio paleidimą ir naudos jūsų pateiktą URL QR kodui.

## Trikčių šalinimas

### „429 Too Many Requests“

Tai reiškia, kad sparčiųjų tunelių užklausų dažnis ribojamas. Galimi sprendimai:

1. Palaukite kelias minutes ir bandykite dar kartą
2. Nutraukite likusius `cloudflared` procesus: `pkill cloudflared`
3. Pereikite prie pavadinto tunelio (rekomenduojama)

### Tunelis paleidžiamas, bet URL neveikia

- Patikrinkite, ar pagrindinio kompiuterio vardas Cloudflare atitinka `--tunnel-url`
- Patikrinkite, ar prievadas Cloudflare atitinka `--port`
- Įsitikinkite, kad cloudflared yra naujausia: `cloudflared update`

### Nepavyksta prisijungti prie pavadinto tunelio

- Patikrinkite, ar jūsų prieigos raktas teisingas
- Patikrinkite, ar Cloudflare Zero Trust valdymo skydelyje nėra klaidų
- Paleiskite `cloudflared tunnel run <TOKEN>` tiesiogiai, kad pamatytumėte klaidų pranešimus