# Kapsule CDN 캐시 제거하기

Source: https://support.kapsulehost.com/ko-kr/cdn-cache-purge

캐시를 제거하면 엣지에 보관된 콘텐츠 사본이 지워지므로, 다음 방문자는 원본 서버에서 새로 가져온 버전을 받게 됩니다. 변경 사항을 게시했는데도 이전 버전이 계속 보일 때 이 작업을 합니다.

캐싱은 CDN을 빠르게 만드는 요소이며, 방금 한 변경 사항이 바로 나타나지 않을 수 있는 이유이기도 합니다. 캐시 유지 시간을 0으로 줄이기보다는 길게 유지하고 필요할 때 캐시를 제거하세요. 이 가이드는 두 가지를 모두 다루며, 엉뚱한 곳을 찾기 전에 엣지 캐시와 브라우저 캐시를 구분하는 방법도 설명합니다.

## 캐시를 제거해야 하는 경우

방문자가 URL로 가져오는 항목을 변경한 후에는 캐시를 제거하세요.

- CSS 또는 JavaScript 파일을 교체했는데 이전 파일이 계속 제공되는 경우.
- 기존 파일 이름 그대로 이미지의 새 버전을 업로드한 경우.
- 페이지의 버그를 수정했고, 문제가 있는 버전을 전 세계에서 즉시 없애고 싶은 경우.
- 페이지 내용을 변경했는데 엣지 TTL이 만료될 때까지 기다릴 수 없는 경우.

완전히 새로운 페이지나 새 파일 이름을 추가한 경우에는 캐시를 제거할 필요가 없습니다. 한 번도 요청된 적이 없는 URL에는 캐시된 것이 없습니다.

> **Tip:** 에셋 파일 이름에 버전을 붙이면(`style.css` 대신 `style.a1b2c3.css`) 캐시를 제거할 일이 거의 없습니다. 새 파일 이름은 새 URL이므로 원본 서버에서 새로 가져오고 자체 키로 캐시됩니다.

## 캐시 제거 기능의 위치

1. [KPanel](https://kpanel.kapsulehost.com)에 로그인합니다.
2. 왼쪽 사이드바에서 **웹사이트**를 클릭한 다음 사이트를 클릭합니다.
3. 사이트 메뉴에서 **성능**을 연 다음 **Kapsule CDN**을 엽니다.
4. **캐시 제거** 카드까지 스크롤합니다.

직접 주소는 `/websites/<site-id>/cdn`입니다.

![Kapsule CDN 페이지의 캐시 제거 카드](https://support.kapsulehost.com/help/screenshots/cdn-cache-purge.881b7fa3.webp)

> **Note:** 캐시 제거 기능은 사이트에서 CDN이 켜진 후에만 나타납니다. 페이지에 **이 사이트에서 CDN이 꺼져 있습니다** 배너가 표시되거나 맞춤 도메인을 연결하라는 안내가 나오면, 엣지에는 아직 제거할 것이 없습니다. 어떤 플랜에 포함되는지는 [사이트에서 Kapsule CDN 활성화하기](https://support.kapsulehost.com/ko-kr/cdn-enabling)에 정확히 나와 있습니다.

## 단일 URL 제거하기

1. **캐시 제거** 카드의 **제거할 URL(전체 사이트는 공백으로 남겨두기)** 필드에 전체 공개 URL을 입력합니다. 필드의 예시 텍스트가 예상되는 형식을 보여 줍니다: `https://your-domain.tld/path`
2. **제거**를 클릭합니다.
3. 입력한 URL을 제거했다는 확인 메시지가 나타납니다.

방문자가 요청할 URL을 스킴(`https://`), 호스트, 경로까지 포함해 정확히 사용하세요. 캐시 제거는 URL을 기준으로 일치시키므로 `https://example.com/about`과 `https://example.com/about/`은 서로 다른 캐시 항목이며, 같은 페이지에 쿼리 문자열을 붙인 것도 마찬가지입니다.

무엇이 변경되었는지 정확히 알고 있다면 단일 URL을 제거하는 것이 올바른 첫 단계입니다. 즉시 적용되며 나머지 캐시는 그대로 유지되므로 사이트의 나머지 부분은 계속 빠르게 동작합니다.

## 전체 사이트 제거하기

1. **제거할 URL** 필드를 완전히 비워 둡니다.
2. **제거**를 클릭합니다.
3. 확인 메시지에 "전체 캐시를 제거했습니다."라고 표시됩니다.

> **Warning:** 전체 제거는 모든 엣지 위치에서 사이트의 캐시된 객체를 모두 비웁니다. 각 URL이 다시 요청될 때까지 모든 방문자는 원본 서버에서 제공받으므로, 원본 서버에 트래픽이 한꺼번에 몰리고 각 페이지의 첫 방문자는 전체 왕복을 기다리게 됩니다. 방문자가 많은 사이트에서는 변경한 특정 URL만 제거하는 것이 좋습니다.

실행한 모든 캐시 제거는 URL 또는 전체 영역 표시와 함께 계정의 활동 로그에 기록되므로, 누가 언제 무엇을 제거했는지 확인할 수 있습니다.

## 캐시 유지 시간과 상호 작용

같은 페이지의 **캐시 TTL** 카드에서 캐시 제거 없이 콘텐츠가 유지되는 기간을 설정합니다.

| 설정 | 제어하는 내용 | 기본값 |
|---|---|---|
| **엣지 TTL(초)** | 엣지가 원본 서버에서 다시 가져오기 전까지 사본을 보관하는 기간 | 3600 (1시간) |
| **브라우저 TTL(초)** | 방문자의 브라우저가 자체 로컬 사본을 보관하는 기간 | 3600 (1시간) |

두 설정은 서로 독립적이며, 이것이 가장 흔한 혼란의 원인입니다. 캐시 제거는 **엣지**를 지웁니다. 방문자의 브라우저 안까지는 닿지 않습니다. 캐시를 제거했는데도 직접 보기에 이전 버전이 보인다면, 거의 확실히 자신의 브라우저 캐시를 보고 있는 것입니다.

이를 배제하려면 비공개 창이나 시크릿 창에서 페이지를 열거나 강력 새로 고침을 하세요. 비공개 창에 새 버전이 보이면 캐시 제거는 성공한 것이며, 이제는 자신의 브라우저와 다른 방문자의 브라우저를 기다리기만 하면 됩니다. 이 브라우저들은 브라우저 TTL이 만료되면 새로 고쳐집니다.

> **Tip:** 자주 게시하는데 파일 이름에 버전을 붙일 수 없다면 **브라우저 TTL**을 짧게(몇 분) 줄이고 **엣지 TTL**은 길게 두세요. 엣지의 이점은 대부분 유지하면서 방문자가 이전 사본에 머무를 수 있는 기간을 크게 줄일 수 있습니다.

## 이미지 최적화와 캐시 제거

**온더플라이 이미지 최적화**가 켜져 있으면(Kapsule CDN+ 기능) 엣지는 각 이미지의 최적화된 파생본을 원본과 함께 저장합니다. 이미지 URL을 제거하면 파생본도 함께 지워지므로, 교체한 이미지는 다음 요청 시 다시 최적화됩니다. 최적화된 이미지만 따로 제거하는 기능은 없습니다.

**지원 브라우저에 WebP 제공**도 마찬가지입니다. WebP 버전은 같은 URL 아래에 있으며 같은 캐시 제거로 지워집니다.

## 문제 해결

**"이 사이트에 대해 CDN이 프로비저닝되지 않음"** 사이트에 아직 엣지 영역이 없습니다. 먼저 CDN을 활성화하고 인증서 프로비저닝이 끝날 때까지 기다리세요.

**"제거하지 못했습니다."** 캐시 제거 요청이 엣지에 도달하지 못했습니다. 잠시 기다린 후 다시 시도하세요. 계속 실패한다면 엣지 영역이 아직 프로비저닝 중일 수 있으니, 페이지에 **CDN이 켜져 있습니다** 배너가 표시되는지 확인하세요.

**캐시를 제거했는데도 페이지가 여전히 이전 버전입니다.** 먼저 비공개 창에서 확인하세요. 비공개 창에서도 이전 버전이 보인다면 끝의 슬래시와 쿼리 문자열까지 포함해 정확한 URL을 제거했는지 확인한 다음 전체 제거를 시도하세요.

**일부 방문자에게만 업데이트가 보입니다.** 그 방문자의 브라우저가 아직 브라우저 TTL 기간 안에 있습니다. 문제가 있는 것이 아닙니다. 기간이 만료되면, 또는 강력 새로 고침을 하면 즉시 새 버전을 받게 됩니다.

**전체 제거 후 원본 서버가 다운되었습니다.** 위에서 설명한, 캐시되지 않은 트래픽이 한꺼번에 몰린 것입니다. 엣지 TTL을 늘리고 다음에는 변경된 URL만 제거하세요. 원본 서버 자체를 더 견고하게 만드는 방법은 [웹사이트 속도 개선하기](https://support.kapsulehost.com/ko-kr/website-speed)에서 다룹니다.

캐시 제거는 성공했는데 엣지가 몇 분 넘게 이전 콘텐츠를 계속 제공한다면, 정확한 URL과 캐시를 제거한 시각을 적어 [support@kapsulehost.com](mailto:support@kapsulehost.com)으로 이메일을 보내 주세요.