腾讯云内容分发网络CDN内容分发网络 CDN 相关服务迁移至 EdgeOne 工具使用指南

概述

本工具支持将腾讯云内容分发网络 CDN 服务内已接入的域名配置批量迁移至腾讯云边缘安全加速平台 EO 服务内，支持包括已接入的 CDN/ECDN/SCDN 域名。您可以通过该工具，快捷地将当前域名配置迁移至 EdgeOne 服务中。注意：该工具作为配置迁移辅助工具，迁移完成后，请您根据迁移结果日志查看迁移结果，并前往 EdgeOne 产品控制台，自行确认相关配置是否已完整迁移在 EdgeOne 内并按照预期生效。该工具不支持迁移由腾讯云运维人工协助进行的特殊配置，如果您有相关特殊配置需求，请在迁移完成后，联系腾讯云售后支持重新配置。数据及日志等相关信息不会迁移，如果您有数据及日志相关留存需求，请提前保存至本地。



前提条件

1. 已安装 Nodejs 10.0.0 版本及以上。2. 已在腾讯云控制台内创建云 API 秘钥，获取相应的 SecretId、SecretKey。可前往腾讯云访问管理 > 访问秘钥 > API 秘钥管理台内获取。3. 参考 从零开始快速接入 EdgeOne 创建完成需迁移的域名站点，建议使用 CNAME 接入的方式创建站点。

使用指南

场景示例

当前在腾讯云 CDN 内已接入加速域名 www.example.com、test.example.com 和 vod.example.com，在腾讯云 EdgeOne 服务内已创建站点 example.com，计划将 CDN 内的这三个域名服务及相关配置迁移到 EdgeOne 控制台内的对应站点下。

操作步骤

步骤1：安装依赖环境及配置迁移工具

1. 安装 nodejs，建议下载并安装18.18.2版本；2. 安装完毕之后，打开命令行工具；3. （可选）执行以下指令，用于检查node安装情况，如下所示，返回版本号，则说明安装成功；

node -vv18.18.2

4. （可选）执行以下指令，检查 npm 安装情况，如下所示，返回版本号，则说明安装成功；

npm -v9.6.7

5. 执行以下指令，下载并安装本工具包。

npm install tencentcloud-edgeone-migration-nodejs@latest

6. 执行以下指令，进入工具安装目录。

cd ./node_modules/tencentcloud-edgeone-migration-nodejs 

步骤2：迁移配置

1. 安装完成后，进入步骤1中工具的安装工具包的根目录（即:/node_modules/tencentcloud-edgeone-migration-nodejs/）下，可以找到配置文件 config.json，打开改配置文件并修改相关迁移配置，各参数配置说明如下：SecretId、SecretKey：当前需迁移的腾讯云账号云 API 密钥信息，可前往腾讯云访问管理 > 访问秘钥 > API 秘钥管理台内获取。Domains：数组格式，为 CDN 待迁移域名，可以在 腾讯云内容分发网络 CDN > 域名管理 内查看。ZoneId：字符串格式，需要迁移到腾讯云 EdgeOne 的站点对应 ID。可以在腾讯云边缘安全加速平台 EO > 站点列表内获取，如下所示：

NeedCreateDomain：布尔值，迁移至 EdgeOne 后是否需要自动创建新域名，默认为 true，如果当前已存在域名，可传 false 则只迁移配置，便于多次操作同一个域名配置迁移。配置示例如下：单个站点迁移多个站点迁移

{  "SecretId": "xxx",  "SecretKey": "xxx",    "List": [    {      "Domains": [         "www.example.com",         "test.example.com",        "vod.example.com"      ],      "ZoneId": "zone-2nrr03d36xmk"    }  ],   "NeedCreateDomain": true}

{  "SecretId": "xxx",  "SecretKey": "xxx",    "List": [    {      "Domains": [         "www.example.com",         "test.example.com",        "vod.example.com"      ],      "ZoneId": "zone-2nrr03d36xmk"    },    {      "Domains": [         "www.site.com",         "test.site.com",        "vod.site.com"      ],      "ZoneId": "zone-2dqi0sbt6gk2"    }  ],   "NeedCreateDomain": true}

说明：1. 使用此工具前，需要先在 EdgeOne 控制台上创建好对应的站点，否则无法迁移。此工具无法创建站点，只能在站点下创建域名。2. EdgeOne 产品通过根域名作为站点维度管理域名，如果您有多个域名且主域名不一致，需要创建多个站点。

步骤3：执行配置迁移

3.1 迁移 CDN/ECDN 加速相关配置

可通过该工具迁移的 CDN/ECDN 加速相关配置项详见：CDN/ECDN 加速可依赖工具迁移配置。1. 执行指令：node task.js，开始进行配置迁移，该指令用于迁移 CDN/ECDN 加速相关配置，

node task.js

2. （可选）如果您当前域名内，在控制台内配置有 IP 黑白名单配置、防盗链配置、UA 黑白名单配置，可继续参考以下步骤迁移相关配置。执行指令：node check.js，检验当前域名在 EdgeOne 内是否已经完成部署。

node check.js

等待域名部署完成后，执行指令：node access.js，迁移相关访问控制配置项。

node access.js

3.2 迁移 SCDN 相关配置

如果您当前需迁移的域名同时开启了 SCDN 安全防护，可以在完成步骤3.1 的情况下，参照如下步骤继续迁移。可通过该工具迁移的 SCDN 相关配置项详见：SCDN 可依赖工具迁移配置。1. 执行指令：node check.js，检验当前域名在 EdgeOne 内是否已经完成部署。

node check.js

2. 等待域名部署完成后，执行指令：node scdntask.js，开始执行安全相关配置迁移，该指令用于迁移域名下配置的 IP 黑白名单、防盗链、UA 黑白名单配置以及 SCDN 安全防护中的 Web 防火墙规则配置、DDoS 单点限频规则配置等。

node scdntask.js

步骤4：迁移后验证

说明：使用本工具完成域名迁移后，请您前往腾讯云 EdgeOne 控制台内,查看该域名的站点加速配置、规则引擎配置及安全防护配置是否服务预期，完成配置验证完成后，再将相关域名的加速服务切换至腾讯云 EdgeOne。

查看配置迁移结果

当迁移工具运行完毕后，会在迁移工具本地目录下会生成一个csv文件（report-${timestamp}.csv），记录了运行结果，您可以参考该文件查看迁移的结果是否成功，或者遇到的异常具体原因。

验证配置生效情况

迁移完成后，建议您验证域名访问是否符合预期，在验证完成后，再将相关服务切换至 EdgeOne 中。说明：如果您当前的站点是以 Cname 方式接入，可以参考以下方式验证。如果是以 NS 方式接入，可直接切换 NS 服务器进行验证。1. 前往 边缘安全加速平台 EO 控制台，在控制台内，点击站点列表，进入当前已迁移域名的站点；2. 点击 域名服务 > 域名管理，找到已迁移域名，查看 EdgeOne 为该域名分配的 Cname 信息。例如：www.example.com.eo.dnse3.com。

3. 获取 EdgeOne 平台为该域名分配的节点 IP 信息，可通过在命令行工具中输入 ping www.example.com.eo.dnse3.com，查看返回的对应节点 IP。

4. 将步骤3获取的节点 IP（43.152.53.230）和加速域名（www.example.com）绑定到电脑本地 hosts 文件中，如下所示：

说明：Windows 系统 Hosts 文件路径位置为 C:\Windows\System32\drivers\etc\hosts。Mac 系统 Hosts 文件路径为/etc/。5. 访问该域名下的热门 URL 内容，验证对应域名服务是否符合预迁移工具可迁移配置比对。

相关参考

CDN/ECDN 加速可依赖工具迁移配置项

SCDN 可依赖工具迁移配置项

注意：如果当前您的套餐标准版，规则匹配方式不支持 XFF、cookie 以及自定义请求头，建议您升级至企业版后迁移。

常见问题

迁移配置相关问题

如果当前域名为 ECDN 加速域名，需要动态加速，迁移到 EdgeOne 后还需要如何配置？

加速类型为 ECDN 动态加速或者 ECDN 动静加速的域名，迁移完成后，需手动开启智能加速，为域名开启动态加速。该功能为增值服务能力，相关计费标准参考：增值服务用量单元费用（后付费）。

工具提示了 HTTPS 相关配置迁移失败如何处理？

以下 HTTPS 相关配置需依赖当前在腾讯云 SSL 控制台内已上传对应的域名托管证书，如果您还未上传证书则无法完成自动迁移，需要您上传 HTTPS 证书到腾讯云 SSL 控制台后手动配置。或者将步骤2中，配置文件参数 NeedCreateDomain 更改为 false 后，再执行一次迁移。HTTPS 强制跳转启用 HTTP 2.0QuicOCSP 装订HSTS 配置TLS 版本

域名迁移时提示：该域名正在解析中，如果您需要开启加速，请前往 DNS 记录页开启加速如何处理？

如果您当前的站点是以 NS 接入，并且导入了原 DNS 记录，当新增域名已存在对应的 A 记录或者 CNAME 记录时，您可能遇到该问题。如需使用工具迁移，您可以在 EdgeOne 控制台上，删除对应域名的解析记录后，再进行迁移。注意：请注意，如果您当前已经将 NS 服务器切换至 EdgeOne，删除 DNS 记录可能会导致您的域名访问中断，可以将解析切换为原域名解析服务商，等待所有迁移就绪后，再将 NS 服务器切换至 EdgeOne 以正式启用服务。

当前域名开启了图片优化功能，在 EdgeOne 上如何使用？

EdgeOne 支持图片处理能力及边缘函数，您可以参考：通过边缘函数实现自适应图片格式转换 或者 图片处理查看如何在 EdgeOne 上实现自适应图片优化能力。

当前域名有一些境内、境外的分区域独立配置，在 EdgeOne 上如何配置？

区域独立配置暂不支持使用该工具迁移，如果您当前域名有相关配置需求，请参考使用规则引擎人工配置迁移。

产品及计费相关问题

EdgeOne 相比 CDN 产品有什么优势？

EdgeOne 的计费方式和 CDN 有什么区别？迁移到 EdgeOne 的付费方式是什么样的

EdgeOne 的费用由基础服务资费和增值服务费构成，其中基础服务资费包含套餐费用及套餐外超量费用，增值服务资费包括增值服务用量单元费用、独立 DDoS 防护相关费用、中国大陆网络优化服务费用。您也可以查看计费概述了解详细的计费方式。

现在想迁移到 EdgeOne，有相关优惠活动吗？

您可以前往边缘安全加速平台特惠，查看具体的优惠活动信息。

迁移后，CDN 内剩余的资源包可以退款吗？

可以，确认迁移完成后，如果在 CDN 上还有未使用完的资源包，可以申请退款，退款金额为购买时花费的全部消费金额按当前资源包余量等比例退款，全部消费金额包括现金账户金额、收益转入账户金额以及赠送账户金额。购买资源包所使用的代金券/折扣券不支持退还。

迁移后，SCDN 套餐还未到期，可以退款吗？

可以，确认迁移完成后，如果当前 SCDN 套餐还未到期，可以申请退款，退款金额为购买时花费的全部消费金额按当前套餐剩余有效期等比例退款，部消费金额包括现金账户金额、收益转入账户金额以及赠送账户金额。购买时所使用的代金券/折扣券不支持退还。

内容分发网络CDN官网1折活动，限时活动，即将结束，速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠