带阿里标识的版本

EdgeHttpDNS/HTTPDNS用户使用手册.md

@@ -0,0 +1,98 @@
+# 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 代码中同步更新。