feat: add Ngrok tunnel provider (#1415)

Adds Ngrok quick tunnel support
Adds desktop tunnel docs across locales
Improves tunnel settings provider and TTL labels
This commit is contained in:
Bohdan Triapitsyn
2026-05-25 18:00:03 +03:00
committed by GitHub
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 계정과 ngrok 대시보드의 authtoken이 필요합니다:
```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이 있으며, 새 링크를 만들거나 터널을 중지/재시작하면 이전의 사용되지 않은 링크는 무효화됩니다.
## 관련 문서
- [터널](/ko/tunnels/) — CLI 터널 사용법과 Cloudflare 관리형 모드
- [PWA 및 모바일 접속](/ko/mobile/) — 휴대폰에서 OpenChamber에 접속하세요
+31 -2
View File
@@ -7,7 +7,22 @@ description: 원격 및 모바일 접근을 위해 OpenChamber를 안전하게
터널은 OpenChamber로 연결되는 공개 링크로, 휴대폰이나 다른 네트워크에서 접근할 수 있게 해줍니다. 실행 중인 인스턴스에 터널을 만들려면 `openchamber tunnel`을 사용하세요.
## 빠른 시작 (Cloudflare 빠른 모드)
## 사전 요구 사항
OpenChamber는 사용자의 컴퓨터에서 터널 공급자 CLI를 실행합니다. 먼저 사용할 공급자를 설치하세요:
```bash
brew install cloudflared
brew install ngrok
```
Cloudflare 빠른 터널은 `cloudflared`로 실행할 수 있습니다. Ngrok은 ngrok 계정과 ngrok 대시보드의 authtoken이 필요합니다:
```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는 대화형 TTY 세션에서 QR 코드를 출력합니다. `--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
## 관련 문서
- [보안](/ko/security/) — 외부에 공개하기 전에 UI를 보호하세요
- [데스크톱 터널](/ko/desktop-tunnels/) — CLI 시작 없이 데스크톱 앱에서 터널 설정
- [PWA 및 모바일 접속](/ko/mobile/) — 휴대폰에서 OpenChamber에 접속하세요
- [문제 해결](/ko/troubleshooting/) — 터널 링크가 작동하지 않을 때