tencent cloud

文档反馈

CDN 迁移至 EdgeOne 工具使用指南

最后更新时间:2024-11-07 10:39:44

    概述

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

    前提条件

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

    使用指南

    场景示例

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

    操作步骤

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

    1. 安装 nodejs,建议下载并安装18.18.2版本;
    2. 安装完毕之后,打开命令行工具;
    3. (可选)执行以下指令,用于检查node安装情况,如下所示,返回版本号,则说明安装成功;
    node -v
    v18.18.2
    4. (可选)执行以下指令,检查 npm 安装情况,如下所示,返回版本号,则说明安装成功;
    npm -v
    9.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 密钥管理台内获取。
    AppID: 需要迁移的腾讯云账号ID,可通过控制台的账号信息 > 基本信息查看获取。
    Domains:数组格式,为 CDN 待迁移域名,可以在 腾讯云内容分发网络 CDN > 域名管理 内查看。
    ZoneId:字符串格式,需要迁移到腾讯云 EdgeOne 的站点对应 ID。可以在腾讯云边缘安全加速平台 EO > 站点列表内获取,如下所示:
    
    
    NeedCreateDomain:布尔值,迁移至 EdgeOne 后是否需要自动创建新域名,默认为 true,如果当前已存在域名,可传 false 则只迁移配置,便于多次操作同一个域名配置迁移。
    配置示例如下:
    单个站点迁移
    多个站点迁移
    {
    "SecretId": "xxx",
    "SecretKey": "xxx",
    “AppId”:"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:执行配置迁移

    可通过该工具迁移的 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
    说明:
    以上指令默认输出为中文日志,如果您需要切换至英文,可以在指令后加上 en,例如:node task.js ennode check.js ennode access.js en.

    步骤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 加速可依赖工具迁移配置项

    CDN配置
    迁移至 EdgeOne 后配置
    基本信息
    加速类型
    无需迁移,EdgeOne 不再区分加速类型
    IPv6 访问
    迁移至 EO 的域名级配置。
    标签
    不支持工具自动迁移,请在创建站点时或者在站点列表页内,为站点配置标签
    源站信息
    自有源站
    迁移至源站组列表
    COS 源
    迁移至源站组列表
    IGTM 多活源
    将 IGTM 多活源的域名迁移至 EO 对应域名的源站信息。
    第三方对象存储
    不支持工具自动迁移,请在迁移后在源站组列表内进行配置
    热备源站
    暂不支持迁移,迁移后请前往 EdgeOne 负载均衡(需加白申请)进行配置。
    访问控制
    防盗链配置
    迁移至 Web 防护-自定义规则内,生成基础访问管控规则
    IP 黑白名单配置
    迁移至 Web 防护-自定义规则内,生成基础访问管控规则
    IP 访问限频配置
    EdgeOne 暂不自动迁移,在域名迁移后, 请前往 EdgeOne web 防护速率限制进行设置
    鉴权配置
    迁移至规则引擎内,功能介绍可参考:Token 鉴权
    UA 黑白名单配置
    迁移至 Web 防护-自定义规则内,生成基础访问管控规则
    下行限速配置
    EdgeOne 暂不支持该特性
    访问端口配置
    无需迁移,默认开启80、8080、443访问端口
    远程鉴权
    不支持迁移,可在迁移完成后,通过边缘函数自行配置,参考文档:远程鉴权
    缓存配置
    缓存键规则配置
    迁移至规则引擎内,功能介绍可参考:自定义 Cache Key
    节点缓存过期配置
    迁移至规则引擎内,功能介绍可参考:节点缓存 TTL
    浏览器缓存过期配置
    迁移至规则引擎内,功能介绍可参考:浏览器缓存 TTL
    状态码缓存
    迁移至规则引擎内,功能介绍可参考:状态码缓存 TTL
    HTTP 头部缓存配置
    无需迁移,默认开启
    访问 URL 重写配置
    迁移至规则引擎内,功能介绍可参考:访问 URL 重写
    回源配置
    合并回源
    EdgeOne 暂不支持该特性
    分片回源配置
    迁移至规则引擎内,功能介绍可参考:分片回源
    回源 HTTP 请求头配置
    迁移至规则引擎内,功能介绍可参考:修改 HTTP 回源请求头
    回源跟随301/302配置
    迁移至规则引擎内,功能介绍可参考:回源跟随重定向
    回源超时配置
    迁移至规则引擎内,功能介绍可参考:回源超时配置
    回源 URL 重写配置
    迁移至规则引擎内,功能介绍可参考:回源 URL 重写
    回源 SNI 配置
    无需迁移,回源协议为 HTTPS 时,默认开启回源 SNI 配置
    HTTPS 配置
    HTTPS 服务
    无需迁移,EdgeOne 默认支持 HTTPS 服务
    HTTPS 配置
    如果当前证书已托管在 SSL 证书内,可支持迁移配置对应的 HTTPS 证书
    HTTP 2.0
    迁移至规则引擎内,功能介绍可参考:HTTP/2
    强制跳转
    迁移至规则引擎内,功能介绍可参考:强制 HTTPS 访问
    注:仅支持迁移 HTTP 请求强制跳转至 HTTPS
    HSTS 配置
    迁移至规则引擎内,功能介绍可参考:启用 HSTS
    TLS 版本配置
    迁移至规则引擎内,功能介绍可参考:配置 SSL/TLS 安全等级
    OCSP 装订配置
    迁移至规则引擎内,功能介绍可参考:开启 OCSP 装订
    QUIC
    迁移至规则引擎内,功能介绍可参考:启用 HTTP/3
    高级配置
    自定义错误页面
    迁移至规则引擎内,功能介绍可参考:自定义错误页面
    用量封顶配置
    迁移至用量封顶策略
    SEO 配置
    EdgeOne 暂不支持该特性
    HTTP 响应头配置
    迁移至规则引擎内,功能介绍可参考:修改 HTTP 节点响应头
    智能压缩
    迁移至规则引擎内,功能介绍可参考:智能压缩
    注:仅支持迁移为开启,不支持配置文件范围大小,压缩范围默认为 256B - 30MB
    离线缓存配置
    迁移至规则引擎内,功能介绍可参考:离线缓存
    POST请求大小配置
    迁移至规则引擎内,功能介绍可参考:最大上传大小

    常见问题

    迁移配置相关问题

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

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

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

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

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

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

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

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

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

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

    产品及计费相关问题

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

    
    CDN
    EdgeOne
    功能丰富度
    纯加速,不附带安全能力
    在为域名提供内容分发加速的基础上,带有抗 DDoS 攻击、防 CC 攻击能力,同时提供边缘函数、四层代理、DNS 解析等丰富能力
    配置灵活度
    每个域名在控制台上按照配置项配置,无法灵活组合
    支持规则引擎、边缘函数等灵活的配置方式,可根据需求自定义边缘回源规则以及响应规则
    运维难度
    需要手动更新证书,按照域名维度维护配置
    支持免费证书自动更新,提供站点级维度配置,可通过一条规则即可将配置下发至多个域名
    避险能力
    被攻击将产生超额流量付费,受攻击风险高
    按照清洗后流量计费,无需担心攻击带来的高额账单

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

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

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持