# Іменовані тунелі

За замовчуванням Termbridge використовує Quick Tunnels від Cloudflare без облікового запису (`trycloudflare.com`). Це зручно, але за інтенсивного використання можуть діяти обмеження частоти запитів.

Якщо ви часто користуєтеся Termbridge, налаштуйте іменований тунель в обліковому записі Cloudflare.

## Навіщо використовувати іменований тунель?

- **Без обмежень частоти запитів**: за інтенсивного використання Quick Tunnels можуть повертати помилки 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. Відкрийте **Мережі** → **Тунелі**
3. Натисніть **Створити тунель**
4. Виберіть **Cloudflared** як з’єднувач
5. Назвіть тунель (наприклад, e.g, `termbridge`)
6. Скопіюйте токен тунелю

### 3. Додайте публічне ім’я хоста

1. У налаштуваннях тунелю відкрийте **Публічне ім’я хоста**
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 Забагато запитів»

Це означає, що швидкість запитів через Quick Tunnels обмежена. Варіанти вирішення:

1. Зачекайте кілька хвилин і спробуйте знову
2. Завершіть застарілі процеси `cloudflared`: `pkill cloudflared`
3. Перейдіть на іменований тунель (рекомендовано)

### Тунель запускається, але URL не працює

- Переконайтеся, що ім’я хоста в Cloudflare відповідає `--tunnel-url`
- Перевірте, що порт у Cloudflare відповідає `--port`
- Переконайтеся, що cloudflared актуальний: `cloudflared update`

### Не вдається підключитися до іменованого тунелю

- Переконайтеся, що токен правильний
- Перевірте, чи немає помилок на панелі керування Cloudflare Zero Trust
- Спробуйте запустити `cloudflared tunnel run <TOKEN>` безпосередньо, щоб побачити повідомлення про помилки