Перейти до вмісту

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

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

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

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

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

  • Без обмежень частоти запитів: за інтенсивного використання Quick Tunnels можуть повертати помилки 429
  • Стабільний URL: отримайте незмінний субдомен замість випадкових рядків
  • Власний домен: використовуйте власний домен, наприклад term.example.com
  • Вища надійність: іменовані тунелі стабільніші під час тривалих сеансів

Налаштування

1. Створіть обліковий запис Cloudflare

Зареєструйтеся на cloudflare.com, якщо ще не маєте облікового запису.

2. Створіть тунель у Zero Trust

  1. Перейдіть на Cloudflare Zero Trust
  2. Відкрийте Мережі → Тунелі
  3. Натисніть Створити тунель
  4. Виберіть Cloudflared як з’єднувач
  5. Назвіть тунель (наприклад, e.g, termbridge)
  6. Скопіюйте токен тунелю

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

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

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

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

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

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

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

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