---
title: 터널
description: 원격 및 모바일 접근을 위해 OpenChamber를 안전하게 공개하세요.
---

# 터널

터널은 OpenChamber로 연결되는 공개 링크로, 휴대폰이나 다른 네트워크에서 접근할 수 있게 해줍니다. 실행 중인 인스턴스에 터널을 만들려면 `openchamber tunnel`을 사용하세요.

## 사전 요구 사항

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를 시작합니다:

```bash
openchamber
```

이 단계를 건너뛰면 `openchamber tunnel start`가 CLI 서버를 자동으로 시작할 수 있습니다. 자동 시작 시 `--port`, `--host`, `--lan`, `--ui-password`, `--api-only` 같은 서버 옵션을 함께 전달할 수 있습니다.

2. Cloudflare 터널을 시작합니다:

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

또는 Ngrok 터널을 시작합니다:

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

3. 상태를 확인합니다:

```bash
openchamber tunnel status
```

터널이 올라오면 `status`에 공개 URL이 표시됩니다. 그 URL을 열거나 QR 코드를 스캔하면 어디서든 OpenChamber에 접근할 수 있습니다.

기본적으로 OpenChamber는 대화형 TTY 세션에서 QR 코드를 출력합니다. `--qr`로 QR 출력을 강제하거나 `--no-qr`로 비활성화하세요.

## 공급자

- `cloudflare`: quick, managed remote, managed local 모드
- `ngrok`: quick 모드

## 관리형 모드

### 관리형 원격

Cloudflare가 관리하는 토큰 + 호스트네임을 사용합니다:

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

### 관리형 로컬

로컬 `cloudflared` 구성을 사용합니다:

```bash
openchamber tunnel start --provider cloudflare --mode managed-local --config ~/.cloudflared/config.yml
```

## 프로필 (managed-remote)

재사용 가능한 프로필을 저장합니다:

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

저장된 프로필로 시작합니다:

```bash
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
```

## 동작 참고 사항

- OpenChamber 인스턴스(포트)당 활성 터널은 하나입니다
- 같은 인스턴스에서 새 모드/공급자를 시작하면 이전 터널이 대체됩니다
- 새 연결 링크를 생성하면 사용되지 않은 이전 링크가 무효화됩니다
- 터널 자동 시작은 재시작/업데이트 흐름에서 쓰는 인스턴스 설정에 `--ui-password`, `--api-only` 같은 서버 플래그를 저장합니다

## 관련 문서

- [보안](/ko/security/) — 외부에 공개하기 전에 UI를 보호하세요
- [데스크톱 터널](/ko/desktop-tunnels/) — CLI 시작 없이 데스크톱 앱에서 터널 설정
- [PWA 및 모바일 접속](/ko/mobile/) — 휴대폰에서 OpenChamber에 접속하세요
- [문제 해결](/ko/troubleshooting/) — 터널 링크가 작동하지 않을 때
