一、升级说明
1. 升级过程中的服务影响
升级节点部署服务角色 | 升级是否影响解析 | 升级说明 |
仅部署:解析服务 | 是 | 升级过程中将产生 秒级解析中断,建议在业务低峰期或预约变更窗口执行 |
同时部署:管控代理服务和 解析服务 | 是 | 推荐分步升级: |
仅部署:管控代理服务 | 否 | 升级不影响解析服务 |
日志服务 | 否 |
注意:
文档中提及的“秒级解析中断”基于阿里云内部测试环境,仅供参考。实际影响受客户本地服务器性能(如 CPU、内存)、部署架构等因素影响,可能存在较大差异。
同一服务器若同时运行解析服务与管控代理服务,请务必分两次独立升级,以最小化对解析的影响。
所有涉及解析服务的升级,均建议安排在业务低峰期或通过变更管理流程预约维护窗口。
建议:
升级前务必在本地搭建测试环境,验证升级流程以及实际中断时长与业务影响,确认无误后再执行生产升级。
2. 升级注意事项
摘除流量:升级前,务必从流量调度中移除目标节点(如 BGP 撤流、负载均衡下线),确保无解析请求。
窗口期操作:建议在业务低峰期或通过变更流程预约维护窗口执行升级。
预验证流程:推荐在临时测试节点完整演练升级流程,验证无误后再操作生产环境。
禁止配置变更:升级过程中,严禁手动或自动化修改 DNS 配置,以防配置丢失或服务异常。
3. 新版本产品功能简介
新增功能 | 说明 |
DOH转发优先 | 通过自建DNS查询互联网域名时,支持优先通过 DNS-over-HTTP(DoH)发起请求,有效规避 UDP 解析劫持风险;若 DoH 查询失败,自动回退至传统 UDP 方式,保障解析可靠性。 |
私有HTTPDNS服务 | 自建 DNS 支持标准 HTTPDNS 接口,与公共云 HTTPDNS 服务兼容。企业可集成统一 SDK,灵活选择接入公共云或自建 HTTPDNS 服务,实现无缝切换。 |
扩展适配OS | 新增对 Ubuntu 22.04–24.04 及 CentOS Stream 9–10 的部署支持 |
公网IP采集日志 | 支持通过公网 IP 地址采集各解析集群的运维数据与解析日志,便于在多集群架构下,由日志服务集群统一汇聚和分析跨区域服务状态 |
4. 升级版本和周期说明
适用范围:本次升级适用于已部署 自建 DNS v3.0.0 的用户,目标版本为 v3.0.1。
截止期限:请于 2026 年 7 月 1 日前完成升级。逾期未升级将无法进行配置变更,但已配置域名的解析服务不受影响。
功能限制:新版本功能仅在 v3.0.1 中可用,旧版本不支持。
5. 升级回退
升级通过 GUI 界面执行,若升级失败,系统将自动回滚至原版本(v3.0.0),无需人工干预。
6. 应急支持
如在升级过程中遇到问题,请加入官方钉钉支持群获取一对一协助。群号:104160006996
二、升级步骤
1. 更新软件安装Agent(此操作不影响解析服务)
登录需要升级的服务器。
部署软件安装Agent。
进入云解析DNS-自建DNS控制台,点击 开始部署。

在部署软件安装Agent界面,根据服务器是否具备公网访问能力,选择对应的部署方式。
说明若服务器可连接互联网:请复制弹窗中
curl -fsSL开头的命令,该命令会在线下载Agent软件包,并启动部署。若服务器无法连接互联网:请在本地点击 下载Agent安装包,然后通过云助手、SCP命令等方式将安装包上传到服务器的
/root目录,复制第二行命令,启动部署。
启动部署会出现如下GUI页面,点击 开始安装。

选择第一步 环境检测。

选择第二步 安装Agent。提示Agent安装成功后,证明Agent更新完成。按Ctrl+C退出Agent部署程序。返回云解析DNS控制台进行节点升级。
说明本次升级无需执行端云建联操作,原有配置将自动保留并继续生效。

2. 升级仅部署解析服务的节点
升级前,请确保当前节点的Agent已完成更新,详见1. 更新软件安装Agent(此操作不影响解析服务)。
进入云解析DNS-自建DNS控制台,选择目标节点,点击 升级。

在弹出的信息确认页面,点击 下一步。

点击 启动升级,等待升级完成。

升级完成后,点击 下一步,返回节点管理列表。

在节点管理列表确认节点版本号,已是最新版本v3.0.1。

3. 升级同时部署管控代理服务和解析服务的节点
升级前,请确保当前节点的Agent已完成更新,详见1. 更新软件安装Agent(此操作不影响解析服务)。
进入云解析DNS-自建DNS控制台,选择同时部署管控代理服务和解析服务的目标节点,点击 升级。

确认下图配置后,点击 下一步。
重要同一服务器若同时运行解析服务与管控代理服务,请务必分两次独立升级,以最小化对解析的影响。

点击 启动升级,等待升级完成。

升级完成后,点击 下一步,返回节点管理列表。

在节点管理列表确认节点版本号,已是最新版本v3.0.1。

在节点管理列查看解析服务角色版本号,已是最新版本v3.0.1。重复上述操作,再次点击 升级,完成管控代理服务的版本升级。
4. 升级后解析验证
使用 dig 或 nslookup 命令,对已配置的关键域名进行解析测试,确保返回结果正确、响应正常。
# linux服务器测试命令
dig @<服务器IP> example.com A
# windows测试命令
nslookup example.com <服务器IP>仅在所有测试通过、解析行为符合预期后,方可将该节点重新纳入 DNS 查询流量(如恢复 BGP 宣告、加入负载均衡池等)。






