문제 해결
자주 발생하는 문제
1. 인증 실패
키를 어디에서도 찾지 못하면 CLI가 종료합니다(에러 메시지 문구는 CLI 버전에 따라 달라질 수 있음).
해결책 — 다음 중 하나로 유저 Secret Key (cb_sk_) 를 제공합니다:
-k또는-s옵션으로 명시적 전달.connectbaserc파일에secretKey필드 설정 (npx connectbase init)CONNECTBASE_SECRET_KEY환경변수 설정
bash
npx connectbase tunnel 3000 -k cb_sk_...2. 재연결 반복
⚠ 2초 후 재연결 시도... (1/10)
원인:
- 네트워크 불안정
- 서버 일시적 문제
해결책:
- 네트워크 연결 확인
- 잠시 후 다시 시도
- 최대 10회 재연결 시도 후 종료됨
3. 타임아웃 초과
Error: Request timeout
원인:
- 로컬 서버 응답이 타임아웃보다 오래 걸림
- 플랜 제한 초과
해결책:
bash
# 타임아웃 늘리기 (플랜 상한 이내)
npx connectbase tunnel 3000 --timeout 1204. 바디 크기 초과
Error: Request body too large
원인:
- 요청/응답 본문이 플랜 제한 초과
해결책:
bash
# 바디 크기 늘리기 (플랜 상한 이내)
npx connectbase tunnel 3000 --max-body 255. 로컬 서버 연결 실패
Error: connect ECONNREFUSED 127.0.0.1:3000
원인:
- 로컬 서버가 실행 중이지 않음
- 다른 포트에서 실행 중
해결책:
bash
# 로컬 서버 먼저 실행
npm run dev &
npx connectbase tunnel 3000디버그 모드
상세 로그 확인:
bash
DEBUG=1 npx connectbase tunnel 3000지원 요청
문제가 지속되면 ConnectBase 콘솔 의 문의 양식 또는 콘솔 내 실시간 채팅으로 문의해 주세요.