컨텐츠로 건너뛰기
OpenChamber

터널

터널은 OpenChamber로 연결되는 공개 링크로, 다른 네트워크의 일반 브라우저에서 접근할 수 있게 해줍니다. 실행 중인 인스턴스에 터널을 만들려면 openchamber tunnel을 사용하세요.

자신의 기기(모바일 앱, 다른 데스크톱)를 연결할 때는 보통 터널이 필요 없습니다. 대신 기기를 페어링하고, 설정이 전혀 필요 없는 종단 간 암호화 Private Relay에 집 밖 접속을 맡기세요.

사전 요구 사항

OpenChamber는 사용자의 컴퓨터에서 터널 공급자 CLI를 실행합니다. 먼저 사용할 공급자를 설치하세요:

Terminal window
brew install cloudflared
brew install ngrok

Cloudflare 빠른 터널은 cloudflared로 실행할 수 있습니다. Ngrok은 ngrok 계정과 ngrok 대시보드의 authtoken이 필요합니다:

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

빠른 시작

  1. OpenChamber를 시작합니다:
Terminal window
openchamber

이 단계를 건너뛰면 openchamber tunnel start가 CLI 서버를 자동으로 시작할 수 있습니다. 자동 시작 시 --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이 표시됩니다. 그 URL을 열거나 QR 코드를 스캔하면 어디서든 OpenChamber에 접근할 수 있습니다.

기본적으로 OpenChamber는 대화형 TTY 세션에서 QR 코드를 출력합니다. --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 같은 서버 플래그를 저장합니다

관련 문서