Към съдържанието

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

Преглед като Markdown Редактиране в GitHub Документация за 1675df8

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

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

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

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

Настройка

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

Регистрирайте се в cloudflare.com, ако нямате акаунт.

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

  1. Отидете на Cloudflare Zero Trust
  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 с токена си

Обвивка
termbridge --port 8080 --tunnel-token <TOKEN> --tunnel-url https://term.example.com

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

Обвивка
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:

Обвивка
termbridge --no-tunnel --public-url https://your-server.com

Или:

Обвивка
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> директно, за да видите съобщенията за грешки