CDN 提供预发布版本功能。该功能支持对加速域名的配置进行多版本管理，并提供了一个预发布环境，用于在将配置发布到线上环境之前进行测试。

功能介绍

预发布版本功能支持以下操作：

• 版本化管理配置：支持为单个域名创建和维护多个配置版本。可根据不同的业务需求或测试目的，保存多套独立的配置方案。
• 预发布环境测试：在将配置变更正式应用到线上环境之前，可先将指定的配置版本发布到预发布环境。预发布环境是一个独立的测试环境，用于验证配置的正确性，而不会影响线上用户的访问。
• 一键发布与回滚：在预发布环境中完成测试后，支持一键将配置发布到线上环境。如果线上业务出现非预期行为，也支持回滚到上一个稳定的配置版本。
• 配置差异对比：支持对比线上版本与指定版本的配置差异，以便了解版本间的变更。

适用场景

在以下场景中，预发布版本功能有助于更安全、高效地管理 CDN 配置，实现 "先测试、后上线" 的规范化发布流程。

• 重大活动前的配置变更。
• 新功能上线。
• 复杂或高风险配置的验证。

使用限制

• 预发布环境不支持对加速区域为 **全球（不含中国内地）**的域名进行测试。对此类域名进行测试时，预发布节点会因访问区域与配置区域不匹配而返回 403 错误。
• 一个域名下最多可以创建 10 个配置版本。
• 对于存在代运维配置的域名，当一个版本发布到线上环境时，该版本内的配置仅会覆盖线上环境中自主配置的内容，不会对代运维配置产生任何影响。代运维配置指的是由火山引擎运维团队管理的配置。
• 为保障预发布环境的稳定性，预发布节点设置了 QPS 限制，每个域名的 QPS 上限是 10。在测试时，请注意控制请求的 QPS。
• 您无法通过版本测试 IPv6 配置和加速区域的配置。这两个配置仅对线上环境生效。

工作流程

使用预发布版本功能的流程如下：

页面元素说明

预发布环境区域

该区域显示当前发布在预发布环境的版本。您可以在该区域进行以下操作：

• 切换版本
• 回滚版本
• 将当前版本发布到线上环境

线上环境区域

该区域显示当前生效于线上环境的版本。您可以在该区域进行以下操作：

• 切换版本
• 回滚版本

版本列表

参见 查看版本信息。

操作步骤

步骤一：创建版本

1. 登录 内容分发网络控制台。
2. 在左侧导航栏，选择 域名管理。
3. 在域名列表中，找到目标域名，并点击 管理。
4. 点击 预发布版本 标签页。
5. 在版本列表中，定位一个基础版本，然后在 操作 列点击 复制并创建。新创建版本会继承所选版本的全部配置。
6. 在 复制并创建版本 页面，修改域名配置，然后点击 提交。

步骤二：修改版本配置

1. 在版本列表中，定位需要修改的版本，然后在 操作 列，点击 修改。
2. 在配置页面中，修改域名配置。
3. 完成修改后，点击 保存配置。

步骤三：发布版本到预发布环境

1. 在 预发布环境 区域，从下拉列表中选择需要发布的版本。
2. 在弹出的 确认切换版本 对话框中，点击 确定。

步骤四：在预发布环境测试域名配置

CDN 为预发布环境提供了专用的代理服务器。

• 代理服务器域名：staging.edgeceler.com
• 端口：80（HTTP）或 443（HTTPS）

您需要在客户端（例如 curl）中指定预发布环境的代理服务器。

curl 测试示例

假设加速域名是 www.example.com，测试文件为 /test.txt。

在预发布环境的版本中，如果 HTTPS 未启用，您可以运行以下任意命令访问测试文件：

• curl -v http://www.example.com/test.txt -x staging.edgeceler.com:80
• curl -v http://www.example.com/test.txt --connect-to www.example.com:80:staging.edgeceler.com:80

如果 HTTPS 已启用，您可以运行以下命令：

• curl -v https://www.example.com/test.txt --connect-to www.example.com:443:staging.edgeceler.com:443

步骤五：发布版本到线上环境

1. 在预发布环境中完成测试并确认配置无误后，在 预发布环境 区域，点击 升级。
2. 在弹出的确认对话框中，点击 确定。该操作会将当前预发布环境中的配置版本发布到线上环境。

其他版本管理操作

查看版本信息

版本列表展示了域名的所有配置版本，并按创建时间降序排列。

回滚版本

• 回滚预发布环境：在 预发布环境 区域，点击 回滚，将预发布环境恢复到上一个发布的版本。
• 回滚线上环境：在将预发布环境中的配置发布到线上环境之后，如果出现问题，您可以在 线上环境 区域点击 回滚，将线上环境恢复到上一个发布的稳定版本。

对比版本差异

1. 在版本列表中，定位需要与线上版本对比的版本。
2. 在 操作 列，点击 对比。

页面会展示两个版本的配置差异。在左侧的 CDN 特性列表中，存在差异的特性会以圆点标记，如下图所示。

删除版本

对于未发布到任何环境的版本，您可以在 操作 列点击 删除。