HTTP/S 通道自定义域名

HTTP 和 HTTPS 通道支持绑定自己的域名。绑定后，客户可以直接通过自己的域名访问本地网站或接口，例如 http://test.zosen.link 或 https://test.zosen.link，不需要再使用平台分配的端口访问地址。

开始前准备

请先确认你已经具备以下条件：

准备项	说明
已绑定的客户端	客户端需要在线，平台才能把通道配置下发到本地。
本地 Web 服务	例如本地网站运行在 127.0.0.1:8080。
可管理的域名	需要能登录域名服务商或云解析控制台添加 DNS 记录。
计划使用的子域名	例如 test.zosen.link、www.example.com、api.example.com。

推荐使用子域名

推荐使用 www、api、test 这类子域名做 HTTP/S 通道。根域名通常写作 @，部分域名服务商不允许根域名直接配置 CNAME。

1. 创建 HTTP/S 通道

登录控制台，进入左侧菜单的 通道 页面，点击 创建通道。通道类型选择 HTTP 或 HTTPS，然后填写本地地址、本地端口和自定义域名。

常用字段填写建议如下：

字段	填写建议
通道类型	普通网站可以选 HTTP；需要浏览器 HTTPS 访问时选 HTTPS。
本地地址	服务在当前客户端设备上通常填写 127.0.0.1。
本地端口	填写本地 Web 服务实际监听端口，例如 8080。
自定义域名	填写准备对外访问的完整域名，例如 test.zosen.link。

填写自定义域名后，平台会提示需要把该域名 CNAME 到当前节点地址。截图中的提示是：

CNAME s1.zosen.link

实际使用时，请以你创建通道弹窗中显示的 CNAME 目标为准。不同服务节点可能显示不同目标，不要自己猜。

2. 添加 CNAME 解析记录

打开你的域名服务商或云解析控制台，找到对应域名的 DNS 解析 页面，添加一条 CNAME 记录。

以 test.zosen.link 为例，配置方式如下：

DNS 字段	应填写内容
记录类型	CNAME
主机记录	test
记录值	平台提示的 CNAME 目标，例如 s1.zosen.link
解析请求来源	保持默认即可
TTL	保持默认即可

如果你的域名是 www.example.com，主机记录通常填写 www；如果是 api.example.com，主机记录通常填写 api。

不要填错记录值

记录值应填写平台提示的目标域名，例如 s1.zosen.link，不要填写你的自定义域名本身，也不要填写 http:// 或 https://。

3. 等待 DNS 生效

保存解析记录后，需要等待 DNS 生效。大多数情况下几分钟内可以生效，但不同域名服务商、不同网络环境可能需要更久。

可以在终端中使用下面命令检查解析是否已经指向平台节点：

dig +short test.zosen.link CNAME

如果返回类似下面的结果，说明 CNAME 已经生效：

s1.zosen.link.

把 test.zosen.link 换成你自己的域名即可。

4. 创建通道并访问

确认 CNAME 解析已经添加后，回到创建通道弹窗，点击 创建。通道创建成功后，等待客户端接收配置，然后使用自定义域名访问。

通道类型	访问方式
HTTP	http://你的域名
HTTPS	https://你的域名

HTTPS 证书签发

如果创建的是 HTTPS 类型通道，第一次访问公网域名后，平台需要向证书服务申请并签发证书。证书签发通常需要等待一会儿，期间浏览器可能暂时无法正常打开或提示证书尚未就绪。请等待几分钟后刷新页面再试。

常见问题

为什么必须配置 CNAME？

HTTP/S 自定义域名需要让浏览器请求先到达平台服务节点，平台才能根据域名把请求转发到你的客户端和本地服务。CNAME 解析就是把你的域名指向平台节点。

CNAME 目标应该填什么？

填写创建通道弹窗中提示的目标，例如 s1.zosen.link。如果以后切换节点或平台提示发生变化，请按控制台新的提示更新解析记录。

解析已经添加，为什么还是访问不了？

请按下面顺序检查：

1. DNS 解析是否已经生效。
2. 记录类型是否为 CNAME。
3. 主机记录是否和自定义域名前缀一致。
4. 记录值是否填写为平台提示的节点域名。
5. 客户端是否在线，通道是否已经创建成功。
6. 本地 Web 服务是否可以在客户端设备上正常访问。

HTTPS 打开时提示证书问题怎么办？

新建 HTTPS 通道后，首次访问会触发证书申请和签发。请等待几分钟后刷新页面。如果长时间仍异常，先确认 CNAME 是否已经正确生效，再重新访问域名。