使用自定义域名
发布 Web 应用后,可以将自己持有的域名绑定到该应用。完成绑定后,用户可以通过自定义域名访问生产版本。
开始前
准备以下内容:
- 已成功发布的 Web 应用
- 自己持有并完成 ICP 备案的域名
- 对应域名的阿里云 DNS 管理权限
Zion 当前仅支持已通过阿里云完成备案、并使用阿里云 DNS 解析的域名。备案流程参阅阿里云 ICP 备案文档 。
使用子域名(例如 app.example.com)通常可以避免根域名上的邮箱和其他 DNS 记录发生冲突。
添加自定义域名
输入域名
在自定义域名页面输入已完成备案的域名,并确认备案状态。一个项目可以添加多个自定义域名,并将其中一个设为默认域名。
验证域名所有权
Zion 会生成一条 TXT 验证记录。在阿里云 DNS 控制台添加页面显示的记录:
- 记录类型:
TXT - 主机记录:
verification - 记录值:复制 Zion 页面生成的值
- 解析请求来源:默认
保存记录后返回 Zion,点击检查状态。DNS 记录可能需要一段时间才能生效。


配置 CNAME 记录
所有权验证通过后,按照 Zion 页面显示的名称和值,在阿里云 DNS 中添加两条 CNAME 记录。它们用于将域名指向 Zion,并完成 HTTPS 证书和访问代理配置。
- 记录类型:
CNAME - 主机记录:填写 Zion 显示的名称前缀;阿里云会自动补全主域名。使用根域名时填写
@。 - 记录值:复制 Zion 页面显示的目标地址。


⚠️
CNAME 记录冲突
同一个主机记录通常不能同时配置 CNAME 和 A、MX、TXT 等其他记录。添加 CNAME 时出现记录冲突,可以按以下顺序检查:
- 找到相同主机记录下已有的 A、CNAME 或 TXT 记录。
- 确认这些记录是否仍在使用,再暂停或删除冲突记录。
- 如果根域名存在邮箱 MX 记录,改用子域名绑定应用。
- 等待 DNS 缓存更新后,再返回 Zion 检查状态。
不要删除用途不明的 DNS 记录,以免影响邮箱或其他线上服务。
设置网站图标
根据需要上传 Web 应用的网站图标。推荐使用 32 × 32 像素的 .ico 文件。
保存并发布
保存自定义域名配置,等待页面显示配置成功。然后返回编辑器重新发布应用,使域名和网站图标应用到生产版本。

管理自定义域名
- 默认域名:添加多个域名后,可以指定其中一个为默认域名;其他域名会重定向到默认域名。
- 修改配置:未保存的域名配置会保留 24 小时。配置保存后,仅网站图标可以直接修改;如需更换域名,需要删除后重新添加。
- 删除域名:删除全部自定义域名后,应用恢复使用 Zion 提供的默认域名。
Last updated on