문제 해결
이 문서는 NetFUNNEL Cloudflare Agent 사용 중 발생할 수 있는 일반적인 문제와 해결 방법을 제공합니다.
설치 및 초기화
Worker 배포 실패
증상: Worker 코드 배포가 실패합니다.
해결 방법:
- Worker 코드에 문법 오류가 없는지 확인
netfunnel-cloudflare-agent.js파일이 올바르게 업로드되었는지 확인- Cloudflare 계정의 Workers 권한 확인
환경 변수 설정이 적용되지 않음
증상: 환경 변수를 설정했지만 에이전트가 동작하지 않습니다.
해결 방법:
- 환경 변수의 이름이 정확한지 확인 (
CLIENT_ID등) - Worker를 배포했는지 확인
- Worker 배포 후 충분한 시간(몇 분) 대기
동작 문제
대기열이 적용되지 않음
증상: 트리거 규칙을 설정했지만 대기열이 적용되지 않습니다.
해결 방법:
- NetFUNNEL 콘솔에서 세그먼트 트리거 규칙이 올바르게 설정되었는지 확인
- URL이 트리거 규칙과 일치하는지 확인
- Worker의 도메인 및 경로 설정이 올바른지 확인
- Worker가 배포되었는지 확인
대기실로 리다이렉트되지 않음
증상: 대기 응답을 받았지만 대기실로 리다이렉트되지 않습니다.
해결 방법:
- Worker의 경로 설정이 올바른지 확인 (끝에
/*포함) - 환경 변수
VWR_PAGE_DOMAIN설정 확인 - Worker 배포 상태 확인
네트워크 문제
Worker 실행 실패
증상: Worker가 실행되지 않거나 오류가 발생합니다.
해결 방법:
- Worker 코드에 오류가 없는지 확인
- 환경 변수 설정이 올바른지 확인
- Cloudflare Workers 서비스 상태 확인
설정 문제
도메인 설정 문제
증상: 도메인으로 접속했을 때 Worker가 실행되지 않습니다.
해결 방법:
- DNS 설정에서 CNAME이 올바르게 설정되었는지 확인
- Proxy 타입으로 설정되었는지 확인 (주황색 구름 아이콘)
- Worker의 도메인 및 경로 설정 확인
- DNS 전파 시간 대기 (최대 24시간)
환경 변수 값이 적용되지 않음
증상: 환경 변수를 설정했지만 값이 반영되지 않습니다.
해결 방법:
- 환경 변수 이름의 대소문자 확인
- Worker 배포 여부 확인
- Worker 배포 후 캐시 클리어 또는 시간 대기