一、升级说明
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目录，复制第二行命令，启动部署。配置必读：Agent默认安装路径为
/home/alidns/tui，服务器需开放443端口的出方向访问。支持的操作系统包括Alibaba Cloud Linux、Anolis8、Ubuntu 22~24、CentOS 7及CentOS Stream 9/10。
-
-
启动部署会出现如下GUI页面，点击 开始安装。
/\_\ __ /\_\ _ \/\/\ \ /\_\ \/\ \ /\_\ \ \ \\ \/\ \ /\_\ /\_\ /\_\/\_,\ \ \[.\_ \_\ \_\ \/\ \/\ \/\ \/\_, \ \__/.\_/\____\ \_\ \____\ \ \_\/\____/ \/__/\/_/\/__/ \/_/\/__,_ \/\_/\/__,_ /\/_/\/_/\/__/ 云解析DNS安装器 v1.0.0 本工具用于安装阿里云自建DNS软件Agent. 安装完成后才可以通过云解析DNS控制台， 进一步配置自建DNS的解析服务. 点击'开始安装'或回车开始安装 开始安装 -
选择第一步 环境检测。
操作快捷键：上一步 下一步 <ctrl-c> 退出 部署步骤 1 环境检测 2 安装Agent 3 端云建联 检查项 要求 检查结果 CPU(架构) x86_64 ✓ CPU(核心个数) ≥ 2核心 ✓ 内存 ≥ 8G ✓ 硬盘(/home) ≥ 32G ✓ 操作系统 centos[7,9,10],alib... ✓ SELinux 关闭 ✓ Docker 非第三方 ✓ 服务端口 是否被占用 ✓ 步骤说明 为确保阿里云自建DNS软件Agent顺利安装，安装前将 对服务器的CPU、内存、硬盘及关键服务端口等进行 预检。检测通过后可继续安装，否则将中止安装。请 根据提示解决异常并满足检测要求后重新安装 输出 CPU架构:x86_64 CPU核心数:4 可用内存大小:6G /home 目录可用磁盘大小:30G 操作系统版本:ubuntu22.04 ubuntu跳过SELinux关闭 docker(27.5.1) 已经安装；跳过 服务端口没有被占用 环境验证成功，请选择下一步开始安装opAgent 修复方法 -
选择第二步 安装Agent。提示Agent安装成功后，证明Agent更新完成。按Ctrl+C退出Agent部署程序。返回云解析DNS控制台进行节点升级。
说明本次升级无需执行端云建联操作，原有配置将自动保留并继续生效。
操作快捷键: 上一步 下一步 <ctrl-c> 退出 部署步骤: 1 环境检测 2 安装Agent 3 端云建联 步骤说明: 安装Agent组件，Agent组件以容器方式运行。部署过程中会自动安装Docker，若本地已安装Docker（非Agent自身部署的Docker），将中止安装，请先卸载后再进行Agent安装。 执行操作: (1) 检测当前已安装docker版本 (2) 启动容器ops-nodeexporter (3) 启动容器ops-opagent 输出: docker(27.5.1) 已经安装；跳过 容器ops-nodeexporter已经运行中；跳过 容器ops-opagent已经运行中；跳过 agent安装成功，如果是管控节点进入下一步端云建联
2. 升级仅部署解析服务的节点
-
升级前，请确保当前节点的Agent已完成更新，详见1. 更新软件安装Agent（此操作不影响解析服务）。
-
进入云解析DNS-自建DNS控制台，选择目标节点，点击 升级。
-
在弹出的信息确认页面，点击 下一步。
升级前置检验页面显示本次升级服务为解析服务（5万QPS）（v3.0.0）。在基本信息校验页签中确认节点名称、节点服务角色及本地通信地址等信息，并在升级目标版本号下拉框中选择目标版本（例如v3.0.1（最新版本））。注意：节点服务升级完成后将无法回退到之前的版本；截至2026年7月1日 00:00:00必须完成升级，否则无法变更配置，但不影响已有配置的解析服务。
-
点击 启动升级，等待升级完成。
升级过程中，系统将显示当前升级进度。注意：升级失败时，系统将自动回滚至升级前的版本与状态。升级有疑问，请通过钉钉群（群号：104160006996）咨询。
-
升级完成后，点击 下一步，返回节点管理列表。
-
在节点管理列表确认节点版本号，已是最新版本v3.0.1。
3. 升级同时部署管控代理服务和解析服务的节点
-
升级前，请确保当前节点的Agent已完成更新，详见1. 更新软件安装Agent（此操作不影响解析服务）。
-
进入云解析DNS-自建DNS控制台，选择同时部署管控代理服务和解析服务的目标节点，点击 升级。
-
确认配置后，点击 下一步。
重要同一服务器若同时运行解析服务与管控代理服务，请务必分两次独立升级，以最小化对解析的影响。
-
点击 启动升级，等待升级完成。
升级过程中，系统将显示当前升级进度。注意：升级失败时，系统将自动回滚至升级前的版本与状态。升级有疑问，请通过钉钉群（群号：104160006996）咨询。
-
升级完成后，点击 下一步，返回节点管理列表。
-
在节点管理列表确认节点版本号，已是最新版本v3.0.1。
-
在节点管理列查看解析服务角色版本号，已是最新版本v3.0.1。重复上述操作，再次点击 升级，完成管控代理服务的版本升级。
4. 升级后解析验证
使用 dig 或 nslookup 命令，对已配置的关键域名进行解析测试，确保返回结果正确、响应正常。
# linux服务器测试命令
dig @<服务器IP> example.com A
# windows测试命令
nslookup example.com <服务器IP>仅在所有测试通过、解析行为符合预期后，方可将该节点重新纳入 DNS 查询流量（如恢复 BGP 宣告、加入负载均衡池等）。