# 在您的网站上启用 Kapsule CDN

Source: https://support.kapsulehost.com/zh-cn/cdn-enabling

Kapsule CDN 会在边缘节点缓存您的站点，这样世界各地的访客都能从附近的节点获取内容，而不是每次都访问您的源服务器，开启它只需要在您想要加速的站点上打开一个开关即可。

无需单独购买 CDN 产品：它已随站点所在的主机方案一并提供。您只需在 KPanel 中该站点自己的菜单里开启它，等待几分钟让边缘证书签发，您的域名就会开始从我们的边缘网络提供服务。开启前需要满足两个前提条件，本指南将一一说明：站点需要绑定自定义域名，且其方案需要包含 CDN。

## Kapsule CDN 的作用

CDN 开启后，针对您域名的请求会先到达我们的边缘网络。所有可缓存的内容都会从 119 个以上全球节点中最近的一个作答。所有不可缓存或已过期的内容，则会从您的源服务器获取，然后保存在边缘节点，供下一位访客使用。

| 功能 | 您将获得 |
|---|---|
| 边缘缓存 | 静态资源由 119 个以上全球节点提供 |
| 边缘 SSL | 系统会自动为您的域名签发边缘证书 |
| 图片优化（Kapsule CDN+） | 实时调整大小并压缩，可随时切换 |
| WebP 投放（Kapsule CDN+） | 向支持的浏览器提供一种现代图片格式 |
| 缓存 TTL 控制 | 分别以秒为单位设置边缘与浏览器的缓存有效期 |
| 带宽计量 | 从边缘节点读取的实时月度用量，带宽无上限 |
| 缓存清除 | 在同一界面清除单个 URL 或整个站点的缓存 |

## 哪些方案包含 CDN

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/zh-cn/legal/fair-use)，
> 该政策公布的是账户层面的统一阈值，而非按方案设定的阈值，并明确说明：当您达到该阈值的当天我们会发送邮件通知您，绝不限速、绝不追溯计费、也绝不在未通知的情况下暂停服务。

> **Note:** Managed WordPress 和 Managed WooCommerce 方案附带独立的每月**站点**带宽额度，这与边缘带宽是不同的计量方式。超出该额度绝不会导致中断服务或产生费用：主机带宽不计费，我们只会发邮件告知您。详见[您的方案有哪些限制](https://support.kapsulehost.com/zh-cn/site-slow-resource-limits)。

您可以在 [kpanel.kapsulehost.com/plans/hosting](https://kpanel.kapsulehost.com/plans/hosting) 比较并更改方案，或参阅[升级您的方案](https://support.kapsulehost.com/zh-cn/upgrading-your-plan)。

## 开始之前

> **Note:** Kapsule CDN 需要绑定自定义域名。如果您的站点仍使用 KapsuleHost 提供的共享子域名，CDN 页面会显示横幅**Kapsule CDN 需要自定义域名**，并提供**连接自定义域名**按钮，而不是启用控件。请先为站点连接您自己的域名，然后再回到此页面。

原因是技术性的，而非商业性的：边缘节点需要为其所服务的主机名签发 SSL 证书，而这要求该主机名的 DNS 可以指向边缘节点。KapsuleHost 提供的共享主机名由我们管理，无法为您重新指向，因此证书请求永远无法完成，站点会显示为已启用，实际却只会返回错误。我们会在点击的那一刻直接加以拦截。连接步骤请参阅[为您的网站添加自定义域名](https://support.kapsulehost.com/zh-cn/custom-domain-for-website)。

## 启用 CDN 会更改您的 DNS

在点击之前，有必要先理解这一点，因为它常常让人感到意外。

开启 CDN 并不会让您的 DNS 保持原样。您的域名必须解析到我们的边缘网络，而不是直接指向您的源服务器，因此启用 CDN 会重写该站点的两条记录：

- 在 `www` 上设置一条**指向边缘节点的 CNAME**。`www` 上任何已有的 A 或 AAAA 记录会先被移除，因为 CNAME 不能与它们共存。
- 在裸域名上设置一条**指向同一边缘节点的 ALIAS**，这样即使访问域名时不带 `www` 前缀，流量也会经过 CDN。裸域名上的任何 A 或 AAAA 记录都会被移除。

> **Note:** 如果您的域名使用的是 KapsuleHost 的名称服务器，我们会在启用 CDN 的过程中自动为您完成上述两项更改，您无需进行任何操作。如果您域名的 DNS 托管在其他地方，这项自动化流程就无法运行，相应记录不会更改，边缘证书也永远不会签发。[了解名称服务器](https://support.kapsulehost.com/zh-cn/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 配置已排队。边缘证书签发最长可能需要 5 分钟。”

直接访问地址为 `/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:** 请耐心等待最多约五分钟，并通过刷新页面来查看状态，而不要再次点击**启用 CDN**。在等待期间，页面仍会显示 CDN 为关闭状态，因为它只会在您的流量真正能够到达边缘节点时才报告为已启用。这是刻意设计：一个声称已启用、实际却处于半启用状态的提示，比一个诚实的“尚未就绪”更糟糕。

证书签发完成后，横幅会变为**CDN 已启用**，并附带提示“CDN 已激活。您的域名正从边缘节点提供内容”，其下方会出现完整的控制卡片组。此时该主机名将强制使用 HTTPS。

> **Tip:** KPanel 主侧边栏中没有单独的 **CDN** 条目。CDN 属于站点的一部分，因此位于下一层级，在**性能**菜单下。

## 您可以更改的设置

### 缓存 TTL

**缓存 TTL** 卡片包含两个数值，均以秒为单位，默认均为 3600（一小时）：

- **边缘 TTL（秒）**：边缘节点在回源之前保留副本的时长。
- **浏览器 TTL (秒)**：访客自己的浏览器保留其副本的时长。

数值越低，内容越新鲜，但对源服务器的请求也越多。数值越高，性能越好，但在您执行清除操作之前内容会更陈旧。设置后更改会立即保存，并立刻推送到边缘节点。

### 图片优化

图片优化是 **Kapsule CDN+** 的功能。在包含 Kapsule CDN+ 的方案上，**图片优化**卡片有两个开关，首次启用 CDN 时两者均为开启状态：

- **实时图片优化**：在首次请求时调整图片大小并压缩，随后将优化后的结果缓存在边缘节点。
- **向支持的浏览器提供 WebP**：向声明支持的浏览器提供 WebP 格式，其他浏览器则提供原始格式。

对几乎所有站点而言，这两项都建议保持开启。只有当您需要提供与原图逐字节一致的图片时，才应关闭图片优化。

在包含 Kapsule CDN 的方案上，该卡片会被替换为一条说明，指出图片优化是 Kapsule CDN+ 的功能，并附有包含该功能的方案链接。将站点方案升级到包含 Kapsule CDN+ 的方案会立即开启图片优化。而降级到不包含该功能的方案，则会在下次续费时生效，届时图片优化会随之关闭。

## 查看您的带宽

**本月的带宽**卡片会从边缘节点实时读取数据，并在每月1日重置。它显示的是您已提供的服务量，并在旁边标注**无限带宽**，因为这里没有需要对照的限额：这个读数的意义在于让您了解边缘节点为您做了多少工作，而不是让您据此控制用量以免超限。

> **Note:** 边缘服务没有停止的临界点，也没有您可能超过的数值。该卡片始终只是一个读数，绝不是一个计量上限。如果您的账户规模较大，适用于账户层面的[公平使用政策](https://kapsulehost.com/zh-cn/legal/fair-use)，该政策会公布相应阈值，一旦您达到该阈值，我们会在当天发邮件通知您，而不会改变您站点的服务方式。

如果卡片显示“用量不可用”，说明当时系统无法获取实时数据，这只是一个显示问题，并不表示 CDN 已经停止工作。请在一分钟后刷新页面重试。

## 关闭 CDN

1. 打开该站点的**性能**，再打开 **Kapsule CDN**。
2. 滚动到**禁用CDN**卡片，上面写着“流量将返回您的源服务器。”
3. 点击**禁用**。

流量会立即恢复指向您的源服务器，站点的边缘区域也会被移除，带宽计量随之停止累计。您可以随时重新启用它，但 DNS 记录和边缘证书需要重新设置，因此请再预留几分钟时间。

## 故障排查

**“Kapsule CDN 需要自定义域名。”** 该站点仍在使用 KapsuleHost 的共享主机名。请先连接您自己的域名，然后再为该域名启用 CDN。这是该开关失败的最常见原因。

**“您当前的方案不包含 Kapsule CDN。”** 该站点所使用的方案不包含 CDN 权益。请将站点迁移到上面列出的方案之一，开关即可使用。参阅[升级您的方案](https://support.kapsulehost.com/zh-cn/upgrading-your-plan)。

**等待一分钟后，横幅仍显示 CDN 为关闭状态。** DNS 记录必须先完成传播才能签发证书，这最多可能需要约五分钟。请耐心等待，然后刷新页面。

**已经远超五分钟，CDN 仍处于关闭状态。** 最可能的原因是您域名的 DNS 并未托管在我们这里，因此相关记录无法自动写入。请检查您的名称服务器指向何处。如果您的域名使用的是 KapsuleHost 的名称服务器，但仍然卡住不动，请联系我们。

**我修改 DNS 之后，站点又回到了源服务器。** 在 `www` 或裸域名上重新添加 A 记录，会覆盖原本将流量路由到边缘节点的记录。请先禁用 CDN，处理好您需要的 DNS 设置，然后再重新启用。

**CDN 徽标已显示，但我的更改没有生效。** 这是缓存按设计正常工作的表现。请清除您所更改内容对应的 URL 缓存，或清除整个站点的缓存：参阅[清除 Kapsule CDN 缓存](https://support.kapsulehost.com/zh-cn/cdn-cache-purge)。

**站点速度并没有变快。** CDN 加速的是内容分发，而不是页面生成过程。如果您的页面在源服务器上生成缓慢，请延长缓存时间，或先优化源服务器本身。[提升网站速度](https://support.kapsulehost.com/zh-cn/website-speed)一文介绍了源服务器方面的优化方法。

如果您在启用 CDN 十五分钟后徽标仍未出现，请发送邮件至 [support@kapsulehost.com](mailto:support@kapsulehost.com)，并附上站点域名，我们会为您核查证书签发情况。
