feat: add Ngrok tunnel provider (#1415)

Adds Ngrok quick tunnel support Adds desktop tunnel docs across locales Improves tunnel settings provider and TTL labels
2026-05-25 18:00:03 +03:00
parent 25ed8e6abb
commit 00a7807168
22 changed files with 893 additions and 28 deletions
@@ -0,0 +1,41 @@
+---
+title: Десктопні тунелі
+description: Створюйте Cloudflare або Ngrok тунелі з десктопного застосунку.
+---
+
+# Десктопні тунелі
+
+Десктопний застосунок може створити публічний тунель через **Settings → OpenChamber → Tunnel**. Для цього не потрібно запускати OpenChamber через CLI.
+
+## Встановіть провайдера
+
+OpenChamber запускає CLI провайдера на вашій машині. Спочатку встановіть провайдера, який хочете використовувати:
+
+```bash
+brew install cloudflared
+brew install ngrok
+```
+
+Cloudflare використовує `cloudflared`. Для Ngrok потрібен акаунт ngrok і authtoken з dashboard ngrok:
+
+```bash
+ngrok config add-authtoken <your-ngrok-token>
+```
+
+## Запуск із застосунку
+
+1. Відкрийте **Settings → OpenChamber → Tunnel**.
+2. Виберіть **Cloudflare** або **Ngrok**.
+3. Запустіть quick tunnel.
+4. Відскануйте згенерований QR-код з телефона.
+
+Ngrok зараз підтримує quick tunnels. Cloudflare підтримує quick tunnels і керовані режими Cloudflare.
+
+## Захист доступу
+
+Навіть якщо URL провайдера публічний, OpenChamber все одно захищає доступ власним connect token. Згенероване посилання містить одноразовий token, має TTL, а старі невикористані посилання відкликаються, коли ви генеруєте нове або зупиняєте/перезапускаєте тунель.
+
+## Пов'язане
+
+- [Тунелі](/uk/tunnels/) — використання тунелів через CLI і керовані режими Cloudflare
+- [PWA та мобільний доступ](/uk/mobile/) — відкривайте OpenChamber з телефона
@@ -7,7 +7,22 @@ description: Безпечно відкрийте OpenChamber для віддал

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

-## Швидкий старт (швидкий режим Cloudflare)
+## Передумови
+
+OpenChamber запускає CLI провайдера тунелю на вашій машині. Спочатку встановіть провайдера, який хочете використовувати:
+
+```bash
+brew install cloudflared
+brew install ngrok
+```
+
+Швидкі тунелі Cloudflare працюють через `cloudflared`. Для Ngrok потрібен акаунт ngrok і authtoken з dashboard ngrok:
+
+```bash
+ngrok config add-authtoken <your-ngrok-token>
+```
+
+## Швидкий старт

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

@@ -15,12 +30,18 @@ description: Безпечно відкрийте OpenChamber для віддал
 openchamber
 ```

-2. Запустіть тунель:
+2. Запустіть тунель Cloudflare:

 ```bash
 openchamber tunnel start --provider cloudflare --mode quick
 ```

+Або запустіть тунель Ngrok:
+
+```bash
+openchamber tunnel start --provider ngrok --mode quick
+```
+
 3. Перевірте статус:

 ```bash
@@ -31,6 +52,11 @@ openchamber tunnel status

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

+## Провайдери
+
+- `cloudflare`: quick, managed remote і managed local режими
+- `ngrok`: quick режим
+
 ## Керовані режими

 ### Кероване віддалене
@@ -68,7 +94,9 @@ openchamber tunnel start --profile prod-main
 ```bash
 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
 ```

@@ -81,5 +109,6 @@ openchamber tunnel stop --port 3000
 ## Пов'язане

 - [Безпека](/uk/security/) — захистіть інтерфейс перед відкриттям доступу
+- [Десктопні тунелі](/uk/desktop-tunnels/) — налаштування тунелю в десктопному застосунку без CLI-старту
 - [PWA та мобільний доступ](/uk/mobile/) — відкривайте OpenChamber з телефона
 - [Усунення несправностей](/uk/troubleshooting/) — якщо посилання тунелю не працює