在 Ubuntu 服务器上部署自建 DNS

更新时间:
复制 MD 格式

背景与问题根因

Ubuntu 默认启用 systemd-resolved 服务接管本机 DNS 解析。该服务将 /etc/resolv.conf 软链接到自己的 stub 配置,nameserver 指向本机回环地址(127.0.0.53 / ::1),由 systemd-resolved 在本机监听 53 端口代为解析。这套机制在宿主机上可以工作,但对自建DNS部署有两个直接影响:

  • 容器继承失效配置:Docker 在创建容器时会把宿主机的 /etc/resolv.conf 内容复制进容器。容器内的回环地址(::1 / 127.0.0.53)上并没有 systemd-resolved 在监听,容器内所有域名解析请求都会被拒绝(connection refused)。

  • 53 端口占用风险:systemd-resolved 的 stub listener 占用本机 53 端口,与自建DNS的解析进程监听 53 端口存在潜在冲突。

因此,关闭 systemd-resolved 是部署前的必做步骤,而不是出现问题后的补救手段。

部署前准备

以下步骤为部署前的必做项,需在执行自建DNS软件安装之前全部完成。

Step 1:检查当前解析状态

执行以下命令确认当前状态:

# 查看 systemd-resolved 是否在运行
systemctl status systemd-resolved

# 查看 resolv.conf 是否为 systemd-resolved 的软链接
ls -l /etc/resolv.conf
# 若输出指向 ../run/systemd/resolve/stub-resolv.conf,即为受管状态

# 查看本机 53 端口占用情况
sudo ss -lntup | grep ':53 '

Step 2:关闭 systemd-resolved 并配置静态 DNS

依次执行停止服务、删除软链接、写入静态配置三个动作:

# 1. 停止并禁用服务
sudo systemctl stop systemd-resolved
sudo systemctl disable systemd-resolved

# 2. 删除它创建的 resolv.conf 软链接
sudo rm /etc/resolv.conf

# 3. 手动创建静态 resolv.conf
echo "nameserver 223.5.5.5" | sudo tee /etc/resolv.conf
# 按需添加更多 nameserver,例如:
# echo "nameserver 223.6.6.6" | sudo tee -a /etc/resolv.conf
说明

223.5.5.5 / 223.6.6.6 为阿里云公共DNS。

Step 3:验证部署前环境

三项全部通过后再开始安装:

# 1) 服务已停止且开机不自启
systemctl is-active systemd-resolved    # 期望输出:inactive
systemctl is-enabled systemd-resolved   # 期望输出:disabled

# 2) resolv.conf 为静态文件且指向可用DNS
ls -l /etc/resolv.conf                  # 期望:普通文件,非软链接
cat /etc/resolv.conf                    # 期望:nameserver 223.5.5.5

# 3) 宿主机可正常解析云端管控域名
dig alidns.aliyuncs.com            # 期望:正常返回IP地址

未做前置处理的典型报错

若跳过“部署前准备”直接安装,在 TUI 安装向导的端云建联步骤,单击获取集群时,界面会返回报错。

报错信息示例:

获取集群Id失败: Post "https://alidns.aliyuncs.com/?PageNumber=1&PageSize=100":
dial tcp: lookup alidns.aliyuncs.com on [::1]:53: read udp [::1]:47324->[::1]:53: read: connection refused

报错解读:

关键特征为 on [::1]:53 ... connection refused,即 Agent 容器在向本机回环地址 ::1 的 53 端口发起域名解析,而容器内没有服务监听该端口。这正是容器创建时继承了宿主机 systemd-resolved 配置的结果。

重要

该错误发生后,即使再按“部署前准备”关闭宿主机的 systemd-resolved 也不能解决问题,因为失效配置在容器创建时已经写入容器内部,宿主机后续修改不会同步到已部署的容器,必须按“已部署环境的修复”进入容器修复。

已部署环境的修复

本节适用于已按错误顺序部署、出现“获取集群ID失败”报错的环境。

Step 1:完成宿主机整改

先按“部署前准备”完成宿主机的 systemd-resolved 关闭与静态 DNS 配置,这是后续容器重建不再复发的基础。之后再进入容器修复已失效的解析配置。

Step 2:修复容器内的 DNS 配置

# 进入容器
docker exec -it ops-opagent sh

# 打开 resolv.conf 并配置DNS服务器
vi /etc/resolv.conf

# 在 resolv.conf 中增加以下配置后保存退出
nameserver 223.5.5.5

退出容器后,执行 docker exec ops-opagent cat /etc/resolv.conf 抽检修改结果,期望 nameserver 为 223.5.5.5 等真实 DNS 地址,而非回环地址。

Step 3:重新执行 TUI 安装向导

# 保存后退出容器,执行以下命令打开TUI重新执行
cd /home/alidns/tui/alidns-tui-install && ./aui

重新进入端云建联步骤,单击获取集群,验证建联恢复正常。

说明

直接修改容器内 /etc/resolv.conf 属于运行时修复:若后续容器被删除重建(如升级、重新部署),Docker 会重新从宿主机复制解析配置。因此:

  • 只要宿主机已按“部署前准备”整改到位,重建后的容器会继承正确的静态 DNS 配置,问题不会复发。

  • 若宿主机未整改就重建容器,问题会原样复现,需重新执行本节修复。

部署检查清单

下表汇总部署前与部署后的全部检查项。部署前各项的判定命令与期望输出见“验证部署前环境”。

阶段

检查项

通过标准

部署前

systemd-resolved 服务状态

inactive 且 disabled

部署前

/etc/resolv.conf

静态普通文件,nameserver 指向可用的 DNS服务器

部署前

宿主机解析 alidns.aliyuncs.com

正常返回 IP 地址

部署前

本机 53 端口

无 systemd-resolved stub 占用

部署后

容器内 /etc/resolv.conf

不含 127.0.0.53 / ::1 等回环地址

部署后

TUI 安装向导端云建联步骤的获取集群

成功获取集群ID

容器内部署后抽检命令:

docker exec ops-opagent cat /etc/resolv.conf
# 期望:nameserver 为 223.5.5.5 等真实DNS地址,而非回环地址

常见问题

为什么关闭了 systemd-resolved,报错依然存在?

因为失效的解析配置在容器创建时已复制进容器,宿主机整改不会同步到已存在的容器。需按“已部署环境的修复”进入容器修改 /etc/resolv.conf。

可以只关闭 stub listener 而不停用 systemd-resolved 吗?

技术上存在 DNSStubListener=no 的折中方案,但 systemd-resolved 仍会接管 /etc/resolv.conf 的管理权,容器继承行为依旧存在不确定性。为避免部署链路引入额外变量,推荐按本文直接停用服务并使用静态 resolv.conf。

容器重建后问题复发怎么办?

说明宿主机整改(“部署前准备”)未做或未生效,根据该章节核查宿主机 /etc/resolv.conf 后再重建容器。