4.9 KiB
4.9 KiB
Edge HTTPDNS 用户使用手册
欢迎使用 Edge HTTPDNS 服务。本文档旨在帮助您快速完成应用创建、域名配置及解析测试，实现精准、安全的业务调度。
1. 快速入门流程
- 创建应用：获取接入凭证（AppId 和 SecretKey）。
- 添加域名：登记需要通过 HTTPDNS 解析的业务域名。
- 自定义解析规则：设置域名对应的 IP 地址及智能分流规则。
- 解析测试：通过沙箱工具验证解析是否生效。
- 集成 SDK：将解析功能集成至您的 App 中。
2. 应用管理
应用是您接入 HTTPDNS 的基础单元。
2.1 创建应用
- 登录用户控制台，点击 HTTPDNS -> 应用列表。
- 点击 创建应用。
- 填写应用名称（如“我的安卓App”）。
- 系统会自动关联默认的服务域名，无需手动选择。
2.2 获取接入凭证
在应用详情页面，您可以找到：
- AppId：应用的唯一识别 ID。
- SecretKey：签名密钥。请务必妥善保管，切勿泄露。 在 SDK 初始化时使用此密钥可开启“签名鉴权”，防止解析接口被他人盗刷。
3. 域名与记录配置
3.1 添加域名
- 进入应用详情页，切换至 域名管理 标签。
- 点击 添加域名，输入您的业务域名（如
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 在线解析测试
在左侧菜单进入 解析测试：
- 选择您创建的 应用、HTTPDNS 服务域名 和 待解析域名。
- 模拟客户端 IP（可选）：输入特定地区的 IP，验证该地区的解析结果是否符合预期（地域调度验证）。
- 点击 在线解析，查看返回的具体 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 代码中同步更新。