本地开发配置dnsmasq实现*.local域名解析失败，求助排查方法

你遇到的这个情况很常见——配置了dnsmasq的泛域名解析，但新的.local域名没生效，大概率是几个常见的配置遗漏或者系统默认行为导致的，我来帮你一步步排查：

1. 先确认系统是否真的在使用dnsmasq作为DNS服务器 #

你配置了dnsmasq，但如果系统的DNS解析器根本没指向它，那肯定不会生效。先检查你的系统DNS设置：

• 对于Linux系统，查看/etc/resolv.conf，里面应该有nameserver 127.0.0.1（dnsmasq默认监听127.0.0.1）。如果这里是其他DNS服务器（比如8.8.8.8），系统会跳过dnsmasq直接用外部DNS。
  • 用命令快速查看：cat /etc/resolv.conf
  • 如果不对，你需要修改DNS配置：比如在NetworkManager里把DNS设为127.0.0.1，或者针对自动生成resolv.conf的系统，修改NetworkManager配置来固定DNS指向。

2. 检查mDNS是否抢占了.local域名的解析 #

.local是mDNS（多播DNS，比如Avahi服务）的默认域名，很多Linux发行版默认开启了Avahi，它会优先处理.local域名的解析，直接把dnsmasq的规则给忽略了。

解决方法有两种：

• 方法一：临时关闭Avahi测试效果：

  sudo systemctl stop avahi-daemon
  sudo systemctl disable avahi-daemon
  

  然后重启dnsmasq：sudo systemctl restart dnsmasq，再用ping foo2.local测试是否能解析到172.17.0.1。
• 方法二：修改配置避免冲突：
  编辑dnsmasq.conf，添加两行配置：

  local=/local/
  domain=local
  

  这会明确告诉dnsmasq处理.local域的本地解析，和mDNS划清界限。或者你也可以修改Avahi的配置/etc/avahi/avahi-daemon.conf，把domain-name改成其他值（比如localnet），再重启Avahi服务。

3. 验证dnsmasq配置是否正确加载 #

有时候追加配置的命令可能没生效，先检查dnsmasq.conf里是否真的有你添加的规则：

cat /etc/dnsmasq.conf | grep "address=/local/"

如果看不到address=/local/172.17.0.1，说明之前的echo命令可能出问题了，用更可靠的方式重新添加：

echo "address=/local/172.17.0.1" | sudo tee -a /etc/dnsmasq.conf

然后重启dnsmasq，并用dig命令直接测试dnsmasq本身的解析能力：

dig @127.0.0.1 foo2.local

如果dig返回的A记录是172.17.0.1，说明dnsmasq配置没问题，问题出在系统的DNS解析器设置；如果dig也返回错误，那就要检查是否有其他dnsmasq规则覆盖了这个address指令。

4. 检查53端口是否被其他服务占用 #

dnsmasq默认监听53端口，如果有其他服务（比如systemd-resolved）占用了这个端口，dnsmasq就没法正常工作。用命令查看：

sudo lsof -i :53

如果看到其他服务在占用，先停止它：

sudo systemctl stop systemd-resolved
sudo systemctl disable systemd-resolved

再重启dnsmasq试试。

按这几步排查下来，应该能解决你的问题。优先从检查DNS指向和关闭mDNS开始，这两个是最常见的诱因。

内容的提问来源于stack exchange，提问作者Tomasz Kapłoński