Cloudflare Tunnel 업데이트 전, 경로 규칙부터 확인하세요

Cloudflare Tunnel에서 Access 검증이 필요한 규칙을 쓰고 있다면, 다음 업데이트 전에 경로별 라우팅을 점검할 필요가 있습니다. Cloudflare는 10월 22일, cloudflared 2026.10.0부터 ingress 규칙을 고르기 전에 URL을 정규화할 수 있다고 발표했습니다. 원본 서버로 보내는 경로는 그대로 두고, 규칙을 비교하는 경로만 정리하는 기능입니다. 공식 발표

2026년 11월 13일 업데이트: Cloudflare의 11월 12일 발표에 따라 기본 활성화 예정일을 2027년 2월 8일로 수정하고, 2026.11.0의 세미콜론 경로 매개변수 처리를 추가했습니다. 아래 10월 공식 화면은 최초 발표 당시 자료입니다.

주소를 정리하는 곳은 규칙 선택 단계입니다

ingress는 요청을 어느 서비스로 보낼지 정하는 입구 규칙입니다. 이번 정규화는 경로의 점 구간인 .과 ..을 정리하고, 역슬래시를 슬래시로 바꾸며, 연속된 슬래시를 합칩니다. 공식 예시에서 /hello/../path는 /path로 비교하지만, 원본 서버에는 /hello/../path가 전달됩니다. 앱이 받는 URL까지 바꿔주는 기능은 아닙니다. 경로 매칭 문서

예를 들어 같은 호스트에서 공개 페이지와 내부 도구를 경로로 나누는 운영 환경을 가정해 보겠습니다. 정규화 전후에 선택되는 규칙이 달라지면 기대한 서비스로 가는지 다시 확인해야 합니다. 변경을 이해하기 위한 가상 상황이며, 특정 서비스에서 장애나 인증 우회가 발생했다는 뜻은 아닙니다.

모든 Tunnel 설정이 영향을 받지는 않습니다

공식 안내의 영향 범위는 Access 검증을 요구하는 규칙이 있는 설정입니다. 그런 규칙이 없는 설정은 영향을 받지 않습니다. 여기서 Access 검증은 cloudflared가 원본으로 요청을 넘기기 전에 Access JWT를 확인하는 절차입니다. Tunnel을 사용한다는 이유만으로 모두 같은 점검 대상은 아닙니다. Access 설정

현재는 꺼져 있고, 새 릴리스의 기본값이 바뀝니다

11월 12일 공지 기준으로 정규화는 현재 기본으로 꺼져 있습니다. 옵션 이름이 disable-path-normalization이므로 true는 비활성화, false는 활성화입니다. 미리 켜려면 실행 명령의 run 앞에 --disable-path-normalization=false를 넣습니다. 실행 옵션

Cloudflare는 11월 12일 추가 공지에서 기본 활성화 예정일을 2027년 1월 25일에서 2027년 2월 8일부터 나오는 새 cloudflared 릴리스로 연기했습니다. 2026.11.0부터는 ingress 규칙 비교 전에 세미콜론으로 구분된 경로 매개변수도 처리합니다. 11월 12일 변경 공지 그날 기존 설치본이 일괄 전환된다는 발표는 아닙니다. 환경변수 TUNNEL_DISABLE_PATH_NORMALIZATION=false를 사용하는 경우에는 각 복제본에 적용하고 재시작하라는 안내도 확인할 수 있습니다. 최초 적용 안내

Cloudflare Docs 최초 발표 당시 화면입니다. 화면의 1월 25일 일정은 11월 12일 공지에서 2월 8일로 변경됐습니다. 2026년 10월 24일 한국시간 확인. 화면 영역을 잘랐으며 내용은 변경하지 않았습니다. 원문 · 문서 이용 조건 · CC BY 4.0. Cloudflare의 제휴·후원을 뜻하지 않습니다.

업데이트 전에 비교할 것은 두 가지입니다

저는 이번 변경을 새 기능을 켜는 문제보다, 같은 요청이 업데이트 이후에도 의도한 규칙을 타는지 확인하는 문제로 보고 있습니다. 우선 Access 검증 규칙 유무와 실행 버전을 확인하고, 해당한다면 테스트 환경에서 선택된 규칙과 원본 서버가 받은 경로를 따로 비교하는 편이 좋겠습니다.

2026.11.0 이상에서 기존 경로별 테스트에 점 구간·중복 슬래시·세미콜론 경로 매개변수 사례를 더하고, 인증이 필요한 요청의 처리 결과까지 확인해 보세요. 규칙 선택이 바뀌지 않는지 확인하는 것과 원본 URL이 유지되는지 확인하는 것은 서로 다른 검사입니다. 이 둘을 나누면 새 기본값을 적용할 때 무엇을 확인해야 하는지 명확해집니다.

썸네일은 AI로 제작한 개념 이미지이며 실제 Cloudflare 제품 화면이 아닙니다. 상표는 해당 권리자 소유입니다.

Cloudflare의 다른 업데이트를 함께 점검한다면 Sandbox 인증서·이미지 업데이트 확인 사항도 참고할 수 있습니다. 인증서와 실행 이미지를 다루는 별도 변경이며, 이번 Tunnel 경로 정규화와 같은 문제는 아닙니다.

저는 이번 변경을 새 기능을 켜는 문제보다, 같은 요청이 업데이트 이후에도 의도한 규칙을 타는지 확인하는 문제로 보고 있습니다. 규칙 선택과 원본 서버 수신 경로를 별도로 검사해야 적용 범위를 혼동하지 않을 수 있습니다.