文档反馈
问问助手在 CDN 中添加域名后，您需要指定内容的来源。当收到用户请求时，如果请求的文件尚未被 CDN 缓存，CDN 会向源站请求文件并进行缓存。
本文档介绍如何在 CDN 中配置源站。CDN 支持的源站类型包括 IP 地址、域名和对象存储桶。您可以配置多个源站，并为每个源站设置权重，以实现源站间的负载均衡。同时，为了保证回源的成功率，CDN 支持配置主备源站。
说明
源站配置模块升级进行中！自 2024 年 5 月 14 日起，部分新增域名将启用新版源站配置模块。在新版模块中配置主源站或备源站时，您可以组合任何类型的源站。参见 关于新版源站配置模块。
操作步骤
说明
以下步骤基于新版源站配置模块。
- 登录 火山引擎内容分发网络控制台。
- 在左侧导航栏，点击 域名管理。
- 在 域名管理 页面，找到需要配置的域名，点击 管理。
- 定位 源站清单 模块。
- 如果您使用的是旧版域名管理页面，点击 编辑配置，然后在 基础配置 标签页中定位 源站清单 模块。
- 如果您使用的是新版域名管理页面，点击 编辑域名。在页面左侧的树状配置项列表中，定位 基础配置 > 源站管理 > 源站清单。
关于新旧版域名管理页面的区别，参见 新版域名配置。
- 在 源站清单 模块中，点击 新增源站 添加一个源站。
您至少添加一个主源站，备源站是可选的。 - 根据源站的类型进行配置。
- 如果源站的类型是 源站 IP 或 源站域名，参考 源站配置说明（类型是 "源站 IP" 和 "源站域名"）。
- 如果源站的类型是 对象存储源站，参考 源站配置说明（类型是 "对象存储源站"）。
- 配置完成后，点击 提交编辑。
说明
- 关于主源站和备源站之间的切换逻辑，参见 回源重试逻辑。
- 回源时，CDN 使用的请求方法与用户请求使用的相同。默认情况下，CDN 支持的请求方法有 DELETE、GET、HEAD、POST、PUT、PATCH、CONNECT、OPTIONS。您可以在 "禁用 HTTP 方法" 中配置 CDN 不允许的请求方法。例如，为了避免用户误删源站上的文件，您可以禁用 DELETE 方法。
- 对于第三方对象存储桶源站，为了避免用户对存储桶进行误操作，建议您执行以下操作：
- 在提供对象存储服务的云厂商处，对相应的账号设置权限，以防止非预期操作。
源站配置说明（类型是 "源站 IP" 和 "源站域名"）
配置 | 说明 |
|---|---|
回源地址 | 表示一个或者多个源站地址。多个地址使用分号（;）或者换行分隔。该配置有以下说明：
说明 一个加速域名下，所有主源站加上所有备源站的地址总数不能超过 50 个。 |
权重 | 表示源站的权重，范围是 1-100，默认值是 1。在 CDN 回源时，权重越高的源站被选中的概率也越高。例如您定义了两个主源站，权重分别为 3 和 2。权重为 3 的源站被选中的概率为 60%。 |
HTTP 端口 | 表示 CDN 使用 HTTP 协议回源时访问的源站端口，取值范围是 1-65535，默认值是 |
HTTPS 端口 | 表示 CDN 使用 HTTPS 协议回源时访问的源站端口。该配置的取值范围是 1-65535，默认值是 |
回源 Host | 表示该源站服务器上的站点域名。该配置的说明如下：
|
端口配置的额外说明
您配置的 回源协议 以及相应的源站端口必须是源站支持的。否则，回源请求会失败。对于您设置的端口，您可以通过如下方式检测源站是否已开通了该端口。
- Windows：在命令提示符窗口中，运行命令
telnet <IP/domain> <port>
如果 Telnet 命令行窗口打开了，则表示源站支持配置的协议和端口。
- macOS 和 Linux：在 Terminal 窗口中，运行命令
nc -vz -w 2 <IP/domain> <port>
如果命令返回 Connection succeeded!，则表示源站支持配置的协议和端口。
源站配置说明（类型是 "对象存储源站"）
选择您的场景，然后基于场景中的描述进行相应的配置。
说明
- 要进行场景二或场景三的配置，请先 提交工单。
- 如果存储桶来自中国内地的第三方云厂商，请关注云厂商的相关声明。当用户使用默认桶域名访问存储桶时，云厂商的默认行为可能是：
- 对于特定扩展名的文件，云厂商会在响应中添加
Content-Disposition: attachment头部，强制浏览器下载文件。 - 拒绝对 APK 文件和 IPA 文件的请求。
为了让用户可以在浏览器中预览文件以及下载 APK 和 IPA 文件，您需要在云厂商的对象存储服务中添加自定义域名，参见场景二和场景三中关于配置自定义域名的描述。
- 对于特定扩展名的文件，云厂商会在响应中添加
场景一：存储桶来自火山引擎
说明
如果存储桶属于其他火山引擎主账号。，请遵循 场景三中的配置步骤。
配置 | 说明 |
|---|---|
存储桶来源 | 选择 火山引擎。 |
服务授权 | 表示当前 CDN 是否有权限对 TOS 进行跨服务访问。 |
存储桶 | 从列表中选择一个 TOS 存储桶作为源站。 |
回源 Host | 请留空，表示与存储桶地址相同。 |
私有桶访问 | 如果存储桶是私有的，您需要启用该配置。 |
权重 | 表示源站的权重，范围是 1-100，默认值是 1。在 CDN 回源时，权重越高的源站被选中的概率也越高。例如您定义了两个主源站，权重分别为 3 和 2。权重为 3 的源站被选中的概率为 60%。 |
场景二：存储桶来自阿里云或者腾讯云
说明
如果存储桶来自腾讯云，有一个 使用函数服务对文件变更自动触发 CDN 刷新预热 的最佳实践可供参考。
配置 | 说明 |
|---|---|
存储桶来源 | 选择 第三方对象存储。 |
回源鉴权方式 | 选择 阿里云 OSS 或者 腾讯云 COS。 说明 如果存储桶来自阿里云并且域名启用了 "Range 回源" 功能，请应用 阿里云 OSS 兼容配置。 |
存储桶地址 | 输入厂商分配的桶域名。例如： |
回源 Host | 如果您在 OSS 或者 COS 处为存储桶配置了自定义域名，您可以输入该自定义域名。否则，请留空，表示与存储桶地址相同。 |
私有桶访问 | 如果存储桶是私有的，您需要启用该配置。 该配置启用后，您需要提供访问凭证。CDN 会在回源请求中包含基于凭证等信息生成的签名，以访问您的私有存储桶。 说明 为了源站上内容的安全，建议您提供的访问凭证仅包含存储桶的只读权限。 |
AccessKey ID | 表示访问凭证中的 AccessKey ID，在腾讯云称为 SecretId。 |
AccessKey Secret | 表示访问凭证中的 AccessKey Secret，在腾讯云称为 SecretKey。 |
权重 | 表示源站的权重，范围是 1-100，默认值是 1。在 CDN 回源时，权重越高的源站被选中的概率也越高。例如您定义了两个主源站，权重分别为 3 和 2。权重为 3 的源站被选中的概率为 60%。 |
场景三：存储桶来自 AWS 或者来自其他云厂商
说明
如果存储桶不是来自 Amazon S3，请先联系云厂商获取使用的鉴权方式与 S3 兼容的存储桶域名。
配置 | 说明 |
|---|---|
存储桶来源 | 选择 第三方对象存储。 |
回源鉴权方式 | 选择 Amazon S3。 |
存储桶地址 | 建议选择 自定义域名，然后输入桶域名。 "自定义域名"模式下输入的桶域名无格式限制，您既可以输入云厂商分配的桶域名，也可以输入您为存储桶设置的自定义域名。 |
回源 Host | 留空表示与存储桶地址相同，支持输入自定义 Host。 |
私有桶访问 | 如果存储桶是私有的，您需要启用该配置。 说明 为了源站上内容的安全，建议您提供的访问凭证仅包含存储桶的只读权限。 |
AccessKey ID | 表示访问凭证中的 AccessKey ID。 |
AccessKey Secret | 表示访问凭证中的 AccessKey Secret。 |
权重 | 表示源站的权重，范围是 1-100，默认值是 1。在 CDN 回源时，权重越高的源站被选中的概率也越高。例如您定义了两个主源站，权重分别为 3 和 2。权重为 3 的源站被选中的概率为 60%。 |
关于新版源站配置模块
为满足业务需求，我们发布了全新升级的源站配置。处于灰度范围内的用户，其新增的域名可以使用新版本的源站配置：
- 新添加的加速域名默认使用新版的源站配置模块。
- 已添加的加速域名沿用旧版本的源站配置模块。未来，我们也会规划将已有加速域名的源站配置升级到新版本。
在您添加一个加速域名后，如果该加速域名的源站配置界面没有变化，请耐心等待。
新界面
旧版本和新版本的源站配置页面如下表所示：
旧版本 | 新版本 |
|---|---|
新特性
新版本引入了新的特性，与旧版本的区别如下表所示：
配置 | 旧版本 | 新版 |
|---|---|---|
源站地址类型 | 所有主源站的类型必须相同。如果添加一个不同类型的主源站，已有主源站会被删除。 备源站也是如此。 | 各主源站和备源站的类型可以不同。 |
主源站与备源站的搭配 | 当主源站的类型是 源站 IP 或者 源站域名 时，备源站的类型不能是 对象存储源站。 当主源站的类型是 对象存储源站 时，备源站的类型只能是 对象存储源站。 | 主源站和备源站可以是任意类型的源站组合。 |
对象存储源站的数量 | 只能存在一个类型是 对象存储源站 的主源站，一个该类型的备源站。 | 可存在多个类型是 对象存储源站 的主源站和备源站。 |
源站配置方式 | 主源站和备源站在不同的配置页面中配置。 主源站列表和备源站列表分别展示。 | 主源站和备源站在同一配置页面中配置。 主源站和备源站展示在一个源站列表中。 |