문제 해결
자주 발생하는 문제
1. 연결 실패
✗ API 키가 필요합니다
해결책:
-k옵션으로 Public Key 전달.connectbaserc파일에 secretKey 설정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지원 요청
문제가 지속되면 GitHub Issues에 문의해 주세요.