ESA边缘接入

操作步骤

1. 进入实例的部署与预览页面，切换到ESA嵌入标签页。

2. 系统会显示一条 TXT 验证记录，格式如下：

   字段	值	说明
   记录类型	TXT	—
   主机记录	_esaauth.您的域名	如验证域名为 www.example.com，则填写 _esaauth.www.example.com。可点击复制按钮快速复制。
   记录值	verify_xxxxxxxxxxxxxxxx	以页面实际展示的值为准。可点击复制按钮快速复制。

3. 登录 DNS 服务商，添加上述 TXT 记录。

   说明

   部分 DNS 服务商会自动追加域名后缀，请注意主机记录字段的实际填写值。

4. 配置完成后，点击验证并继续按钮。

5. 系统校验 TXT 记录是否生效，验证通过后自动进入下一步。

   TXT 记录生效通常需要 1~10 分钟（取决于 DNS 服务商的 TTL 设置），如验证未通过，请确认 TXT 记录的主机记录和记录值与页面展示完全一致。

预期结果

• 验证成功：页面自动跳转至步骤二引导界面。

• 验证失败：页面提示验证未通过，请检查 TXT 记录是否正确配置。

配置 DCV CNAME

1. ESA 嵌入页面展示 DCV CNAME 记录，格式如下：

   字段	值	说明
   记录类型	CNAME	—
   主机记录	_acme-challenge.您的域名	如域名为 www.example.com，则填写 _acme-challenge.www.example.com。
   记录值	您的域名.xxxxxxxx.dcv.aliyun-esa.com	以页面实际展示的值为准。

2. 登录 DNS 服务商，添加上述 CNAME 记录。

3. 配置完成后，点击验证并继续按钮。

等待证书签发

配置完成后，系统开始异步签发证书，页面展示“证书签发中”进度提示。保持页面打开，等待系统自动推进至下一步。

• 证书类型为 Let's Encrypt DV 证书，有效期 3 个月，后续自动续期，无需重复操作。

• 证书签发通常需要 30 秒至 2 分钟，请耐心等待。

• 签发期间请勿关闭页面，系统会在签发完成后自动停止检查并推进到下一步。

源站探测

证书签发成功后，系统会自动探测您网站的源站地址。

如果系统无法探测到源站地址，页面会提示“无法探测到您网站的源站地址”，并提供重新检测按钮。请确认域名对应的网站可正常访问后，点击“重新检测”。

预期结果

证书签发成功且源站探测通过后，页面自动进入步骤三引导界面。

操作步骤

1. ESA 嵌入页面展示最终的接入 CNAME 记录，格式如下：

   字段	值	说明
   记录类型	CNAME	—
   主机记录	您的域名	如接入域名为 www.example.com，则填写 www.example.com。
   记录值	{ESA 分配的站点接入地址}	以页面实际展示的值为准。

2. 登录 DNS 服务商，将域名的解析记录修改为上述 CNAME 记录。

   • 如果原记录为 A 记录（指向源站 IP），请将其修改为 CNAME 记录。

   • 如果原记录已有 CNAME（如指向 CDN），请将其修改为 ESA 接入地址。

   说明

   • 如域名已有同名的 A 记录或 CNAME 记录，请先删除旧记录再添加新记录，否则会导致解析冲突。

   • 部分 DNS 服务商不允许根域名（如 example.com，不含 www）直接设置 CNAME 记录。如果您的 DNS 服务商有此限制，请联系技术支持协助处理。

3. 配置完成后，点击完成接入按钮。

4. 系统校验 CNAME 是否正确指向 ESA 边缘，验证通过后接入完成。

预期结果

CNAME 验证通过后，页面显示“接入成功”状态，域名正式接入 ESA 边缘。

验证接入效果

1. 打开浏览器无痕模式，访问您的网站。

2. 确认页面右下角出现智能客服浮窗图标。

3. 点击图标验证对话功能正常。

零中断切换原理

• 接入前：访客直接访问您的源站。

  

• 接入后：ESA 代理您的流量，自动注入网站 AI 套件。

  

  接入后，访客的请求先经过 ESA 边缘节点（提供 HTTPS 证书与全球加速），ESA 向您的源站获取原始网页内容，注入智能客服等组件后返回给访客。您的源站无需做任何改动。

为什么全程不影响访问？

为什么需要三步流程

如果在边缘证书未就绪时直接将域名 CNAME 指向 ESA，会导致您的 HTTPS 站点降级为 HTTP，访客浏览器将显示“不安全”警告。三步流程确保先验证域名归属，再完成证书签发，最后才引导切换 CNAME。切换瞬间边缘证书已就绪，站点全程保持 HTTPS，服务不降级。

接入过程中网站会中断吗？

不会。三步引导流程确保在 CNAME 切换前，域名验证和证书签发均已完成。切换 CNAME 瞬间，ESA 边缘已持有证书，TLS 握手立即成功，访客无感知。更多介绍请参见将域名快速接入ESA。

证书到期后怎么办？

ESA 边缘证书（Let's Encrypt DV）有效期为 3 个月，系统会在到期前 30 天自动发起续签，无需做任何操作。续期过程不影响网站正常访问。

自动续签机制：域名完成 CNAME 切流（步骤三）后，ESA 边缘节点会直接响应 CA 的 HTTP-01 验证请求，无需再次手动配置 DNS 记录。步骤二中配置的 _acme-challenge CNAME 记录建议保留作为兜底，但即使被误删也不会导致续签失败（ESA 边缘 HTTP 验证可独立完成）。

更多介绍请参见DCV 托管（免费证书自动签发与续签）。

关于 DCV CNAME 记录与证书自动续签

_acme-challenge CNAME 记录在接入流程中承担两个角色：

1. 首次签发：步骤二配置时，域名尚未切换到 ESA，CA 机构通过该 CNAME 记录完成 DNS-01 方式的域名控制验证。

2. 后续续签：步骤三完成后（域名已 CNAME 指向 ESA 边缘），ESA 边缘节点可直接拦截 CA 的 HTTP-01 验证请求，自动完成续签。此时 _acme-challenge 记录已非续签的必要条件。

接入后可以修改源站地址吗？

可以。在控制台的实例设置中修改回源地址，修改后 ESA 边缘会使用新的回源地址获取网页内容。修改不影响终端用户的访问体验。

接入后如果关闭 ESA 接入会怎样？

关闭或移除 ESA 接入后，网站仍可正常访问，但 AI 套件功能将不再生效。如需退出 ESA 接入，请按以下步骤操作：

1. 在控制台关闭 ESA 接入。

2. 将域名的 CNAME 记录改回源站 IP（A 记录）或原 CDN 地址。

3. TXT 验证记录（_esaauth）和 DCV CNAME 记录（_acme-challenge）可选删除，不影响网站访问。

网站是 HTTP 的，可以接入吗？

可以。ESA 边缘接入后，访客通过 HTTPS 访问域名（ESA 边缘提供 HTTPS），ESA 边缘以 HTTP 回源到源站。接入后网站自动升级为 HTTPS，对访客来说是纯增量收益。

接入后源站升级为 HTTPS 了，需要做什么吗？

如果在接入后自行为源站部署了 HTTPS 证书，建议联系技术支持协助将 ESA 回源协议切换为 HTTPS，以实现端到端加密。如果不切换，ESA 会继续以 HTTP 回源，网站仍可正常访问。

一个域名可以接入多个 WAIS 实例吗？

不可以。一个域名只能接入一个 WAIS 实例。如果需要更换实例，请先在原实例中移除域名绑定，再在新实例中重新接入。

域名已经接入了 CDN 加速，可以接入 ESA 吗？

可以。ESA 边缘接入本身已包含全球节点加速能力，接入后域名将通过 ESA 边缘节点加速，与原 CDN 效果等同，同时额外获得 AI 智能客服等能力。

步骤三操作时，将域名的 CNAME 记录值从原 CDN 地址修改为引导页展示的 ESA 接入地址即可。修改后原 CDN 服务自动停止加速，流量改走 ESA 边缘节点。

CNAME 验证一直不通过怎么办？

1. 确认 CNAME 记录值与引导页展示的完全一致（区分大小写）。

2. 使用在线 DNS 查询工具（如阿里云网站运维检测平台）检查 CNAME 是否已生效。也可以使用 nslookup 或 dig 命令检查。

3. 等待 DNS 缓存过期（TTL），清除本地 DNS 缓存后重试。

4. 如果超过 30 分钟仍未通过，请联系技术支持。

网站 AI 套件

• 什么是网站 AI 套件

• 在网站中嵌入JavaScript代码

ESA（边缘安全加速）

• 什么是ESA

• 将域名快速接入ESA

• 什么是边缘函数

• 托管DCV

• 配置边缘证书