Skip to Content
帮助文档发布与运维使用自定义域名

使用自定义域名

发布 Web 应用后,可以将自己持有的域名绑定到该应用。完成绑定后,用户可以通过自定义域名访问生产版本。

开始前

准备以下内容:

  • 已成功发布的 Web 应用
  • 自己持有并完成 ICP 备案的域名
  • 对应域名的阿里云 DNS 管理权限

Zion 当前仅支持已通过阿里云完成备案、并使用阿里云 DNS 解析的域名。备案流程参阅阿里云 ICP 备案文档

使用子域名(例如 app.example.com)通常可以避免根域名上的邮箱和其他 DNS 记录发生冲突。

添加自定义域名

输入域名

在自定义域名页面输入已完成备案的域名,并确认备案状态。一个项目可以添加多个自定义域名,并将其中一个设为默认域名。

验证域名所有权

Zion 会生成一条 TXT 验证记录。在阿里云 DNS 控制台添加页面显示的记录:

  • 记录类型TXT
  • 主机记录verification
  • 记录值:复制 Zion 页面生成的值
  • 解析请求来源:默认

保存记录后返回 Zion,点击检查状态。DNS 记录可能需要一段时间才能生效。

Zion 显示的域名 TXT 验证记录在阿里云 DNS 中添加 TXT 验证记录

配置 CNAME 记录

所有权验证通过后,按照 Zion 页面显示的名称和值,在阿里云 DNS 中添加两条 CNAME 记录。它们用于将域名指向 Zion,并完成 HTTPS 证书和访问代理配置。

  • 记录类型CNAME
  • 主机记录:填写 Zion 显示的名称前缀;阿里云会自动补全主域名。使用根域名时填写 @
  • 记录值:复制 Zion 页面显示的目标地址。
在阿里云 DNS 中添加第一条 CNAME 记录在阿里云 DNS 中添加第二条 CNAME 记录
⚠️

CNAME 记录冲突

同一个主机记录通常不能同时配置 CNAME 和 A、MX、TXT 等其他记录。添加 CNAME 时出现记录冲突,可以按以下顺序检查:

  1. 找到相同主机记录下已有的 A、CNAME 或 TXT 记录。
  2. 确认这些记录是否仍在使用,再暂停或删除冲突记录。
  3. 如果根域名存在邮箱 MX 记录,改用子域名绑定应用。
  4. 等待 DNS 缓存更新后,再返回 Zion 检查状态。

不要删除用途不明的 DNS 记录,以免影响邮箱或其他线上服务。

设置网站图标

根据需要上传 Web 应用的网站图标。推荐使用 32 × 32 像素的 .ico 文件。

保存并发布

保存自定义域名配置,等待页面显示配置成功。然后返回编辑器重新发布应用,使域名和网站图标应用到生产版本。

发布使用自定义域名的 Web 应用

管理自定义域名

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