🌍 添加DNS域名

本文说明EdgeHit如何作为DNS权威服务器运行，以及如何在EdgeHit-CDN下配置用户DNS域名和系统DNS域名。

用户域名与系统域名的区别

在EdgeHit中，用户账户创建的DNS域名为用户域名，而管理员账户创建的则视为系统域名。对比如下：

特性	用户域名	系统域名
创建者	用户/管理员	系统（自动或内部运维
存储内容	- CDN域名的A记录 - CNAME记录	- 站点别名 - 流量策略 - 系统节点A记录（如`EdgeHit`节点）
用途	用于用户自有或CDN面向域名的外部DNS解析	内部路由、系统控制和基于地理位置的决策逻辑

🛑 前提条件

使用DNS功能前，用户需具备：

已在EdgeHit DNS或其他域名提供商（如Dynadot、GoDaddy）管理的域名，且NS记录指向EdgeHit的对应DNS组
注意

确保DNS组初始区域记录中的NS记录与上游DNS服务器配置一致
- 可通过在域名提供商处配置NS记录实现
拥有有效EdgeHit账户，且已启用DNS角色
账户已分配有效的DNS套餐

系统管理员需完成：

系统DNS域名 是由管理员创建的DNS域名区域，其用途与用户域名不同。

它不存储用户源服务器的DNS记录，而是存储 站点别名 和 流量策略 等系统记录. 某些配置中也可能包含EdgeHit Controller, Load-Proxy或其他基础设施组件的主机名记录。

系统DNS域名 示例如下：

注意

系统DNS域名 无关联用户或用户方案。

系统域名的DNS记录示例如下：

注意

无需手动定义或编辑流量策略或站点别名。当流量策略和 CDN域名配置完成后，这些记录会自动生成和更新。

入侧边栏 *DNS > 域名* 部分，点击 添加 按钮创建新域名区域

提示

以下步骤与用户域名设置类似，区别在于此配置由管理员完成且域名不归属任何用户。
定义域名源（区域顶点），此设置不可更改并将映射至@变量以提供FQDN记录。选择服务该域名的DNS服务器组，该组将为区域提供SOA和NS记录。

注意

管理员添加的域名区域为系统DNS域名，其内容与用户域名不同。系统DNS域名可创建从用户域名到EdgeHit节点IP的映射，以引导流量进入CDN网络。
域名创建后，将显示在 DNS > 域名 的列表中。点击 详情 编辑域名区域。
进入 记录 页签，点击 添加 按钮新增DNS记录。
选择记录类型，填写对应的名称和内容。可通过多次点击 添加 按钮新增记录，或通过 详情 和 删除 操作管理记录。

注意

如需编辑域名的NS或SOA记录，建议从对应DNS组的初始记录中修改。

提示

确保上游DNS服务器（如Dynadot、GoDaddy）中已配置相同的初始NS记录。

本部分说明如何配置DNS用户方案（用户创建DNS域名的必要前提）。系统管理员需在 *DNS > 用户方案 > 添加* 部分为用户定义DNS方案。

注意

用户账户（非管理员）必须通过分配的DNS方案作为模板来创建DNS域名。 - 用户无法像管理员那样手动定义DNS组，此限制可防止配置越界。

DNS用户方案定义了作为配置模板的DNS服务器组，并限制用户可创建的DNS记录数量。详情参见高级用户方案配置

以用户账户进入 DNS > Domain 部分，点击 添加 创建新域名区域
定义域名源（区域顶点），此设置不可更改。选择服务该域名的 DNS服务器组，该组将为区域提供SOA和NS记录。

提示

用户账户无权创建DNS服务器组，需管理员通过添加EdgeHit DNS作为DNS服务器完成配置。
域名创建后，点击 详情 编辑区域配置。
进入记录页签，点击 添加 新增DNS记录
选择记录类型并填写内容。支持批量添加和单条记录管理。

注意

修改NS或SOA记录建议通过DNS组的 初始记录 完成。

前提条件

启用DNS健康检查前，需确保目标DNS域名所关联DNS服务器组中的所有EdgeHit DNS实例，其 .env 文件中已配置 EdgeHit DNS_health_check_url 值。

登录LoadUP-CP控制面板，进入 检查 > 任务 部分，点击 添加任务
定义监控目标IP的新任务。选择执行监控的LoadUP-worker节点，设置类型为ICMP或HTTP，并配置超时和间隔等参数，完成后点击 保存更改。

注意

目标需使用IP地址而非域名，域名可作为任务名称的参考。
保存后查看任务详情，记录 任务UUID。监控状态可在记录部分查看。
登录EdgeHit Controller，进入目标域名的 DNS > 域名 > 详情 > 记录 部分，点击 添加 新建DNS记录。
定义DNS记录内容（指向健康检查任务的IP地址），并将 任务UUID 填入记录的 健康检查ID 字段。
配置完成后，记录列表将显示健康检查ID列。
可通过本地终端执行 DIG 命令验证DNS记录状态，或直接访问 http://<健康检查域名>:16666/health-dns.txt 查看目标IP状态。