Set Cache Rules
최신 업데이트：2025-05-20 10:45:41
CDNetworks CDN 플랫폼은 콘텐츠에 대한 캐시 정책을 에지 서버에서 맞춤화할 수 있도록 지원합니다. 다양한 파일 유형, 요청 URL 및 기타 파라미터에 따라 캐시 지속 시간과 기타 정책을 구성하여 CDN 플랫폼에서 원하는 캐싱 동작을 구현할 수 있습니다. 또한, 웹사이트가 CDNetworks CDN 플랫폼을 통해 가속 및 분산될 때, 플랫폼의 일부 기본 캐싱 규칙이 적용됩니다. 별도의 Customized Caching이 정의되어 있지 않은 경우, 오리진에서 제공되는 콘텐츠는 CDN 서버의 이러한 기본 캐싱 규칙을 따르게 됩니다.
CDNetworks CDN 플랫폼은 오리진 서버의 응답 구성 및 사용자 요청 내용에 따라 서로 다른 캐시 정책과 기본 Cache TTL을 적용합니다.
응답 헤더 또는 요청 헤더 기반 기본 캐싱 규칙
- 오리진 서버의 응답 헤더에
Cache-Control:no-store,no-cache,must-revalidate,post-check=0,pre-check=0및Pragma:no-cache와 같은 no-cache를 나타내는 파라미터가 포함되어 있거나, 요청에Authorization헤더가 있고 응답에Cache-Control:public이 포함되지 않은 경우, CDN 서버는 기본적으로 해당 콘텐츠를 캐싱하지 않습니다. - 오리진 서버의 응답 헤더에 앞서 언급된 no-cache 파라미터가 포함되어 있지 않거나, 응답에
Cache-Control:public이 있는Authorization헤더가 포함된 경우, 캐싱은 플랫폼의 기본 캐시 정책 및 Cache TTL 또는 사용자의 Customized Caching에 따라 진행됩니다(일부 특정 파일 유형은 CDN 서버에서 캐싱되지 않도록 구성될 수 있습니다).
CDNetworks는 요청 파일 유형 또는 요청 유형에 따라 Default Cache Policy와 Cache TTL을 가지고 있습니다. 자세한 내용은 【Default Caching Strategy】를 참고하시기 바랍니다.
캐시 규칙 설정 방법
-
CDNetworks 콘솔에 로그인하여 해당 제품을 선택합니다.
-
Configuration로 이동하여 구성하려는 Domain을 찾아, 상단의 Edit Configuration 또는 Domain 오른쪽의 Edit 버튼을 클릭합니다.
![[ Product Maintenance ] Cloud Security Product Maintenance Announcement](https://documents.cdnetworks.com/wcs/draft/help_doc/zh_cn/17/31949/1714027842700_image.png)
-
설정 수정 페이지로 이동한 후, Cache Optimization에서 Customized Caching을 찾아 Add 버튼을 클릭합니다.
-
규칙 편집 페이지에서 필요에 따라 다음과 같은 구성 옵션을 간편하게 추가할 수 있습니다.
적용 범위
CDNetworks CDN 플랫폼은 사용자 지정 캐시 규칙의 적용 범위에 대해 다음과 같은 옵션을 제공합니다:
| 옵션 | 설명 |
|---|---|
| All Requests | 연관된 Domain에 대한 모든 요청에 본 규칙이 적용됨을 의미합니다. |
| Only Homepage | 이 규칙은 루트 디렉터리의 요청에만 적용됩니다. 예: http://Domain/ 또는 https://Domain/. |
| Specified File Types | 이 규칙은 지정한 파일 유형의 요청에 적용됩니다. 목록에서 선택하거나 직접 파일 유형을 입력할 수 있습니다. 여러 파일 유형은 ;로 구분합니다. 예: ace;aac. |
| Specified URI | 이 캐시 규칙에 적용할 특정 URI를 지정할 수 있으며, 정확히 일치 매칭 또는 파라미터 무시 매칭을 지원합니다. 여러 URI는 줄 바꿈(엔터)으로 구분할 수 있습니다. 정확히 일치 매칭: 사용자의 요청 URI가 설정한 URI와 완전히 일치해야 해당 규칙이 적용됩니다. 파라미터 무시 매칭: 쿼리 스트링이 포함된 URI 요청 시, 쿼리 스트링 파라미터를 무시합니다. 물음표 이전 부분만 설정한 URI와 비교하여 일치하면 이 캐시 규칙이 적용됩니다. 입력하는 URI에는 http:// 혹은 https://를 포함하지 않고, URI 부분만 입력해야 합니다. 예를 들어, 전체 URL이 https://Domain/browse/index.html인 경우 /browse/index.html만 입력합니다. |
| Specified Directory | 이 규칙은 지정한 디렉터리에 대한 모든 요청에 적용되며, 디렉터리는 반드시 /로 시작하고 끝나야 하며, 문자, 숫자, 특정 특수문자(언더바, 하이픈, 퍼센트 기호, 마침표)를 조합해 구성할 수 있습니다. 예: /file/1%1/는 해당 규칙이 http://Domain/file/1%1/ 및 해당 디렉터리 내 모든 파일 요청에 적용됨을 의미합니다.여러 디렉터리는 줄 바꿈으로 구분해야 합니다. |
| URL Pattern | 정규 표현식을 직접 입력하는 것도 가능하며, 반드시 /로 시작할 필요는 없습니다. 플랫폼은 URL 앞에 자동으로 ^https?://[^/]/를 추가합니다. 예시: .*.jpg$는 해당 규칙이 연결된 모든 Domain의 JPG 파일 요청에 대해 이 정책이 적용됨을 의미합니다. |
위 목록에서 사용자 지정 캐시 규칙의 적용 범위를 선택하는 것 외에도, 고급 범위 설정에서 추가로 설정을 할 수 있습니다. 이 설정은 사용자가 지정한 적용 범위와 결합되어, AND 관계로 실제 캐시 규칙의 유효 범위를 결정합니다. 고급 범위 설정은 다음과 같은 옵션을 제공합니다:
| 매개변수 | 설명 |
|---|---|
| UA 또는 예외 UA | 정규 표현식을 지원하며, 공백 문자와 탭(TAB)은 \s로 변환되어 사용됩니다. 예를 들어, ^Mozilla/4.0$는 해당 UA 헤더를 포함하는 요청에 대해 이 규칙을 적용하거나 적용하지 않도록 지정할 수 있습니다.여러 개의 UA를 동시에 설정할 수 있으며, 각 UA는 한 줄씩 입력하십시오. |
| 예외 URL (정규식) | 해당 설정 항목에서는 특정 요청 URL에 대해 캐시 규칙 적용을 제외할 수 있습니다. 정규 표현식 입력 규칙은 위의 URL Pattern 설정 항목과 동일합니다. |
Cache TTL
정의한 Effect Range와 일치하는 요청에 대해, CDNetworks CDN 플랫폼에서 CDN 서버의 캐시 유지 기간을 맞춤 설정할 수 있습니다. 현재 설정 가능한 캐시 유지 기간 관련 전략은 세 가지가 있으며, 아래에 자세히 설명되어 있습니다:
| 파라미터 | 설명 |
|---|---|
| Cache | 이 옵션은 고정된 Cache TTL을 의미합니다. 웹사이트 파일이 일정한 주기로 업데이트된다면, 고정 캐시 유지 기간을 설정하여 CDN 히트율을 높이고 원본 서버로의 트래픽을 줄이는 데 도움이 됩니다. |
| Honor origin cache rule | 웹사이트 파일에 Expires 또는 Cache-Control과 같은 캐시 유지 기간 관련 파라미터가 설정되어 있다면, CDN 서버는 Origin에서 지정한 캐시 유지 기간을 따릅니다. 단, Origin 서버에서 캐시 유지 기간 파라미터가 누락된 경우를 대비하여 이곳에도 캐시 유지 기간을 별도 설정해야 합니다. Origin에서 관련 파라미터가 누락되어도 여기에서 설정한 기간만큼 콘텐츠가 캐시됩니다. |
| 캐시 안 함 | 웹사이트 파일이 실시간으로 업데이트되어야 한다면 캐시 안 함으로 설정해 주세요. 모든 사용자 요청은 CDN 엣지 서버에서 원본에서 콘텐츠를 가져와 사용자에게 응답하며, CDN 엣지 서버에는 캐싱되지 않습니다. |
현재 지원되는 캐시 기간 단위는 초, 분, 시간, 일이며, 기본 단위는 시간입니다.
캐시(고정 캐시 기간) 또는 원본 캐시 규칙 따르기를 선택하면, 고급 설정을 추가로 선택하여 원본 응답 헤더 및 클라이언트 리로드 요청을 기반으로 캐시 동작을 맞춤 설정할 수 있습니다. 플랫폼에는 일부 기본 설정이 적용되어 있을 수 있습니다.
| 파라미터 | 설명 |
|---|---|
| 원본의 Ignore No-Cache 헤더 | 이 옵션의 기본값은 아니오입니다. 자세한 내용은 이 문서의 서두를 참고하세요. 예를 선택하면 원본 응답 헤더의 Cache-Control: no-cache와 같은 no-cache 관련 모든 파라미터가 무시되며, 현재 정의한 cache rule이 직접 적용됩니다. |
| Authorization 헤더 무시 | 이 옵션의 기본값은 아니오입니다. 자세한 내용은 이 문서의 서두를 참고하세요. 예를 선택하면 원본 응답 헤더에 Cache-Control: public이 없이 Authorization 헤더가 포함된 요청도 현재 정의한 cache rule이 적용됩니다. |
| 클라이언트 새로고침 무시 | 클라이언트의 reload 요청 처리 규칙을 설정합니다. 클라이언트의 새로고침 요청을 무시하도록 사용자 지정할 수 있습니다. 즉, CDN 서버에 캐시 유지기간 내에 있는 파일이 클라이언트에 직접 반환됩니다. 또는 이를 if-modified-since로 변환하도록 선택할 수 있습니다. 이 경우, CDN 엣지 서버의 파일 최종 수정 시간이 클라이언트의 Last-Modified 시간보다 늦으면 캐시된 파일이 반환되고, 그렇지 않으면 304 Not Modified 상태 코드가 반환됩니다. |
대소문자 구분 무시
예를 선택하면, 위에서 지정한 적용 범위에서 대소문자를 무시한다는 의미입니다. 즉, URL의 대소문자만 다른 두 요청 모두 설정한 규칙에 일치합니다. 예를 들어, http://domain/a.jpg의 캐시 시간을 1시간으로 설정하면, http://domain/a.jpg와 http://domain/A.jpg 모두 CDN 엣지 서버에 1시간 동안 캐시됩니다.
반대로, 아니요를 선택하면 적용 범위에 설정한 값과 대소문자가 일치하지 않는 요청에는 규칙이 적용되지 않고, 오직 지정한 적용 범위와 정확히 일치하는 요청만 CDN 엣지 서버에 캐시됩니다.
이 설정의 기본값은 예입니다.
우선순위
우선순위 필드에서 이 규칙의 우선순위 레벨을 지정할 수 있습니다. 사용자의 요청에 따라 시스템이 설정한 규칙들과 매칭하여, 여러 규칙이 적용되는 경우 우선순위가 높은 규칙이 먼저 적용됩니다.
추가(Add) 버튼을 클릭하여 상세 설정 페이지로 이동하는 것 외에도, 추가(Add) 옆에 있는 빠른 설정(Quick Configuration) 버튼을 통해 간편하게 캐시 규칙을 설정할 수 있습니다. 적용 범위는 기본적으로 모든 요청으로 설정되며, 캐시 기간은 캐시(Cache) 또는 원본 캐시 규칙 준수(Follow Origin Cache Rules) 중 하나를 선택할 수 있습니다. 단, 여기에서는 고급 설정(Advanced Settings) 옵션은 제공되지 않습니다. 또한, **캐시 안 함(Do Not Cache)**을 직접 선택하고 이 단순 규칙의 적용 우선순위를 빠르게 지정할 수 있습니다.
구성을 모두 완료하셨으면 확인(OK) 버튼을 클릭한 후, **다음(Next)**을 선택하여 설정을 제출해 주세요. 운영 환경에 영향을 최소화하기 위해, 스테이징 환경에서 사전 배포(Pre-deploy) 테스트를 반드시 진행하실 것을 강력히 권장합니다. 이 중요한 단계는 라이브 반영 전 구성의 정확성을 확인하는 데 도움이 됩니다. 설정의 정확성을 검증하셨다면, **지금 배포(Deploy Now)**를 클릭하여 라이브 환경에 반영할 수 있습니다. 설정은 일반적으로 3~5분 내에 적용됩니다. 사전 배포 테스트 및 구성 검증에 대한 자세한 안내는 튜토리얼 스테이징 환경에 구성 배포 및 검증 가이드를 참고해 주세요.
베스트 프랙티스
예시 1: 특정 User Agent가 요청하는 특정 파일 유형에 고정된 캐싱 기간 적용하기
이 규칙에 따라 연결된 Domain에서 파일 유형이 png;jpeg이고 User-Agent가 Mozilla/4.0일 경우, 해당 파일은 CDN Edge Caching 서버에서 6시간 동안 고정된 Cache TTL로 저장됩니다. 이 규칙은 또한 원본 응답 헤더의 no-cache 파라미터, 요청의 Authorization 헤더, 클라이언트의 다시 로드 요청을 강제로 무시하도록 설정합니다.
참고 사항
이 튜토리얼에서 구성한 캐싱 규칙은 CDN 서버에 적용됩니다. Content Acceleration 및 Media Acceleration Live Broadcast와 같은 다양한 CDN 솔루션은 동일한 파일 유형에 대해 서로 다른 기본 캐싱 규칙을 적용할 수 있습니다. 여기 제공된 기본 규칙은 일반적인 참고용입니다. 만약 귀하의 웹사이트에서 기본 규칙이 매우 중요하다면, 기술 지원팀에 확인을 요청해 주시기 바랍니다.