当您的站点通过NS或CNAME方式接入ESA后，需添加DNS记录以确保域名正确解析并加速访问。ESA提供批量导入和手动输入两种方法，本文将指导如何快速完成DNS记录的添加。
前提条件
在添加DNS记录前，请确保已满足以下条件：
您的站点已通过NS或CNAME方式接入ESA。
您拥有DNS服务商的解析管理权限，可以添加或修改DNS记录。
您了解常用DNS记录类型（如A、CNAME、MX、TXT等）的基本概念和用途。
注意事项
新增或者修改DNS记录时，需要同时检查主机名和源站的值：
主机名的值不能是已经添加的某个DNS记录的主机名或者源站，也不能是某个源地址池中的源站。
源站的值不能是已经添加的某个DNS记录的主机名。
CNAME 记录的记录值/源站必须填写实际源站地址，例如 OSS 外网域名（
xxx.oss-cn-hangzhou.aliyuncs.com）或 ECS 公网 IP（源站为 IP 时需选择 A 记录类型）。禁止将记录值/源站填写为加速域名本身或与主机记录相同的值，否则会导致配置报错或解析循环。在同一主机记录下，若已存在 A 记录，添加 CNAME 记录时会报冲突错误，需先删除冲突的 A 记录，再添加 CNAME 记录。ESA 不支持针对同一域名下的部分链接、IP 或特定客户端（如 App）单独配置直连或分流，代理状态开关仅支持到主机记录维度。如需直连源站，请配置独立域名并使用 A 记录指向源站 IP。
若在控制台添加源站配置时无法保存，请检查记录类型是否选择正确。例如，源站为 IP 地址时需选择 A 记录，源站为域名时需选择 CNAME 记录。
方式一：批量导入DNS记录
如果需要添加多条记录，可通过编辑模板的形式批量添加。该方法主要适用于已在其他DNS服务商处存在DNS记录，现需将这些记录添加在ESA的场景。如果需要添加单条记录，请参见手动输入DNS记录。
在ESA控制台选择站点管理，在站点列单击目标站点。
选择，单击导入。
选择模板导入，单击下载文件模版，在模板中编辑DNS记录信息并保存，然后单击选择文件上传，选择保存的模板。
在导入页面，检查并调整记录的配置情况。
ESA默认仅提供DNS解析服务，如需启用ESA加速效果，可开启代理状态列的代理加速开关。
说明以CNAME方式接入的站点，默认开启代理加速开关，不支持修改代理状态。
以NS方式接入的站点，仅A/AAAA和CNAME类型的记录支持开启或关闭代理加速。
关于不同业务场景的选择，请参见适用场景说明。
完成DNS记录调整后，单击确定导入。
（可选）以CNAME方式接入的站点，在添加完记录后可根据界面向导，前往DNS服务商处配置CNAME记录。
方式二：手动输入DNS记录
如果需要添加单条记录，可手动输入DNS记录信息。该方法主要适用于未在其他DNS服务商处添加记录或要添加少量记录的场景。
场景示例
假设源站域名为example.com，现需为子域名www.example.com的网页页面加速，选择的DNS记录类型为CNAME。以该信息为例，介绍如何手动输入DNS记录。
操作步骤
在ESA控制台选择站点管理，在站点列单击目标站点。
选择，单击添加记录。
根据界面提示填写相关参数，然后单击下一步。更多记录类型和参数信息，请参见添加记录参数介绍。
参数名
说明
示例值
记录类型
选择记录类型。
CNAME主机记录
指子域名的前缀。支持小写字母、数字、通配符
*（仅作为泛域名记录添加）、连字符-（不能以连字符开头或结尾）、@（仅作为根域名记录添加）、下划线_（仅在未开启代理加速下的 TXT、CAA、CNAME、NS、SRV 记录开头处支持），最长不超过63个字符。www代理状态
打开状态开关，开启代理加速。
开启
记录值/源站
选择记录值的类型。
域名
域名
输入源站域名。
example.com回源HOST
默认为跟随请求HOST，无需修改。若未配置回源规则，默认规则：回源HOST按DNS记录中设置的HOST策略；回源SNI跟随回源HOST的值；回源协议和端口默认跟随客户端请求的协议和端口。
跟随请求HOST
HTTP 端口/HTTPS端口
当DNS记录开启代理加速时，端口配置将会生效，ESA加速节点仅允许您配置的端口处理请求。HTTP协议默认支持
80、8080、8880、2052、2082、2086、2095端口，HTTPS协议默认支持443、8443、2053、2083、2096、2087端口。除80和443端口，其余端口您可自行关闭。如您需要其他端口，请升级至企业版后开通自定义端口功能（注意：自定义端口功能与中国大陆网络优化、固定IP功能互斥，不支持同时开启）。8080
待加速的业务场景选择为网站页面，单击完成。关于不同业务场景的选择，请参见适用场景说明。
（可选）以CNAME方式接入的站点，在添加完记录后可根据界面向导，前往DNS服务商处配置CNAME记录。
接入验证与生效说明
CNAME 接入验证
以 CNAME 方式接入时，仅在 ESA 控制台添加 DNS 记录不会影响原域名访问。还需在 DNS 服务商处将域名精准解析（非泛解析）指向 ESA 提供的专属 CNAME 地址，方可生效。可使用以下命令验证解析是否正确指向 ESA 节点：
# 验证CNAME解析
dig www.example.com CNAME
# 测试连通性
ping www.example.com若解析未正确指向 ESA 节点，可能出现以下异常：
访问域名返回 530 错误。
控制台中证书绑定入口缺失。
控制台流量监控页面无流量数据。
NS 接入生效时效
以 NS 方式接入时，需在域名注册商处修改 NS 记录。修改完成后，全球生效最长需 48 小时，期间控制台可能暂无流量显示，属正常现象。
状态异常排查
若 DNS 记录已配置完成，但控制台显示待配置，常见原因如下：
域名解析被修改为指向其他服务（如 WAF），导致 ESA 无法检测配置状态。
若仅配置了海外解析，控制台显示待配置属正常现象，只要解析已正确指向 ESA 海外节点，不影响加速效果。
适用场景说明
在DNS记录的场景配置中，ESA提供5种业务场景。结合实际业务场景选择对应场景类型，可为域名动态分配更匹配的安全加速策略。可通过控制台随时编辑记录并调整业务类型。
应用场景 | 说明 |
网站页面 | 适用于加速小文件和API请求动静混合的网站业务。例如：个人博客网站、小型UGC社区、小型电商独立站等场景。 |
大文件下载 | 适用于大文件分发场景，例如：软件安装包（APP、游戏、客户端等）、补丁更新、固件升级等场景。通过边缘节点缓存大文件，降低源站压力，提升下载速度。 |
音视频点播 | 适用于加速音视频点播分发业务。例如：短视频点播、直播回放等场景。 |
API 加速 | 适用于加速纯动态的API接口类业务，该类业务一般无需缓存。例如：账号密码校验接口、下单支付接口、日志上传接口、数据实时同步等场景。 |
AI Tokens（词元） | 适用于AI大模型推理场景，加速词元（Token）级别的高频小请求。例如：大语言模型（LLM）的流式推理接口、词元级实时翻译、智能客服对话等场景。通过边缘加速降低Token请求的端到端延迟。 |
常见问题
Q：可以直接导入从其他 CDN 导出的 CSV 文件吗？
不支持。ESA 不支持直接导入其他 CDN 导出的 CSV 文件，因为各平台的记录值格式不同。如需迁移 DNS 记录，请手动添加记录，并将 CNAME 值修改为 ESA 提供的专属 CNAME 地址。
Q：ESA 托管的解析记录，是否需要在 ESA 解析中手动重新添加？
不需要。ESA 托管的解析记录会自动同步管理，无需手动重复添加，否则可能导致记录冲突。
Q：如何查看域名的接入模式、业务场景和 CNAME 指向？
登录 ESA 控制台，进入，可查看域名当前的接入模式、业务场景（如 API 加速）及 CNAME 指向，以此判断是否已开启智能路由等高级功能。
Q：访问域名时报错 DNS_PROBE_FINISHED_NXDOMAIN，如何排查？
建议按以下步骤排查：
检查域名拼写是否正确。
使用
ping命令测试连通性：ping www.example.com若
ping命令返回解析失败，请检查 DNS 服务商处的记录是否已正确配置并生效。