# Nosauktie tuneļi

Pēc noklusējuma Termbridge izmanto Cloudflare kontam nepiesaistītos ātros tuneļus (`trycloudflare.com`). Tie ir ērti, taču intensīvas lietošanas gadījumā var tikt piemēroti ātruma ierobežojumi.

Ja bieži izmantojat Termbridge, izveidojiet nosauktu tuneli ar savu Cloudflare kontu.

## Kāpēc izmantot nosauktu tuneli?

- **Nav ātruma ierobežojumu**: intensīvas lietošanas gadījumā ātrie tuneļi var atgriezt 429 kļūdas
- **Stabils URL**: nejaušu virkņu vietā iegūstiet stabilu apakšdomēnu
- **Pielāgots domēns**: izmantojiet savu domēnu, piemēram, `term.example.com`
- **Uzticamāka darbība**: nosauktie tuneļi ir stabilāki ilgām sesijām

## Iestatīšana

### 1. Izveidojiet Cloudflare kontu

Ja jums tāda vēl nav, reģistrējieties šeit: [cloudflare.com](https://cloudflare.com).

### 2. Izveidojiet tuneli Zero Trust

1. Atveriet [Cloudflare Zero Trust](https://one.dash.cloudflare.com/)
2. Atveriet **Networks** → **Tunnels**
3. Noklikšķiniet uz **Create a tunnel**
4. Kā savienotāju izvēlieties **Cloudflared**
5. Piešķiriet tunelim nosaukumu (piemēram, e.g., `termbridge`)
6. Nokopējiet tuneļa pilnvaru

### 3. Pievienojiet publisku resursdatora nosaukumu

1. Tuneļa iestatījumos atveriet **Public Hostname**
2. Pievienojiet resursdatora nosaukumu, kas norāda uz `http://localhost:8080` (vai jūsu izvēlēto portu)
3. Izmantojiet apakšdomēnu, piemēram, `term.example.com`

### 4. Palaidiet Termbridge ar savu pilnvaru

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

Vai izmantojiet vides mainīgos:

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

termbridge --port 8080
```

> **Piezīme**
> Nosauktajiem tuneļiem nepieciešams karodziņš `--port`, jo resursdatora nosaukums ir konfigurēts konkrētam portam.


## Konfigurācijas opcijas

| Karodziņš | Vides mainīgais | Apraksts |
|------|---------------------|-------------|
| `--port <port>` | - | Lokālais ports (nepieciešams nosauktajiem tuneļiem) |
| `--tunnel-token <token>` | `TERMBRIDGE_TUNNEL_TOKEN` | Jūsu tuneļa pilnvara |
| `--tunnel-url <url>` | `TERMBRIDGE_TUNNEL_URL` | Jūsu publiskais resursdatora nosaukums URL |

## Tuneļa pilnīga atspējošana

Ja jums ir savs reversais starpniekserveris vai publiskais URL:

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

Vai:

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

termbridge
```

Termbridge izlaidīs tuneļa palaišanu un izmantos jūsu norādīto URL kodam QR.

## Problēmu novēršana

### "429 Pārāk daudz pieprasījumu"

Tas nozīmē, ka ātrajiem tuneļiem ir noteikti ātruma ierobežojumi. Risinājumi:

1. Uzgaidiet dažas minūtes un mēģiniet vēlreiz
2. Pārtrauciet visus novecojušos `cloudflared` procesus: `pkill cloudflared`
3. Pārslēdzieties uz nosauktu tuneli (ieteicams)

### Tunelis tiek palaists, bet URL nedarbojas

- Pārbaudiet, vai resursdatora nosaukums Cloudflare atbilst `--tunnel-url`
- Pārbaudiet, vai ports Cloudflare atbilst `--port`
- Pārliecinieties, ka cloudflared ir atjaunināts: `cloudflared update`

### Neizdodas izveidot savienojumu ar nosaukto tuneli

- Pārbaudiet, vai pilnvara ir pareiza
- Pārbaudiet, vai Cloudflare Zero Trust informācijas panelī nav kļūdu
- Mēģiniet palaist `cloudflared tunnel run <TOKEN>` tieši, lai redzētu kļūdu ziņojumus