Set URL/Protocol Rewrite Rules
최신 업데이트：2024-07-17 17:19:56
CDNetworks CDN 플랫폼을 통해 사용자가 귀하의 웹사이트 콘텐츠에 액세스할 때, 콘솔에서 간단한 규칙을 설정하여 요청 URL의 프로토콜, 요청 콘텐츠, 요청 헤더 또는 사용자의 지리적 위치 등 다양한 기준에 따라 특정 콘텐츠를 사용자에게 전달할 수 있습니다. 현재 CDNetworks는 특정 상태 코드와 새로운 요청 URL로 응답하여 클라이언트가 새로운 요청을 시작할 수 있도록 요청 URL 또는 프로토콜을 재작성하는 시나리오를 지원합니다.
URL/프로토콜 재작성 설정 방법
- CDNetworks 콘솔에 로그인하고 적절한 제품을 선택합니다.
- 설정 페이지로 이동하여 설정하려는 도메인을 찾고 도메인 이름 오른쪽의 편집 버튼이나 상단의 설정 수정을 클릭합니다
![[Feature Upgrade] Advanced Access Control](https://documents.cdnetworks.com/wcs/draft/help_doc/zh_cn/17/31949/1714027842700_image.png)
. - 설정 수정 페이지에서 페이지 재작성/리디렉션 아래의 URL/프로토콜 재작성을 찾아 추가 버튼을 클릭합니다.
- 규칙 편집 페이지에서 필요한 설정 항목을 추가합니다.
적용 범위
CDNetworks에서는 URL 패턴을 통해 사용자의 요청이 재작성 규칙에 적합한지 판단할 수 있는 URL 정규 표현식을 콘솔에 입력할 수 있습니다. 예를 들어: rewrite/*.(jpg|png|gif)는 rewrite 디렉토리 내의 jpg|png|gif 파일에 대한 요청이 이 규칙에 일치함을 의미합니다。
위와 같이 규칙의 효과 범위에 대한 기본 매칭 조건으로 URL 정규 표현식을 설정하는 것 외에도, 고급 범위를 통해 다른 조건을 추가할 수 있습니다. 기본 URL 정규 표현식과 결합하여 다음 매개변수 중 하나 이상을 선택하여 AND 관계를 형성하여 규칙의 최종 범위를 결정할 수 있습니다.
| 매개변수 | 설명 |
|---|---|
| UA 또는 예외 UA | 정규 표현식을 지원하며, 공백 및 TAB은 \s로 변환됩니다.여러 UA를 동시에 설정할 수 있으며, 각 UA는 별도의 줄에 배치됩니다。 |
| 국가 또는 예외 국가 | CDNetworks가 제공하는 국가/지역 목록에서 직접 검색 선택을 지원합니다. 중국 본토의 경우 특정 성이나 동중국, 남서중국과 같은 큰 지리적 영역을 선택할 수 있습니다。 |
| 요청 헤더 또는 예외 요청 헤더 | 헤더와 값을 입력하고, 값은 정규 표현식을 지원합니다. 예를 들어: Range bytes=[0-9]{9,}。현재, 단일 규칙에서는 하나의 요청 헤더만 설정할 수 있습니다。 |
| 예외 URL (정규 표현식) | 정규 표현식을 지원합니다。 URL 패턴에 rewrite/*.(jpg|png|gif)를 입력하고, 이 항목에 rewrite/*exception*.jpg를 입력한 경우, rewrite 디렉토리 내의 jpg|png|gif 파일에 대한 요청은 이 규칙에 일치하지만, *exception*.jpg를 포함하는 요청에는 적용되지 않습니다。 |
고급 범위 항목 중 예외로 표시된 항목은 NOT을 의미하며, 기본 매칭 규칙 범위 내의 특정 사례를 제외합니다; 위 나열된 각 구성 항목은 단일 규칙에서 한 번만 나타날 수 있으며, UA와 예외 UA는 단일 규칙에서 상호 배타적이며, 국가 및 요청 헤더도 마찬가지입니다. 따라서 최대 네 개의 고급 구성 항목이 동시에 존재할 수 있습니다。
재작성 유형
현재 CDNetworks는 프로토콜 재작성 또는 URL 재작성 중에서 선택할 수 있습니다. 선택한 유형에 관계없이 클라이언트에 반환할 응답 상태 코드를 선택해야 하며, CDNetworks는 일련의 응답 상태 코드 301;302;303;307을 지원합니다. 기본값은 302입니다。
유형 1: 프로토콜 재작성
프로토콜 재작성은 CDN 엣지 노드가 클라이언트 요청을 받았을 때 프로토콜을 재작성하는 것을 의미합니다. 노드는 재작성된 프로토콜을 사용하여 캐싱 및 원본 풀을 수행합니다. 요청 시 프로토콜만 재작성하는 경우, 관련 규칙 구성에 대해 Origin Pull Protocol Rewriting을 참조하십시오.
이 규칙에서는 HTTP -> HTTPS 또는 HTTPS -> HTTP 재작성을 선택할 수 있습니다.
유형 2: URL 재작성
프로토콜 재작성과 유사하게, URL 재작성은 CDN 노드가 요청을 받을 때 수행되며, 재작성된 URL을 사용하여 캐싱 및 원본 풀을 수행합니다. 요청 시 URL의 호스트와 포트만 교체하는 경우, 관련 규칙 구성에 대해 Origin Pull Host and Port을 참조하십시오.
URL 재작성 유형에서는 재작성하려는 요청 URL을 원본 경로에 입력할 수 있으며, 정규 표현식 또는 완전한 URL을 지원합니다. 예를 들어 (https://[^/]+)/.* 또는 http://domain/browse/index.html?aa=1입니다. 리디렉션 경로에는 재작성된 경로를 입력하며, http:// 또는 https://로 시작해야 합니다。
우선 순위
이 규칙의 우선 순위를 1-10 사이로 설정할 수 있으며, 숫자가 클수록 일치 및 적용 우선 순위가 높아집니다. 동일한 매칭 조건의 경우, 우선 순위가 높은 규칙만 적용됩니다。
추가 버튼을 클릭하여 세부 매개변수 구성 규칙 페이지에 들어가는 것 외에도, 추가 버튼 옆의 빠른 구성을 클릭하여 프로토콜 또는 URL 재작성을 간단히 구성할 수 있습니다. 빠른 구성에서는 효과 범위가 기본값으로 모든 요청으로 설정되며, 응답 상태 코드는 302로 설정됩니다. 나머지 구성(재작성할 프로토콜, 원본 URL 및 리디렉션 URL, 우선 순위)은 모두 맞춤 설정할 수 있습니다。
위의 구성을 완료한 후 확인을 클릭하고 다음을 선택하여 구성을 제출하십시오. 프로덕션 환경에 영향을 미치지 않도록, 먼저 테스트 환경에서 구성을 검증하기 위해 사전 배포를 권장합니다. 구성이 올바른 것으로 확인되면 직접 배포를 클릭하여 라이브 환경에서 공식적으로 구성을 활성화하십시오. 설정은 일반적으로 약 3-5분 후에 적용됩니다. 사전 배포 테스트에 대한 자세한 내용은 사전 배포를 통한 구성 효과 검증을 참조하십시오.
구성 예시
예시 1: URL 정규 표현식 및 UA, 국가 필드와 일치하는 요청에 대한 프로토콜 재작성
이 규칙에 연결된 도메인의 경우, 그림에 표시된 URL 정규 표현식에 일치하고, UA 헤더가 Mozilla/4.0이며 사용자의 국가가 일본; 한국인 경우 CDN 서버는 재작성된 프로토콜로 URL을 캐싱하여 클라이언트에 반환합니다. 예를 들어, http://domain/rewrite/example.jpg 요청은 https://domain/rewrite/example.jpg를 반환하며, 응답 상태 코드는 303으로 클라이언트가 새로운 프로토콜의 URL로 새로운 요청을 시작하도록 유도합니다.
예시 2: URL 정규 표현식 및 UA, 국가 필드, 특정 URL과 일치하는 요청에 대한 URL 재작성
이 규칙에 연결된 도메인의 경우, 그림에 표시된 URL 정규 표현식에 일치하고, UA 헤더가 Mozilla/4.0이며 사용자의 국가가 일본; 한국이며 지정된 원본 경로에 일치하는 경우 CDN 서버는 재작성된 URL을 캐싱하여 클라이언트에 반환합니다. 예를 들어, https://domain/rewrite/urltype1.jpg 요청은 https://domain/target/urltype1.jpg를 반환하며, 응답 상태 코드는 302로 클라이언트가 반환된 URL로 새로운 요청을 시작하도록 유도합니다.
주의사항
노드는 캐싱 및 원본 풀에 재작성된 URL을 사용하므로 재작성된 도메인은 CDNetworks CDN 플랫폼에서 가속화된 도메인이어야 합니다. 프로토콜 재작성 유형의 경우, 도메인당 하나의 규칙만 허용됩니다. 이는 HTTP—>HTTPS 및 HTTPS—>HTTP 요청을 동시에 히트할 때 발생할 수 있는 잠재적인 루프 문제를 방지하기 위해서입니다. 여러 프로토콜 재작성 규칙을 구성하려면 기술 지원에 문의하십시오。