自建DNS升级说明

更新时间:
复制为 MD 格式

一、升级说明

1. 升级过程中的服务影响

升级节点部署服务角色

升级是否影响解析

升级说明

仅部署:解析服务

升级过程中将产生 秒级解析中断,建议在业务低峰期或预约变更窗口执行

同时部署:管控代理服务和 解析服务

推荐分步升级
1. 先升级解析服务秒级解析中断
2. 再升级管控代理服务不影响解析
⚠️ 若两者同时升级,解析中断时间将延长至 15–20 秒

仅部署:管控代理服务

升级不影响解析服务

日志服务

注意

  1. 文档中提及的“秒级解析中断”基于阿里云内部测试环境,仅供参考。实际影响受客户本地服务器性能(如 CPU、内存)、部署架构等因素影响,可能存在较大差异。

  2. 同一服务器若同时运行解析服务与管控代理服务,请务必分两次独立升级,以最小化对解析的影响。

  3. 所有涉及解析服务的升级,均建议安排在业务低峰期或通过变更管理流程预约维护窗口

建议

  1. 升级前务必在本地搭建测试环境,验证升级流程以及实际中断时长与业务影响,确认无误后再执行生产升级。

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(此操作不影响解析服务)

  1. 登录需要升级的服务器。

  2. 部署软件安装Agent。

    1. 进入云解析DNS-自建DNS控制台,点击 开始部署

      image.png

    2. 在部署软件安装Agent界面,根据服务器是否具备公网访问能力,选择对应的部署方式。

      说明

      若服务器可连接互联网:请复制弹窗中 curl -fsSL开头的命令,该命令会在线下载Agent软件包,并启动部署。

      若服务器无法连接互联网:请在本地点击 下载Agent安装包,然后通过云助手、SCP命令等方式将安装包上传到服务器的/root目录,复制第二行命令,启动部署。

      image.png

  3. 启动部署会出现如下GUI页面,点击 开始安装

    image.png

  4. 选择第一步 环境检测

    image.png

  5. 选择第二步 安装Agent。提示Agent安装成功后,证明Agent更新完成。按Ctrl+C退出Agent部署程序。返回云解析DNS控制台进行节点升级。

    说明

    本次升级无需执行端云建联操作,原有配置将自动保留并继续生效。

    image.png

2. 升级仅部署解析服务的节点

  1. 升级前,请确保当前节点的Agent已完成更新,详见1. 更新软件安装Agent(此操作不影响解析服务)

  2. 进入云解析DNS-自建DNS控制台,选择目标节点,点击 升级

    image.png

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

    image.png

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

    image.png

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

    image.png

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

    image.png

3. 升级同时部署管控代理服务和解析服务的节点

  1. 升级前,请确保当前节点的Agent已完成更新,详见1. 更新软件安装Agent(此操作不影响解析服务)

  2. 进入云解析DNS-自建DNS控制台,选择同时部署管控代理服务和解析服务的目标节点,点击 升级

    image.png

  3. 确认下图配置后,点击 下一步

    重要

    同一服务器若同时运行解析服务与管控代理服务,请务必分两次独立升级,以最小化对解析的影响。

    image.png

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

    image.png

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

    image.png

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

    image.png

  7. 在节点管理列查看解析服务角色版本号,已是最新版本v3.0.1。重复上述操作,再次点击 升级,完成管控代理服务的版本升级。

4. 升级后解析验证

使用 dignslookup 命令,对已配置的关键域名进行解析测试,确保返回结果正确、响应正常。

# linux服务器测试命令
dig @<服务器IP> example.com A

# windows测试命令
nslookup example.com <服务器IP>

仅在所有测试通过、解析行为符合预期后,方可将该节点重新纳入 DNS 查询流量(如恢复 BGP 宣告、加入负载均衡池等)。