# Наименувани тунели

По подразбиране Termbridge използва бързите тунели на Cloudflare без акаунт (`trycloudflare.com`). Те са удобни, но при интензивна употреба може да бъдат ограничени по честота.

Ако използвате Termbridge често, настройте наименуван тунел с акаунта си в Cloudflare.

## Защо да използвате наименуван тунел?

- **Без ограничения на честотата**: При интензивна употреба бързите тунели могат да върнат грешки 429
- **Постоянен URL**: Получавате стабилен поддомейн вместо произволни низове
- **Персонализиран домейн**: Използвайте свой домейн, например `term.example.com`
- **По-голяма надеждност**: Наименуваните тунели са по-стабилни при дълги сесии

## Настройка

### 1. Създайте акаунт в Cloudflare

Регистрирайте се в [cloudflare.com](https://cloudflare.com), ако нямате акаунт.

### 2. Създайте тунел в Zero Trust

1. Отидете на [Cloudflare Zero Trust](https://one.dash.cloudflare.com/)
2. Отворете **Networks** → **Tunnels**
3. Щракнете върху **Create a tunnel**
4. Изберете **Cloudflared** като конектор
5. Въведете име на тунела (e.g., `termbridge`)
6. Копирайте токена на тунела

### 3. Добавете публично име на хост

1. В настройките на тунела отворете **Public Hostname**
2. Добавете име на хост, което сочи към `http://localhost:8080` (или към избрания от вас порт)
3. Използвайте поддомейн, например `term.example.com`

### 4. Стартирайте Termbridge с токена си

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

Или използвайте променливи на средата:

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

termbridge --port 8080
```

> **Забележка**
> Флагът `--port` е задължителен за наименуваните тунели, защото името на хоста е настроено да сочи към конкретен порт.


## Опции за конфигурация

| Флаг | Променлива на средата | Описание |
|------|---------------------|-------------|
| `--port <port>` | - | Локален порт (задължителен за наименувани тунели) |
| `--tunnel-token <token>` | `TERMBRIDGE_TUNNEL_TOKEN` | Токенът на тунела ви |
| `--tunnel-url <url>` | `TERMBRIDGE_TUNNEL_URL` | Публичното ви име на хост URL |

## Пълно изключване на тунела

Ако имате собствен обратен прокси или публичен URL:

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

Или:

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

termbridge
```

Termbridge ще пропусне стартирането на тунел и ще използва предоставения от вас URL за кода QR.

## Отстраняване на проблеми

### „429 Твърде много заявки“

Това означава, че бързите тунели са с ограничение на честотата. Решения:

1. Изчакайте няколко минути и опитайте отново
2. Спрете всички остарели процеси на `cloudflared`: `pkill cloudflared`
3. Преминете към наименуван тунел (препоръчително)

### Тунелът стартира, но URL не работи

- Проверете дали името на хоста в Cloudflare съвпада с `--tunnel-url`
- Проверете дали портът в Cloudflare съвпада с `--port`
- Уверете се, че cloudflared е актуален: `cloudflared update`

### Наименуваният тунел не се свързва

- Проверете дали токенът е правилен
- Проверете таблото на Cloudflare Zero Trust за грешки
- Опитайте да стартирате `cloudflared tunnel run <TOKEN>` директно, за да видите съобщенията за грешки