Linux resolvectl 命令:查看 systemd DNS 设置与解析路径
resolvectl 用于查看 systemd-resolved 的 DNS 设置、按链路生效的域规则及名称解析结果。排查时先运行 status 读取配置,再用 query 检查目标名称;查询成功不代表每个应用都走同一路径,也不保证目标服务可用。
DNS 是域名系统,用于查询名称与地址等记录。systemd-resolved 是提供本机名称解析的服务,resolvectl 是与它交互的工具;VPN(虚拟专用网络)或多网卡环境可按域将查询分给不同链路,这称为分割 DNS。
基本语法与适用环境
resolvectl [command] [name or link]
这是说明性语法,command、name、link 要按所选子命令替换。先用 resolvectl --version、resolvectl --help 和 man resolvectl 核对本机支持项。上游最新手册包含新版本功能,不能假定旧发行版也具备全部选项。
还可用 systemctl status systemd-resolved 读取服务状态。工具不存在、服务未运行或当前容器没有对应服务时,先确认实际解析架构;不要为运行教程命令就启动另一套 DNS 管理服务。systemd-resolved 即使运行,某个应用也可能通过自身缓存、直接 DNS 或加密 DNS 使用其他路径。
依次读取配置、查询与统计
查看全局与各链路设置。
resolvectl status
关注 DNS Servers、Current DNS Server、DNS Domain 和各 Link 区段。Link 是网络接口对应的链路作用域;接口名与编号以本机为准。status 读到的是当前生效状态,不是所有值的永久配置来源,也不能只看 Global 就忽略 VPN 接口。
通过 resolved 解析名称。
resolvectl query example.com
查看返回的地址、使用的协议和可提供的接口信息,并保留完整诊断。名称查询通常可取得 IPv4 与 IPv6 地址;地址参数则可触发反向查询。实际结果可能来自本地记录、缓存或网络,不能把每次 query 都当作刚刚访问了某台上游 DNS。
example.com 是示例域,不应把某次地址当成固定答案。检查企业内部名称时,用获准查询的真实完整名称,并保留 VPN 连接状态。若要比较 A 或 AAAA 等特定记录类型,应按本机手册指定类型,避免将不同查询条件的结果直接对比。
读取解析器统计。
resolvectl statistics
统计可显示缓存、查询和验证相关信息,具体字段依版本。它描述服务层面的处理,不是某个应用或某一条查询的完整追踪。重启服务或重置统计会改变基线;比较两次读数时,应记录间隔和同时发生的其他查询,不能凭总计数锁定故障来源。
全局 DNS 与链路 DNS 如何共同生效
再次查看状态时,应把 Global 和相关接口一起阅读:
resolvectl status
下面只展示输出结构,字段排列随版本变化;不是本机实测配置,也不是建议采用的服务器地址:
Global
Current DNS Server: 192.0.2.53
Link 2 (eth0)
DNS Servers: 192.0.2.53
192.0.2.53 属于文档示例网段,不能照抄为可用 DNS 服务器。Global 的 Current DNS Server 只表示该作用域当前选用的服务器,不说明所有链路或所有名称都必须使用它;服务在遇到错误后还可能切换服务器。
对普通单播 DNS,路由会依据匹配的域选择作用域,匹配标签更多的域优先。例如更具体的内部域可走 VPN,其他名称走另一链路;同等最佳匹配可能涉及多条链路。因此“全局永远优先”或“列表第一台永远处理全部请求”都不可靠。
搜索域可给没有点的短名称补后缀;以 ~ 开头的是仅用于路由的域,不作为搜索后缀。~. 表示根域路由范围,但更具体的域仍可优先。DNS 的 default-route 选择与 IP 默认路由不是同一个设置,不能只看 ip 的路由表 推断完整 DNS 分流策略。
常用子命令与修改边界
| 命令格式 | 含义与边界 |
|---|---|
status |
查看全局及链路 DNS 当前设置。 |
query name |
解析名称或地址,结果不证明目标应用可用。 |
statistics |
读取解析器统计,不会主动清零。 |
dns [link] |
无服务器参数时读取;提供链路与服务器参数可修改。 |
domain [link] |
读取域;提供链路与域参数可修改搜索或路由域。 |
flush-caches |
清除 resolved 自己维护的记录缓存,不是清除所有应用缓存。 |
resolvectl dns eth0 与 resolvectl domain eth0 可用于读取真实存在的 eth0 链路。继续添加服务器或域参数就可能改变配置,不能把“查看”示例与“设置”写法混用。运行时设置可能被网络管理服务、DHCP 或 VPN 重新提供的值覆盖,永久修改应回到实际管理配置中处理。
flush-caches 也属于改变诊断条件的操作,应先保留问题现场;它不会修复错误的域路由、上游记录或应用自己的缓存。reset-statistics 是另一项清零操作,不能与清缓存混为一谈。revert 会将接口的相关设置恢复默认,并不是恢复任意一次修改前的完整快照。
解析异常时怎样分层检查
- 确认 systemd-resolved 是否运行,以及应用实际使用的解析方式。用
ls -l /etc/resolv.conf查看文件或符号链接关系,不要先删除、替换或固定这个文件。 - 读取 status,并对照 VPN 前后、Global 与有关 Link 的服务器和域规则。当前状态可能由多个服务提供,不能只从一份文件推断来源。
- 用完整目标名称执行 query,记录错误、协议和接口信息。与 dig 的指定 DNS 查询 比较时,应注意直接查询服务器可能绕过 resolved 的分流、缓存与本地记录。
- 只有定位到配置来源后才考虑修改,并保存原值、持久配置与恢复方法。修改后重查 status 和同一名称,再用实际应用验证;远程环境还应保留独立管理通道。
/etc/resolv.conf 若指向本地 127.0.0.53 桩解析器,可把传统 DNS 客户端接入 resolved;若指向包含上游列表的兼容文件,直接读取它的客户端可能绕过 resolved。该文件格式无法完整表达每链路策略,所以看到相同服务器列表,也不等于分割 DNS 行为相同。
常见问题
resolvectl 不存在或无法连接服务怎么办?
先检查安装包、服务状态和实际 DNS 管理方式。当前系统可能不使用 systemd-resolved,也可能只是在另一容器或环境中执行;不要直接修改 /etc/resolv.conf 或重启网络来掩盖原因。
官方资料
子命令与版本条件见 systemd resolvectl 手册;分流及兼容文件行为见 systemd-resolved 服务手册。域、缓存和配置来源可查 systemd resolved.conf 项目手册,示例地址用途见 RFC 5737 文档地址说明。




