빠른 시작
사전 준비
- Connect Base 계정 생성
- 시크릿 키 발급 (콘솔 → 프로필 → 시크릿 키 탭)
기본 사용법
터널은 **유저 Secret Key(cb_sk_)**와 앱 선택이 필요합니다.
bash
# 기본 사용 (앱이 1개면 자동 선택, 여러 개면 인터랙티브 선택)
npx connectbase tunnel 3000 -k cb_sk_...
# 앱을 직접 지정
npx connectbase tunnel 3000 -k cb_sk_... --app <앱ID>
connectbase와connectbase-client는 동일한 CLI입니다. 둘 중 어느 이름으로 호출해도 됩니다.
Secret Key 설정 방법
세 가지 방식 중 하나만 선택하면 됩니다.
방법 1: 환경변수 (권장 — 폴더 무관)
가장 간편하며, 어느 디렉토리에서 실행하든 동작합니다.
bash
export CONNECTBASE_SECRET_KEY=cb_sk_...
npx connectbase tunnel 3000영구 적용하려면 ~/.bashrc 또는 ~/.zshrc에 export 라인을 추가하세요.
방법 2: 커맨드라인 인자 (-k)
일회성 테스트용. 셸 히스토리에 키가 그대로 남으므로 운영 환경에서는 권장하지 않습니다.
bash
npx connectbase tunnel 3000 -k cb_sk_...방법 3: 설정 파일 (.connectbaserc)
npx connectbase init으로 프로젝트를 초기화하면 .connectbaserc가 생성됩니다.
앱 선택
터널은 사용량을 앱 단위로 트래킹하므로, 실행 시 앱을 선택해야 합니다.
--app <앱ID>: 앱을 직접 지정- 앱이 1개: 자동 선택
- 앱이 여러 개: 인터랙티브 선택 프롬프트 표시
- 앱이 없으면: 새 앱 생성 가능
우선순위
여러 방식을 동시에 설정한 경우 우선순위는 다음과 같습니다:
-k커맨드라인 인자CONNECTBASE_SECRET_KEY환경변수
실행 결과
ℹ 터널 서버에 연결 중...
✓ 터널 연결됨!
터널 URL: https://tunnel.connectbase.world/abc12345
→ 외부에서 이 URL로 접근하면 localhost:3000으로 전달됩니다
타임아웃: 60초, 최대 바디: 10MB
종료하려면 Ctrl+C를 누르세요