使用自有 ESA 接入万小智网站

工作原理

自有 ESA 接入采用 CNAME 接入方式：通过将自定义访问域名的 DNS 解析指向阿里云 ESA，由 ESA 提供边缘代理加速，并将请求回源至万小智源站。

访客请求的完整路径如下：

1. 发起请求：访客在浏览器中访问您的网站域名（例如 www.example.com）。

2. DNS 解析与接入：DNS 服务商将该域名解析至 ESA 分配的专属 CNAME 地址，访客请求随之到达 ESA 边缘节点。

3. 边缘加速与回源鉴权：若请求命中 ESA 边缘缓存，节点将直接向访客返回内容；若未命中缓存（或请求动态内容），ESA 则会按照预设的回源规则，通过 HTTPS 协议（443 端口）向万小智提供的源站地址发起回源请求，并自动携带专属鉴权请求头（通常为 X-WXZ-Origin-Token）以完成源站身份校验。

4. 内容响应：万小智源站校验通过后返回网站内容，经由 ESA 边缘节点响应给访客（并按策略缓存静态资源）。

各组件分工：

• DNS 服务商：负责将您的访问域名 CNAME 解析至自有 ESA。

• 自有 ESA：负责接收访客流量、提供边缘代理加速、按规则发起 HTTPS 回源，并在回源时注入鉴权请求头（Header）。

• 万小智平台：负责提供源站地址、鉴权请求头名称及 Token 凭证，并作为最终源站承载与响应网站内容。

适用范围

接入自有 ESA 前，需满足以下条件：

• 万小智应用已发布，且具备自有 ESA 接入权益（万小智高级版）。

• 已开通ESA，并拥有访问域名和目标 ESA 站点的管理权限，且 ESA 站点的接入方式为 CNAME 接入。

• 如加速区域包含中国内地，访问域名已按 ESA 要求完成备案。

计费说明

• 自有 ESA 的费用按其套餐及计费规则另行结算，详情请参见ESA产品计费。

• 使用自有 ESA 不代表全部流量均由自有 ESA 承载。通过万小智平台地址访问的素材、文件等资源，以及其他未经过自有 ESA 的请求，仍可能消耗万小智流量额度。

• 仅万小智高级版支持自有ESA接入。

步骤一：添加域名并获取回源配置

1. 登录万小智控制台，进入目标应用后，在左侧导航栏选择部署 > 域名管理。

2. 单击绑定域名，选择我有域名。

3. 填写域名地址（例如 www.example.com），接入方式选择改用自有ESA接入。

   说明

   • 域名不包含 https://、端口或路径，根域名和 www 子域名需分别添加。

   • 同一应用的多个域名可以共用回源配置，不同应用不能混用。

4. 在域名列表操作栏中，单击查看回源配置，复制回源地址、Header名称和完整 Token。

   域名添加成功仅表示已关联应用，不代表 ESA 接入已生效。回源配置准备中时，需等待就绪后再继续。

步骤二：配置 ESA 源站和回源参数

1. 登录 ESA 控制台，进入目标站点。

2. 配置域名源站：在 DNS > 记录中，添加或编辑访问域名对应的记录。

   参数	配置
   记录类型	CNAME
   主机记录	例如 www；根域名使用 @
   代理状态	开启代理加速
   记录值/源站	选择域名
   域名	填写万小智提供的回源地址 说明 只填写域名，不包含协议或路径，例如 wsxxxxxxxxxxxxxxxxxxxx.origin.wanwang.xin。
   回源 Host	选择跟随源站域名

3. 配置回源参数：在规则 > 回源规则中，匹配当前应用的访问域名，配置以下参数。

   参数	配置
   规则名称	填写自定义名称即可
   传入请求类型	所有传入请求
   回源 Host	填写万小智提供的回源地址
   回源协议	HTTPS
   HTTPS 回源端口	443
   回源 SNI	填写万小智提供的回源地址
   回源证书校验	开启

   如果另有回源 Host 规则，应将其配置为同一个万小智回源地址，避免覆盖 DNS 记录中的“跟随源站域名”设置。

   重要

   • 源站、回源 Host 和 SNI 请使用万小智提供的回源地址，不应填写访问域名。

   • 如果 ESA 站点承载多个应用，需限定规则的域名匹配范围，避免影响其他业务。

   DNS 记录和回源规则的完整配置说明，参见管理 DNS 记录与回源规则。

步骤三：配置回源鉴权

在规则 > 转换规则 > 修改请求头中，选择 ESA 到源站，新增规则并匹配当前应用的访问域名。

回源请求需携带指定 Token，并覆盖访问请求中的同名请求头。请勿仅配置“变更已有请求头”，也不要通过后续规则删除或覆盖该请求头。

步骤四：配置网页响应头

若网页响应携带附件下载相关响应头（例如 Content-Disposition: attachment），导致浏览器下载 HTML 文件而非展示页面。此时可为首页配置以下响应头规则。

1. 在规则 > 转换规则 > 修改响应头中，选择 ESA 到客户端，单击新增规则。

2. 传入请求类型选择自定义规则，设置匹配条件：

   • 主机名：等于当前访问域名，例如 www.example.com。

   • URI ：等于/。

   • 两个条件使用且（And）连接。

3. 配置以下响应头操作。

   类型	操作方式	响应头名称	响应头值
   静态	删除	Content-Disposition	无需填写
   静态	删除	x-oss-force-download	无需填写
   静态	添加	Content-Type	text/html; charset=utf-8

4. 保存并启用规则，确认后续规则不会覆盖上述配置。

响应头转换规则的完整说明，参见修改出站响应头。

步骤五：配置 HTTPS 证书与域名解析

1. 在 ESA 中为访问域名配置有效的 HTTPS 证书，完成域名验证。详细操作，请参见配置边缘证书。

2. 在 DNS 服务商处，将访问域名解析到 ESA 分配的专属 CNAME 地址，而非万小智回源地址。

   域名接入 ESA 的详细说明，参见将域名接入 ESA。

3. 配置生效后，通过访问域名验证接入结果：

   • 首页正常展示，不触发 HTML 下载。

   • 图片、JavaScript 和 CSS 正常加载。

   • 页面刷新、子路径及网站功能正常。

   • 浏览器未提示 HTTPS 证书异常。

   说明

   • 直接访问万小智回源地址时，请求未携带有效 Token，可能返回 403，需通过访问域名验证接入效果。

   • 首次接入建议暂不缓存响应，验证通过后再配置缓存策略。

后续管理

• 新增域名：在万小智中添加域名，并在 ESA 中配置对应的解析、证书和回源规则。

• 更新 Token：在万小智的自有 ESA 回源配置中获取 Token 后，同步更新当前应用所有相关的 ESA 回源规则。

• 移除域名：在万小智中移除关联，并自行调整 ESA 和 DNS。万小智不会自动修改当前账号下的配置。

问题排查

在此接入模式下，万小智负责网站内容托管、访问域名绑定及平台侧回源服务；自有 ESA 配置、DNS 解析、域名 SSL 证书及 ICP 备案则由您自行维护与管理。若遇到异常，请根据问题归属参考下表进行排查，或选择对应的工单渠道获取支持：