99 lines
4.9 KiB
Markdown
99 lines
4.9 KiB
Markdown
# Edge HTTPDNS 用户使用手册
|
||
|
||
欢迎使用 Edge HTTPDNS 服务。本文档旨在帮助您快速完成应用创建、域名配置及解析测试，实现精准、安全的业务调度。
|
||
|
||
---
|
||
|
||
## 1. 快速入门流程
|
||
1. **创建应用**：获取接入凭证（AppId 和 SecretKey）。
|
||
2. **添加域名**：登记需要通过 HTTPDNS 解析的业务域名。
|
||
3. **自定义解析规则**：设置域名对应的 IP 地址及智能分流规则。
|
||
4. **解析测试**：通过沙箱工具验证解析是否生效。
|
||
5. **集成 SDK**：将解析功能集成至您的 App 中。
|
||
|
||
---
|
||
|
||
## 2. 应用管理
|
||
|
||
应用是您接入 HTTPDNS 的基础单元。
|
||
|
||
### 2.1 创建应用
|
||
1. 登录用户控制台，点击 **HTTPDNS -> 应用列表**。
|
||
2. 点击 **创建应用**。
|
||
3. 填写应用名称（如“我的安卓App”）。
|
||
4. 系统会自动关联默认的服务域名，无需手动选择。
|
||
|
||
### 2.2 获取接入凭证
|
||
在应用详情页面，您可以找到：
|
||
* **AppId**：应用的唯一识别 ID。
|
||
* **SecretKey**：签名密钥。**请务必妥善保管，切勿泄露。** 在 SDK 初始化时使用此密钥可开启“签名鉴权”，防止解析接口被他人盗刷。
|
||
|
||
---
|
||
|
||
## 3. 域名与记录配置
|
||
|
||
### 3.1 添加域名
|
||
1. 进入应用详情页，切换至 **域名管理** 标签。
|
||
2. 点击 **添加域名**，输入您的业务域名（如 `api.example.com`）。
|
||
|
||
### 3.2 自定义解析规则
|
||
**作用**：自定义解析规则允许您根据终端用户的网络环境（如运营商）或物理位置，为其分配最优的访问地址。通过精细化的线路调度，可以有效降低跨境或跨网访问带来的延迟，提升 App 的响应速度。
|
||
|
||
点击域名后的 **解析规则**，进入详细设置：
|
||
* **解析类型**：支持 **A 记录 (IPv4)** 和 **AAAA 记录 (IPv6)**。
|
||
* **线路选择**：可选择针对特定运营商（如：移动、电信、联通）或特定地域（如：浙江省、海外）进行精准匹配。若不选择则代表全局默认配置。
|
||
* **解析结果**：填写您的服务器目标 IP 地址。
|
||
* **TTL**：解析结果在客户端缓存的时间。默认为 30 秒，建议保持默认以兼顾调度灵活性。
|
||
|
||
---
|
||
|
||
## 4. 配合 CDN 实现网络加速与安全
|
||
|
||
Edge HTTPDNS 不仅仅提供域名解析功能，更通过与 CDN 节点的深度集成，解决了移动端常见的 **HTTPS SNI 隐匿访问**及 **跨运营商加速**问题。
|
||
|
||
### 4.1 自动获取 CDN 边缘节点
|
||
如果您在系统内开通了 **CDN 加速服务**，只需将业务域名配置在 CDN 平台中，并将其 CNAME 解析指向 CDN 提供的地址：
|
||
* **智能调度**：HTTPDNS 会自动识别该域名已接入 CDN，并针对终端用户的地理位置和运营商，智能返回最优的 **CDN 边缘节点 IP**。
|
||
* **无感知兜底**：如果域名未接入 CDN 或未配置解析规则，HTTPDNS 将自动回源查询 **权威 DNS**，并返回业务真实的源站 IP，确保解析永不中断。
|
||
|
||
### 4.2 解决 HTTPS SNI 隐匿问题
|
||
在使用 IP 直连（如 `https://1.2.3.4/path`）访问 HTTPS 业务时，传统的网络库会因为无法获取正确的 Host 导致 SSL 握手失败。
|
||
|
||
**我们的方案：**
|
||
* **配合 CDN 节点**：我们的 CDN 节点已针对 HTTPDNS 进行了特殊适配。
|
||
* **SDK 自动适配**：SDK 内部集成了标准适配器。在您的代码中，只需配合解析出的 IP 设置 HTTP 请求头的 `Host` 字段，即可透明地完成 SNI 握手，无需复杂的 SSL 改写逻辑。
|
||
* **稳定性保障**：通过 CDN 节点的全局负载均衡，即使某个节点异常，HTTPDNS 也会实时踢除并将流量导向其他可用节点，确保业务高可用。
|
||
|
||
---
|
||
|
||
## 4. 调试与验证
|
||
|
||
### 4.1 在线解析测试
|
||
在左侧菜单进入 **解析测试**：
|
||
1. 选择您创建的 **应用**、**HTTPDNS 服务域名** 和 **待解析域名**。
|
||
2. **模拟客户端 IP**（可选）：输入特定地区的 IP，验证该地区的解析结果是否符合预期（地域调度验证）。
|
||
3. 点击 **在线解析**，查看返回的具体 IP 列表。
|
||
|
||
### 4.2 访问日志查询
|
||
在 **访问日志** 中，您可以实时监控解析请求：
|
||
* 查看各个 AppId 下域名的解析成功率。
|
||
* 查看请求的来源 IP、耗时以及命中的路由规则。
|
||
|
||
---
|
||
|
||
## 5. 获取 SDK
|
||
在 **应用详情 -> SDK下载** 中：
|
||
* 您可以下载最新版本的 Android、iOS 或 Flutter SDK 压缩包。
|
||
* 查看配套的 **SDK 集成文档**。
|
||
|
||
---
|
||
|
||
## 6. 常见问题 (FAQ)
|
||
|
||
* **Q：为什么我设置了记录，解析测试却返回为空？**
|
||
* A：请检查记录是否已启用；或者检查该域名是否已被添加到对应的 AppId 允许列表下。
|
||
* **Q：如何应对冷启动时的解析延迟？**
|
||
* A：建议在 SDK 初始化后调用“解析预热”接口，提前将热点域名加载至缓存。
|
||
* **Q：SecretKey 泄露了怎么办？**
|
||
* A：请在应用设置中重置 SecretKey，并在 App 代码中同步更新。
|