Error 1033: Cloudflare Tunnel error

의미

Error 1033: Cloudflare Tunnel error는 Cloudflare Tunnel에 문제가 있음을 나타냅니다. Cloudflare 네트워크가 트래픽을 받을 정상 상태의 cloudflared 인스턴스를 찾지 못해 터널이 Cloudflare 네트워크에 연결되지 않은 상태입니다.

확인 방법

1. Cloudflare 대시보드에서 Networking > Tunnels로 이동해 해당 터널의 상태를 확인합니다.
2. 또는 cloudflared tunnel list 명령 결과에서 터널 상태를 확인합니다.
3. 상태가 Healthy이면 터널이 활성화되어 Cloudflare 글로벌 네트워크에 연결된 상태입니다.
4. 상태가 Inactive이면 터널은 생성되었지만 연결 설정을 위한 cloudflared connector가 실행된 적이 없는 상태입니다.
5. 상태가 Down이면 이전에는 연결되었지만 cloudflared 프로세스가 중지되어 현재 연결이 끊긴 상태입니다.
6. 상태가 Degraded이면 connector는 실행 중이고 터널은 트래픽을 제공하지만 개별 연결 중 하나 이상이 실패한 상태입니다.
7. Degraded 상태에서는 cloudflared 로그에서 연결 실패 또는 오류 메시지를 확인하고, 로컬 네트워크와 방화벽 규칙이 Cloudflare Tunnel IP 및 포트 연결을 차단하지 않는지 확인합니다.

관찰값 기록

문제가 발생한 URL 또는 화면, 표시 시각, 운영 환경과 최근 변경 사항을 먼저 기록합니다. 화면이나 로그에 오류 문구가 일부만 보이면 앞뒤 문장을 보존하고 비밀번호·토큰·쿠키·개인정보는 가립니다.

다음 항목을 실제 값과 함께 확인합니다.

1. Cloudflare 대시보드의 Networking > Tunnels 화면에서 터널 상태가 Healthy인지 확인합니다. Healthy이면 터널이 활성화되어 Cloudflare 글로벌 네트워크에 연결된 상태입니다.
2. Cloudflare 대시보드의 Networking > Tunnels 화면에서 상태가 Inactive인지 확인합니다. Inactive이면 터널은 생성되었지만 연결 설정을 위한 cloudflared connector가 실행된 적이 없는 상태입니다.
3. Cloudflare 대시보드의 Networking > Tunnels 화면에서 상태가 Down인지 확인합니다. Down이면 이전에 연결된 터널이었지만 cloudflared 프로세스가 중지되어 현재 연결이 끊긴 상태입니다.
4. Cloudflare 대시보드의 Networking > Tunnels 화면에서 상태가 Degraded인지 확인합니다. Degraded이면 connector는 실행 중이고 터널은 트래픽을 제공하지만 개별 연결 중 하나 이상이 실패한 상태입니다.
5. cloudflared tunnel list 명령 결과에서 해당 터널의 상태를 확인합니다. 결과가 Healthy, Inactive, Down, Degraded 중 어느 상태인지에 따라 위 판정 기준을 적용합니다.
6. Degraded 상태에서 cloudflared 로그의 연결 실패 또는 오류 메시지를 확인합니다. 해당 메시지가 있으면 개별 연결 실패를 확인할 수 있습니다.
7. Degraded 상태에서 로컬 네트워크와 방화벽 규칙을 확인합니다. Cloudflare Tunnel IP 및 포트 연결을 차단하는 규칙이 있으면 해당 상태와 일치합니다.

판정 기준

오류 문구가 일치해도 같은 원인이 확정되는 것은 아닙니다. 웹서버·런타임·운영체제·플랫폼과 최근 변경 사항을 비교하고, 기대한 관찰값이 나오지 않으면 다음 단계로 넘어가지 않습니다. 이 문서는 출처가 확인한 범위만 설명하며, 범위를 벗어난 원인과 조치는 단정하지 않습니다.

안전한 다음 확인

설정·권한·데이터를 변경하기 전에 백업과 되돌리기 방법을 기록합니다. 운영 환경의 방화벽 전체 해제, 인증서 검증 우회, 데이터 삭제, 비밀값 공개를 기본 조치로 사용하지 않습니다. 확인 결과가 문서의 조건과 다르면 관련 Platform·Component 문서와 공식 출처를 먼저 확인합니다.