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

Тунелі

Тунель — це публічне посилання на ваш OpenChamber, щоб дістатися до нього зі звичайного браузера в іншій мережі. Скористайтеся openchamber tunnel, щоб створити його для запущеного інстансу.

Для підключення власних пристроїв (мобільного застосунку, іншого десктопа) тунель зазвичай не потрібен — краще зв’яжіть їх і дозвольте наскрізно зашифрованому Private Relay забезпечити доступ поза домом без жодних налаштувань.

Передумови

OpenChamber запускає CLI провайдера тунелю на вашій машині. Спочатку встановіть провайдера, який хочете використовувати:

Terminal window
brew install cloudflared
brew install ngrok

Швидкі тунелі Cloudflare працюють через cloudflared. Для Ngrok потрібен акаунт ngrok і authtoken з dashboard ngrok:

Terminal window
ngrok config add-authtoken <your-ngrok-token>

Швидкий старт

  1. Запустіть OpenChamber:
Terminal window
openchamber

Якщо пропустити цей крок, openchamber tunnel start може автоматично запустити CLI server. Під час auto-start можна передати server options: --port, --host, --lan, --ui-password і --api-only.

  1. Запустіть тунель Cloudflare:
Terminal window
openchamber tunnel start --provider cloudflare --mode quick

Або запустіть тунель Ngrok:

Terminal window
openchamber tunnel start --provider ngrok --mode quick
  1. Перевірте статус:
Terminal window
openchamber tunnel status

Коли тунель піднято, status показує публічний URL. Відкрийте його або відскануйте QR-код, щоб дістатися до OpenChamber звідусіль.

Типово OpenChamber виводить QR-код в інтерактивних TTY-сесіях. Використовуйте --qr, щоб примусово вивести QR, або --no-qr, щоб вимкнути його.

Провайдери

  • cloudflare: quick, managed remote і managed local режими
  • ngrok: quick режим

Керовані режими

Кероване віддалене

Використовуйте токен + хостнейм, керовані Cloudflare:

Terminal window
openchamber tunnel start --provider cloudflare --mode managed-remote --token-file ~/.secrets/cf-token --hostname app.example.com

Кероване локальне

Використовуйте локальний конфіг cloudflared:

Terminal window
openchamber tunnel start --provider cloudflare --mode managed-local --config ~/.cloudflared/config.yml

Профілі (managed-remote)

Збережіть багаторазовий профіль:

Terminal window
openchamber tunnel profile add --provider cloudflare --mode managed-remote --name prod-main --hostname app.example.com --token-file ~/.secrets/cf-token

Запуск зі збереженим профілем:

Terminal window
openchamber tunnel start --profile prod-main

Корисні команди

Terminal window
openchamber tunnel providers
openchamber tunnel ready --provider cloudflare
openchamber tunnel ready --provider ngrok
openchamber tunnel doctor --provider cloudflare
openchamber tunnel doctor --provider ngrok
openchamber tunnel stop --port 3000

Нотатки щодо поведінки

  • один активний тунель на інстанс OpenChamber (порт)
  • запуск нового режиму/провайдера на тому самому інстансі замінює попередній тунель
  • генерація нового посилання для підключення відкликає попереднє невикористане
  • авто-старт тунелю зберігає серверні прапорці на кшталт --ui-password та --api-only у налаштуваннях інстансу, які використовуються під час рестарту/оновлення

Пов’язане