83 lines
4.2 KiB
Markdown
83 lines
4.2 KiB
Markdown
# Edge HTTPDNS 管理员配置手册
|
||
|
||
本文档汇总了 Edge HTTPDNS 的核心配置流程，重点介绍了集群管理、节点在线安装以及多集群调度的详细操作。
|
||
|
||
---
|
||
|
||
## 1. 集群管理
|
||
|
||
集群是 HTTPDNS 服务的基本组织单元。通过设置“默认”角色，可以实现应用配置的自动关联与 SDK 侧的高可用容灾。
|
||
|
||
### 1.1 默认集群角色定义
|
||
在“集群设置”中，您可以将集群开启为 **“设为默认集群”**，并指派以下角色：
|
||
|
||
* **默认主集群**：
|
||
* **自动关联**：当在控制台“添加应用”时，系统会自动将该应用关联到此默认主集群。
|
||
* **服务首选**：SDK 初始化后，会优先使用该集群的服务域名进行解析请求。
|
||
* **默认备用集群**：
|
||
* **自动容灾**：当默认主集群的节点全部宕机或网络不可达时，SDK 会自动切换至默认备用集群进行解析，确保业务不中断。
|
||
* **自动关联**：与主集群一样，新应用创建时也会自动关联此备用集群信息。
|
||
|
||
> **注意**：同一时刻，系统内仅允许存在一个“默认主集群”和一个“默认备用集群”。新设置的默认集群会自动取消之前的旧设置。
|
||
|
||
### 1.2 核心参数配置
|
||
* **服务域名**：该集群对外提供 HTTPDNS 服务的接入地址。
|
||
* **降级超时容忍度**：指节点回源查询上游 DNS 时的最大等待时间（单位：毫秒）。若超过此阈值未获得结果，将视作解析失败。该选项可在“集群设置”中统一调整。
|
||
* **默认 TTL**：解析结果在客户端缓存的缺省时长（默认 30s）。
|
||
* **TLS 设置**：
|
||
* **端口绑定**：通常绑定 `443`。
|
||
* **SSL 证书**：必须配置合法证书，否则 SDK 的 HTTPS 请求将失败。
|
||
* **TLS 版本**：默认支持 TLS 1.1 及以上版本。
|
||
|
||
---
|
||
|
||
## 2. 节点安装与维护
|
||
|
||
节点是处理解析请求的实体。Edge HTTPDNS 支持“在线安装”。
|
||
|
||
### 2.1 在线安装
|
||
1. **创建节点**：在集群下点击“创建节点”，填写名称及公网 IP。
|
||
2. **配置 SSH**：在节点详情中点击“设置 SSH”，输入服务器的 Host、Port 及登录授权。
|
||
3. **启动安装**：在“安装信息”页面点击 **[开始安装]**。
|
||
* 自动下发二进制文件及服务脚本。
|
||
* 自动生成 `configs/api_httpdns.yaml`（包含节点识别需要的 `nodeId` 和 `secret`）。
|
||
4. **实时状态**：安装成功后，节点状态变为 **[在线]**，控制台每 30 秒更新一次节点的 CPU、内存及负载数据。
|
||
|
||
---
|
||
|
||
## 3. 应用与解析规则
|
||
|
||
### 3.1 接入应用管理
|
||
* **AppId/SecretKey**：创建应用后生成的凭证。应用在创建时已根据上述“默认集群”设定自动关联了服务入口。
|
||
* **鉴权配置**：开启“签名鉴权”可配合 SDK 的 `setSecretKey` 接口，杜绝接口被盗刷风险。
|
||
|
||
### 3.2 智能解析策略
|
||
* **线路/地域匹配**：根据来源运营商和地理位置返回最优 IP。
|
||
|
||
---
|
||
|
||
## 4. 调试与监控
|
||
|
||
### 4.1 解析测试
|
||
在 **调试工具 -> 解析测试** 中，您可以模拟客户端请求：
|
||
* 支持指定 **目标应用** 与 **所属集群**。
|
||
* 支持模拟 **客户端 IP** 以验证 ECS 掩码及地域调度效果。
|
||
* 实时展示请求 URL、客户端归属地、命中线路以及解析结果（IP 列表与 TTL）。
|
||
|
||
### 4.2 访问日志
|
||
在 **访问日志** 菜单中，可实时查阅所有终端发起的解析请求：
|
||
* 记录包括：请求时间、客户端 IP/操作系统、SDK 版本、解析域名、耗时以及最终返回的 IP 结果。
|
||
* 支持按 AppID、域名、状态（成功/失败）或关键字搜索排查。
|
||
|
||
### 4.3 运行日志
|
||
记录服务端及节点的底层运行事件：
|
||
* 包括节点心跳、SSL 证书加载、API 连接状态等系统级信息。
|
||
* 分为 Error、Warning、Info 等级别，是排查节点离线或连接故障的首要工具。
|
||
|
||
---
|
||
|
||
## 5. 常见问题
|
||
|
||
* **节点与 API 时间偏离**：若节点时间与 API Server 相差超过 30s，会导致鉴权失败（SIGN_INVALID）。请务必开启 NTP 时间同步。
|
||
* **SDK 无法连接备用集群**：请检查默认备用集群的 SSL 证书是否有效，以及防火墙端口是否开放。
|