Files
waf-platform/EdgeHttpDNS/HTTPDNS主计划-V1.2.md
2026-02-24 19:10:27 +08:00

4.2 KiB
Raw Blame History

HTTPDNS 主计划V1.2 现行版)

1. 目标

  1. 形成 HTTPDNS 管理端可用闭环:集群、全局配置、应用、域名、自定义解析、日志、解析测试。
  2. 保持独立 HTTPDNS 模块设计,不挂载到传统 DNS(53)职责中。
  3. 文档仅保留当前已采用的设计与页面,不包含未落地方案。

2. 当前范围(仅管理平台)

  1. 菜单顺序固定为:
    • 集群管理
    • 全局配置
    • 应用管理
    • SDK接入引导
    • 访问日志
    • 运行日志
    • 解析测试
  2. 现阶段以管理端页面与 Mock 数据联调为主。

3. 核心设计约束

  1. 应用侧 SNI 防护仅采用“隐匿 SNI”固定策略不再提供 level1/level3 选择)。
  2. 服务入口按“集群服务域名”管理,不使用全局单一网关地址。
  3. 应用认证采用:
    • 请求验签开关
    • 加签 Secret
    • AES 数据加密 Secret
  4. 自定义解析规则支持 SDNS 参数与解析记录多条配置(各最多 10 条)。

4. 页面设计(现状)

4.1 集群管理

  1. 集群列表字段:
    • 集群名称
    • 服务域名
    • 节点数
    • 在线节点数
    • 状态
    • 操作
  2. 集群设置字段:
    • 集群名称
    • 集群服务域名
    • 降级超时容忍度(毫秒)
    • 本地内存缓存(秒)
    • 节点安装根目录(默认 /opt/edge-httpdns
    • 启用当前集群
  3. 节点页提供基础筛选、状态展示、详情与删除。

4.2 全局配置

  1. 用户设置:
    • 默认部署集群
    • 启用用户域名校验
  2. 基础默认:
    • SNI 防护配置(文案展示为“隐匿 SNI”
    • 全局默认解析 TTL
    • 全局降级超时

4.3 应用管理

  1. 应用列表字段:
    • 应用名称
    • AppID
    • 绑定域名数(可点击)
    • 状态
    • 操作(域名管理 / 应用设置)
  2. 添加应用:
    • 应用名称
    • 所属集群
    • 所属用户(可选)
  3. 应用设置分两块:
    • 基础配置AppID、应用启用、SNI 防护配置(隐匿 SNI
    • 认证与密钥:请求验签开关、加签 Secret、AES Secret查看/复制/重置/更新时间)

4.4 域名管理与自定义解析

  1. 域名管理:
    • 域名列表
    • 规则策略(显示该域名自定义解析规则数)
    • 操作(自定义解析、解绑)
  2. 自定义解析列表字段:
    • 线路
    • 规则名称
    • SDNS 参数
    • 解析记录
    • TTL
    • 状态
    • 操作(编辑/启停/删除)
  3. 新增/编辑规则弹窗:
    • 规则名称
    • 线路联动:
      • 中国大陆:运营商 -> 大区 -> 省份
      • 港澳台及境外:洲 -> 国家/地区(亚洲含中国香港/中国澳门/中国台湾)
    • SDNS 参数配置:最多 10 条
    • 解析记录值:最多 10 条,支持 A/AAAA可开启权重1-100
    • TTL1-86400
    • 规则状态

5. SDK接入引导现状

  1. 仅保留两步:
    • 01 查看配置
    • 02 开发接入
  2. 查看配置展示:
    • App ID可复制
    • 应用名称
    • 集群服务地址(可复制)
    • 加签 Secret查看/复制)
    • AES 数据加密 Secret查看/复制)
    • 请求验签状态

6. 日志页面(现状)

6.1 访问日志

  1. 主列:
    • 集群
    • 节点
    • 域名
    • 类型
    • 概要
  2. 概要按单行拼接展示,按“访问信息 -> 解析结果”顺序输出,不使用字段名堆叠。

6.2 运行日志

  1. 字段:
    • 时间
    • 集群
    • 节点
    • 级别
    • 类型
    • 模块
    • 详情
    • 次数
    • 请求ID

7. 解析测试(现状)

  1. 左侧配置项:
    • 目标应用
    • 解析域名
    • 模拟客户端 IP
    • 解析类型A/AAAA
    • SDNS 参数(最多 10 条)
  2. 右侧结果区:
    • 解析成功/失败
    • Request ID
    • 请求URL
    • 客户端 IP / 地区 / 线路
    • 解析记录表解析域名、解析类型、IP地址、TTL、地区、线路
  3. 已去掉无关展示块(如安全策略、验签响应头详情块)。

8. 本文不包含的内容

  1. 不包含 ECH 控制台与 ECH 分阶段交付设计。
  2. 不包含 SNI level1/level3、多级切换与 Public SNI 域名池页面设计。
  3. 不包含第三方 DNS 凭证复用与相关编排描述。
  4. 不包含用户平台User页面方案。