# 사이트에서 Kapsule CDN 활성화하기

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

Kapsule CDN은 사이트를 엣지에서 캐싱하여 전 세계 어디에서든 방문자가 원본 서버가 아닌 가까운 위치에서 콘텐츠를 받을 수 있게 하며, 가속하려는 사이트에서 토글 하나만 켜면 적용됩니다.

별도로 구매하는 CDN 상품은 없습니다. 사이트가 속한 호스팅 플랜에 함께 제공됩니다. KPanel의 사이트 메뉴에서 켜고 엣지 인증서가 발급될 때까지 몇 분 기다리면 도메인이 저희 엣지 네트워크에서 서비스되기 시작합니다. 먼저 두 가지 조건이 충족되어야 하며, 이 가이드에서 두 가지 모두 다룹니다. 사이트에 커스텀 도메인이 있어야 하고, 플랜에 CDN이 포함되어 있어야 합니다.

## Kapsule CDN이 하는 일

CDN이 켜지면 도메인에 대한 요청이 먼저 저희 엣지 네트워크에 도달합니다. 캐싱 가능한 모든 콘텐츠는 전 세계 119개 이상의 위치 중 가장 가까운 곳에서 응답됩니다. 캐싱할 수 없거나 만료된 콘텐츠는 원본 서버에서 가져온 후 다음 방문자를 위해 엣지에 저장됩니다.

| 기능 | 제공 내용 |
|---|---|
| 엣지 캐싱 | 전 세계 119개 이상의 위치에서 제공되는 정적 자산 |
| 엣지 SSL | 도메인에 자동으로 프로비저닝되는 엣지 인증서 |
| 이미지 최적화 (Kapsule CDN+) | 전환 가능한 실시간 크기 조정 및 압축 |
| WebP 전송 (Kapsule CDN+) | 지원하는 브라우저에 제공되는 최신 이미지 형식 |
| 캐시 TTL 제어 | 초 단위의 별도 엣지 및 브라우저 수명 |
| 대역폭 측정기 | 엣지에서 읽어오는 실시간 월간 사용량. 대역폭은 무제한입니다 |
| 캐시 삭제 | 같은 화면에서 URL 하나 또는 사이트 전체를 삭제 |

## CDN이 포함된 플랜

CDN은 플랜 권한이므로 사이트가 받는 혜택은 해당 사이트가 속한 플랜에 따라 달라집니다. 두 가지 등급이 있으며, CDN 페이지 상단의 배지에서 현재 활성화된 등급을 확인할 수 있습니다.

- **Kapsule CDN**은 글로벌 엣지 캐싱, 자동으로 발급되는 엣지 SSL 인증서, 캐시 삭제를 포함합니다.
- **Kapsule CDN+**는 여기에 더해 DDoS 보호, 스마트 엣지 라우팅, WebP 전송을 포함한 이미지 최적화, KPanel 캐시 제어를 추가로 제공합니다.

**이 표의 모든 플랜에서 엣지 대역폭은 무제한입니다.** 엣지가 제공하는 양에 대한 플랜별 한도는 없으며, 엣지 서비스가 중단되는 시점도 없습니다. 두 등급의 차이는 트래픽 양이 아니라 위에서 설명한 기능 집합에 있습니다. 적용되는 유일한 한계는 플랜별이 아닌 계정 전체 기준이며, 아래의 공정 이용 정책 안내에 나와 있습니다.

| 플랜 | CDN 등급 |
|---|---|
| Start (웹 호스팅) | Kapsule CDN |
| Pro (웹 호스팅) | Kapsule CDN+ |
| Agency (웹 호스팅) | Kapsule CDN+ |
| Scale (웹 호스팅) | Kapsule CDN+ |
| Cloud Power (웹 호스팅) | Kapsule CDN+ |
| WordPress Start | Kapsule CDN |
| WordPress Pro | Kapsule CDN+ |
| Managed WP Start | Kapsule CDN |
| Managed WP Pro | Kapsule CDN+ |
| Managed WC Start | Kapsule CDN |
| Managed WC Pro | Kapsule CDN+ |
| Concierge Start | Kapsule CDN+ |
| Concierge Pro | Kapsule CDN+ |
| Concierge Scale | Kapsule CDN+ |

> **Note:** 매우 큰 규모의 계정에는 [공정 이용 정책](https://kapsulehost.com/ko-kr/legal/fair-use)이 적용되며,
> 이는 플랜별이 아닌 계정 전체 기준의 단일 한계치를 공개하고, 한계치를 넘는 날 이메일로 알려드리며 속도를 제한하거나, 소급 청구하거나, 예고 없이 정지하는 일은 절대 없다고 명시하고 있습니다.

> **Note:** Managed WordPress 및 Managed WooCommerce 플랜에는 엣지와는 다른 측정 기준인 월간 **사이트** 대역폭 한도가 별도로 있습니다. 이를 초과해도 서비스가 중단되거나 요금이 부과되는 일은 없습니다. 호스팅 대역폭은 청구되지 않으며, 알 수 있도록 이메일로 안내해 드립니다. [플랜에서 제한되는 항목](https://support.kapsulehost.com/ko-kr/site-slow-resource-limits)에서 자세히 다룹니다.

[kpanel.kapsulehost.com/plans/hosting](https://kpanel.kapsulehost.com/plans/hosting)에서 플랜을 비교하고 변경할 수 있으며, [플랜 업그레이드](https://support.kapsulehost.com/ko-kr/upgrading-your-plan)도 참고하세요.

## 시작하기 전에

> **Note:** Kapsule CDN에는 커스텀 도메인이 필요합니다. 사이트가 아직 KapsuleHost 공유 서브도메인을 사용하고 있다면 CDN 페이지에 활성화 컨트롤 대신 **Kapsule CDN needs a custom domain** 배너와 **커스텀 도메인 연결** 버튼이 표시됩니다. 먼저 사이트에 자신의 도메인을 연결한 다음 다시 돌아오세요.

이유는 상업적인 것이 아니라 기술적인 것입니다. 엣지는 서비스하는 호스트네임에 대한 SSL 인증서를 발급해야 하며, 이를 위해서는 DNS를 엣지로 지정할 수 있는 호스트네임이 필요합니다. KapsuleHost 공유 호스트네임은 저희가 관리하므로 고객이 재지정할 수 없으며, 따라서 인증서 요청이 결코 완료되지 않고 사이트는 활성화된 것처럼 보이지만 실제로는 오류를 반환하게 됩니다. 그래서 클릭하는 시점에 이를 차단합니다. 연결 단계는 [웹사이트에 커스텀 도메인 추가하기](https://support.kapsulehost.com/ko-kr/custom-domain-for-website)를 참고하세요.

## CDN을 활성화하면 DNS가 변경됩니다

클릭하기 전에 이해해 두는 것이 좋습니다. 많은 분들이 이 부분에서 놀라곤 합니다.

CDN을 켠다고 해서 DNS가 그대로 유지되는 것은 아닙니다. 도메인이 원본 서버로 바로 가는 대신 저희 엣지 네트워크로 연결되어야 하므로, CDN을 활성화하면 사이트의 레코드 두 개가 다시 작성됩니다.

- 엣지를 가리키는 **`www`의 CNAME**. CNAME은 A 또는 AAAA 레코드와 함께 존재할 수 없으므로, `www`에 있던 기존 A 또는 AAAA 레코드는 먼저 삭제됩니다.
- 동일한 엣지를 가리키는 **네이키드 도메인의 ALIAS**로, `www` 없이 도메인으로 가는 트래픽도 CDN을 거치게 됩니다. 네이키드 도메인에 있는 A 또는 AAAA 레코드는 삭제됩니다.

> **Note:** 도메인이 KapsuleHost 네임서버를 사용 중이라면 CDN을 활성화할 때 위 두 가지 변경 사항이 자동으로 적용됩니다. 따로 조작할 필요가 없습니다. 도메인의 DNS가 다른 곳에서 호스팅되고 있다면 이 자동화가 실행될 수 없으며, 레코드가 변경되지 않고 엣지 인증서도 발급되지 않습니다. 어떤 경우에 해당하는지는 [네임서버 이해하기](https://support.kapsulehost.com/ko-kr/nameservers)에서 설명합니다.

> **Warning:** CDN이 켜져 있는 동안에는 이 레코드들을 삭제하거나 덮어쓰지 마세요. `www`이나 네이키드 도메인에 A 레코드를 다시 추가하면 해당 트래픽이 엣지에서 벗어나게 되고, 인증서 갱신이 실패할 수 있습니다. 사이트에 커스텀 DNS가 필요하다면 CDN을 비활성화한 상태에서 변경한 다음 CDN을 다시 활성화하세요.

사이트는 기본 도메인의 DNS가 실제로 기록되어 엣지로 연결된 이후에만 CDN 활성화 상태로 표시됩니다. 이 단계가 성공하지 못하면, 트래픽이 여전히 다른 곳으로 가고 있음에도 패널이 활성화되었다고 알려주는 대신 CDN을 비활성 상태로 계속 표시합니다.

## CDN을 활성화하는 방법

1. [KPanel](https://kpanel.kapsulehost.com)에 로그인하세요.
2. 왼쪽 사이드바에서 **웹사이트**를 클릭한 다음 가속하려는 사이트를 클릭하세요.
3. 해당 사이트 메뉴에서 **성능**를 연 다음 **Kapsule CDN**을 여세요.
4. 페이지가 열리면 **이 사이트에서 CDN이 꺼져 있습니다** 배너가 표시됩니다. **CDN 활성화**을 클릭하세요.
5. "CDN provisioning queued. The edge cert can take up to 5 minutes."라는 확인 메시지가 나타납니다.

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

![KPanel의 사이트용 Kapsule CDN 페이지](https://support.kapsulehost.com/help/screenshots/cdn-enabling.613bdae0.webp)

### 대기 중에 보이는 화면

처음 몇 분 동안은 눈에 보이는 변화가 없으며, 이는 정상이며 오류가 아닙니다. 과정은 다음과 같습니다.

1. 위에서 설명한 DNS 레코드가 도메인에 기록됩니다.
2. 호스트네임에 대한 인증서가 발급되기 전에 이 레코드들이 전파되어야 합니다. 이는 저희가 건너뛸 수 있는 대기열이 아니라 DNS 전파 시간의 제약입니다.
3. 엣지가 인증서를 요청합니다. 아직 DNS가 전파되지 않았다면 요청은 대기 상태로 남으며 성공할 때까지 자동으로 재시도됩니다.
4. 인증서가 발급되면 사이트가 CDN 활성화 상태로 전환됩니다.

> **Note:** 약 5분 정도 기다렸다가 **CDN 활성화**을 다시 클릭하지 말고 페이지를 새로고침하세요. 대기하는 동안에도 페이지에는 CDN이 꺼진 것으로 표시되는데, 이는 트래픽이 실제로 엣지에 도달할 수 있을 때만 켜짐으로 보고하기 때문입니다. 이것은 의도된 동작입니다. 켜졌다고 거짓으로 알리는 반쯤 활성화된 상태보다는 솔직하게 "아직 아님"이라고 알리는 편이 낫기 때문입니다.

인증서가 발급되면 배너가 "CDN active. Your domain serves content from the edge"라는 안내와 함께 **CDN이 켜져 있습니다**으로 바뀌고, 그 아래에 전체 컨트롤 카드가 표시됩니다. 이 시점부터 해당 호스트네임에서 HTTPS가 강제 적용됩니다.

> **Tip:** KPanel 메인 사이드바에는 **CDN** 항목이 없습니다. CDN은 사이트에 속한 기능이므로 한 단계 아래, **성능** 안에 위치합니다.

## 변경할 수 있는 설정

### 캐시 TTL

**캐시 TTL** 카드에는 두 개의 숫자가 있으며, 모두 초 단위이고 기본값은 3600(1시간)입니다.

- **엣지 TTL(초)**: 엣지가 원본 서버로 다시 요청하기 전까지 사본을 유지하는 시간입니다.
- **브라우저 TTL(초)**: 방문자의 브라우저가 자체 사본을 유지하는 시간입니다.

값이 낮을수록 콘텐츠는 더 최신 상태를 유지하지만 원본 서버로의 요청이 늘어납니다. 값이 높을수록 성능은 향상되지만 삭제하기 전까지 콘텐츠가 오래된 상태로 남습니다. 설정 변경은 입력하는 즉시 저장되며 바로 엣지에 적용됩니다.

### 이미지 최적화

이미지 최적화는 **Kapsule CDN+** 기능입니다. Kapsule CDN+가 포함된 플랜에서는 **Image optimisation** 카드에 두 개의 스위치가 있으며, CDN을 처음 켤 때 둘 다 켜져 있습니다.

- **On-the-fly image optimisation**: 첫 요청 시 이미지를 크기 조정 및 압축한 후 최적화된 결과를 엣지에 캐싱합니다.
- **지원 브라우저에 WebP 제공**: WebP 지원을 알리는 브라우저에는 WebP를 전송하고, 그 외에는 원본 형식을 전송합니다.

거의 모든 사이트에서 두 기능을 모두 켜두는 것이 좋습니다. 이미지가 원본과 바이트 단위로 완전히 동일하게 제공되어야 하는 경우에만 이미지 최적화를 끄세요.

Kapsule CDN이 포함된 플랜에서는 이 카드 대신 이미지 최적화가 Kapsule CDN+에 포함되어 있다는 안내와 함께 해당 플랜으로 연결되는 링크가 표시됩니다. 사이트의 플랜을 Kapsule CDN+가 포함된 플랜으로 변경하면 이미지 최적화가 즉시 켜집니다. 이미지 최적화가 없는 플랜으로 변경하면 다음 갱신 시점에 적용되며, 그때 이미지 최적화가 꺼집니다.

## 대역폭 확인하기

**이번 달 대역폭** 카드는 엣지에서 실시간으로 읽어오며 매월 1일에 초기화됩니다. 지금까지 제공한 양을 보여주며, 그 옆에 **무제한 대역폭**라고 표시됩니다. 비교할 기준이 없기 때문입니다. 이 수치는 특정 한도 아래로 유지하기 위한 것이 아니라 엣지가 얼마나 많은 작업을 수행하고 있는지 보여주기 위한 것입니다.

> **Note:** 엣지 서비스가 중단되는 지점은 없으며, 초과할 수 있는 수치도 없습니다. 이 카드는 하나의 측정값일 뿐, 결코 사용량 미터가 아닙니다. 계정 규모가 커서 계정 전체 기준의 [공정 이용 정책](https://kapsulehost.com/ko-kr/legal/fair-use)이 적용되는 경우, 해당 정책에서 한계치를 공개하며, 사이트 제공 방식을 바꾸는 대신 한계치에 도달한 날 이메일로 안내해 드립니다.

카드에 "Usage unavailable"이라고 표시되면 단순히 그 시점에 실시간 수치를 가져오지 못한 것입니다. 이는 표시 문제일 뿐 CDN이 다운되었다는 신호가 아닙니다. 1분 후 페이지를 새로고침하세요.

## CDN 끄기

1. 사이트에서 **성능**를 연 다음 **Kapsule CDN**을 여세요.
2. "Traffic goes back to your origin server."라고 표시된 **CDN 비활성화** 카드로 스크롤하세요.
3. **Disable**을 클릭하세요.

트래픽은 즉시 원본 서버로 돌아가고, 사이트의 엣지 존이 제거되어 대역폭 누적이 중단됩니다. 언제든 다시 활성화할 수 있지만 DNS 레코드와 엣지 인증서를 다시 설정해야 하므로 다시 몇 분 정도 기다려야 합니다.

## 문제 해결

**"Kapsule CDN needs a custom domain."** 사이트가 아직 KapsuleHost 공유 호스트네임을 사용하고 있습니다. 자신의 도메인을 연결한 다음 해당 도메인에서 CDN을 활성화하세요. 이것이 토글이 실패하는 가장 흔한 이유입니다.

**"Kapsule CDN is not included on your current plan."** 이 사이트에 연결된 플랜에는 CDN 권한이 없습니다. 사이트를 위에 나열된 플랜 중 하나로 이전하면 토글을 사용할 수 있게 됩니다. [플랜 업그레이드](https://support.kapsulehost.com/ko-kr/upgrading-your-plan)를 참고하세요.

**1분이 지나도 배너에 CDN이 꺼져 있다고 표시됩니다.** 인증서가 발급되기 전에 DNS 레코드가 전파되어야 하며, 이는 최대 약 5분 정도 걸립니다. 기다렸다가 새로고침하세요.

**5분이 훨씬 지났는데도 CDN이 여전히 꺼져 있습니다.** 가장 가능성 높은 원인은 도메인의 DNS가 저희와 함께 호스팅되지 않아 레코드가 자동으로 기록될 수 없었다는 것입니다. 네임서버가 어디를 가리키는지 확인하세요. 도메인이 KapsuleHost 네임서버를 사용 중인데도 여전히 멈춰 있다면 문의해 주세요.

**DNS를 수정한 후 사이트가 다시 원본으로 돌아갔습니다.** `www`이나 네이키드 도메인에 A 레코드를 다시 추가하면 트래픽을 엣지로 보내는 레코드가 덮어씌워집니다. CDN을 비활성화하고 필요한 DNS를 정리한 다음 다시 활성화하세요.

**CDN 배지는 표시되는데 변경 사항이 반영되지 않습니다.** 이는 캐싱이 의도대로 작동하고 있는 것입니다. 변경한 URL 또는 사이트 전체를 삭제하세요. [Kapsule CDN 캐시 삭제하기](https://support.kapsulehost.com/ko-kr/cdn-cache-purge)를 참고하세요.

**사이트가 더 빨라지지 않았습니다.** CDN은 전송 속도를 가속하는 것이지 페이지 생성 속도를 가속하는 것이 아닙니다. 원본 서버에서 페이지 생성이 느리다면 캐시 유지 시간을 늘리거나 먼저 원본 서버를 개선하세요. [웹사이트 속도 개선하기](https://support.kapsulehost.com/ko-kr/website-speed)에서 원본 서버 측면을 다룹니다.

CDN을 활성화한 지 15분이 지나도 배지가 나타나지 않으면 사이트의 도메인을 적어 [support@kapsulehost.com](mailto:support@kapsulehost.com)으로 이메일을 보내주시면 인증서 발급 상태를 확인해 드리겠습니다.