概述
本工具支持将腾讯云内容分发网络 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-v2
6. 执行以下指令，进入工具安装目录。
cd ./node_modules/tencentcloud-edgeone-migration-nodejs-v2
步骤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 加速相关配置
1. 执行指令：
node task.js，开始进行配置迁移，该指令用于迁移 CDN/ECDN 加速相关配置，node task.js
执行指令：
node check.js，检验当前域名在 EdgeOne 内是否已经完成部署。node check.js
等待域名部署完成后，执行指令：
node access.js，迁移相关访问控制配置项。node access.js
3.2 迁移 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 中。
说明：
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 加速可依赖工具迁移配置项
CDN配置 | 迁移至 EdgeOne 后配置 | |
基本信息 | 加速类型 | 无需迁移，EdgeOne 不再区分加速类型 |
? | IPv6 访问 | 不支持工具自动迁移，请在迁移完成后手动开启 |
? | 标签 | 不支持工具自动迁移，请在创建站点时或者在站点列表页内，为站点配置标签 |
源站信息 | 自有源站 | |
? | COS 源 | |
? | IGTM 多活源 | EdgeOne 暂不支持该特性 |
? | 第三方对象存储 | |
? | 热备源站 | 暂不支持迁移 |
访问控制 | 防盗链配置 | |
? | IP 黑白名单配置 | |
? | IP 访问限频配置 | EdgeOne 暂不支持该特性 |
? | 鉴权配置 | |
? | UA 黑白名单配置 | |
? | 下行限速配置 | EdgeOne 暂不支持该特性 |
? | 访问端口配置 | 无需迁移，默认开启80、8080、443访问端口 |
? | 远程鉴权 | |
缓存配置 | 缓存键规则配置 | |
? | 节点缓存过期配置 | |
? | 浏览器缓存过期配置 | |
? | 状态码缓存 | |
? | HTTP 头部缓存配置 | 无需迁移，默认开启 |
? | 访问 URL 重写配置 | |
回源配置 | 合并回源 | EdgeOne 暂不支持该特性 |
? | 分片回源配置 | |
? | 回源 HTTP 请求头配置 | |
? | 回源跟随301/302配置 | |
? | 回源超时配置 | EdgeOne 暂不支持该特性 |
? | 回源 URL 重写配置 | |
? | 回源 SNI 配置 | 无需迁移，回源协议为 HTTPS 时，默认开启回源 SNI 配置 |
HTTPS 配置 | HTTPS 服务 | 无需迁移，EdgeOne 默认支持 HTTPS 服务 |
? | HTTPS 配置 | 如果当前证书已托管在 SSL 证书内，可支持迁移配置对应的 HTTPS 证书 |
? | HTTP 2.0 | |
? | 强制跳转 | 注：仅支持迁移 HTTP 请求强制跳转至 HTTPS |
? | HSTS 配置 | |
? | TLS 版本配置 | |
? | OCSP 装订配置 | |
? | QUIC | |
高级配置 | 自定义错误页面 | |
? | 用量封顶配置 | |
? | SEO 配置 | EdgeOne 暂不支持该特性 |
? | HTTP 响应头配置 | |
? | 智能压缩 | 注：仅支持迁移为开启，不支持配置文件范围大小，压缩范围默认为 256B - 30MB |
? | 离线缓存配置 | |
? | POST请求大小配置 | |
SCDN 可依赖工具迁移配置项
SCDN配置 | 迁移至 EdgeOne 后配置 |
防火墙规则 | 匹配对象为 HTTP 版本、请求参数； 匹配对象为应用层协议、请求方式，匹配方式为不等于，需手动迁移，在 EdgeOne 内仅支持等于； 匹配对象为 referer、URI 时，匹配方式为前缀匹配， 不支持迁移。 匹配对象为自定义请求头时，匹配方式为不存在或为空时，需手动迁移，在 EdgeOne 内仅支持选择其中一种。 |
DDoS防护 | 匹配对象为 HTTP 版本、请求参数； 匹配对象为应用层协议、请求方式，匹配方式为不等于，需手动迁移，在 EdgeOne 内仅支持等于； 匹配对象为 referer、URI 时，匹配方式为前缀匹配， 不支持迁移。 匹配对象为自定义请求头时，匹配方式为不存在或为空时，需手动迁移，在 EdgeOne 内仅支持选择其中一种。 |
WAF 防护-防护配置 | |
WAF 防护-路径白名单 | |
BOT 爬虫防护 |
注意：
如果当前您的套餐标准版，规则匹配方式不支持 XFF、cookie 以及自定义请求头，建议您升级至企业版后迁移。
常见问题
迁移配置相关问题
如果当前域名为 ECDN 加速域名，需要动态加速，迁移到 EdgeOne 后还需要如何配置？
工具提示了 HTTPS 相关配置迁移失败如何处理？
以下 HTTPS 相关配置需依赖当前在腾讯云 SSL 控制台内已上传对应的域名托管证书，如果您还未上传证书则无法完成自动迁移，需要您上传 HTTPS 证书到腾讯云 SSL 控制台后手动配置。或者将步骤2中，配置文件参数
NeedCreateDomain 更改为 false 后，再执行一次迁移。?Quic?
?OCSP 装订?
?HSTS 配置?
?TLS 版本?
域名迁移时提示：该域名正在解析中，如果您需要开启加速，请前往 DNS 记录页开启加速如何处理？
如果您当前的站点是以 NS 接入，并且导入了原 DNS 记录，当新增域名已存在对应的 A 记录或者 CNAME 记录时，您可能遇到该问题。如需使用工具迁移，您可以在 EdgeOne 控制台上，删除对应域名的解析记录后，再进行迁移。
注意：
请注意，如果您当前已经将 NS 服务器切换至 EdgeOne，删除 DNS 记录可能会导致您的域名访问中断，可以将解析切换为原域名解析服务商，等待所有迁移就绪后，再将 NS 服务器切换至 EdgeOne 以正式启用服务。
当前域名开启了图片优化功能，在 EdgeOne 上如何使用？
当前域名有一些境内、境外的分区域独立配置，在 EdgeOne 上如何配置？
产品及计费相关问题
EdgeOne 相比 CDN 产品有什么优势？
? | CDN | EdgeOne |
功能丰富度 | 纯加速，不附带安全能力 | 在为域名提供内容分发加速的基础上，带有抗 DDoS 攻击、防 CC 攻击能力，同时提供边缘函数、四层代理、DNS 解析等丰富能力 |
配置灵活度 | 每个域名在控制台上按照配置项配置，无法灵活组合 | 支持规则引擎、边缘函数等灵活的配置方式，可根据需求自定义边缘回源规则以及响应规则 |
运维难度 | 需要手动更新证书，按照域名维度维护配置 | 支持免费证书自动更新，提供站点级维度配置，可通过一条规则即可将配置下发至多个域名 |
避险能力 | 被攻击将产生超额流量付费，受攻击风险高 | 按照清洗后流量计费，无需担心攻击带来的高额账单 |
EdgeOne 的计费方式和 CDN 有什么区别？迁移到 EdgeOne 的付费方式是什么样的
EdgeOne 的费用由基础服务资费和增值服务费构成，其中基础服务资费包含套餐费用及套餐外超量费用，增值服务资费包括增值服务用量单元费用、独立 DDoS 防护相关费用、中国大陆网络优化服务费用。您也可以查看计费概述了解详细的计费方式。
现在想迁移到 EdgeOne，有相关优惠活动吗？
迁移后，CDN 内剩余的资源包可以退款吗？
可以，确认迁移完成后，如果在 CDN 上还有未使用完的资源包，可以申请退款，退款金额为购买时花费的全部消费金额按当前资源包余量等比例退款，全部消费金额包括现金账户金额、收益转入账户金额以及赠送账户金额。购买资源包所使用的代金券/折扣券不支持退还。
迁移后，SCDN 套餐还未到期，可以退款吗？
可以，确认迁移完成后，如果当前 SCDN 套餐还未到期，可以申请退款，退款金额为购买时花费的全部消费金额按当前套餐剩余有效期等比例退款，部消费金额包括现金账户金额、收益转入账户金额以及赠送账户金额。购买时所使用的代金券/折扣券不支持退还。
?
