使用 dnsmasq 搭建本地 DNS 服务器完整指南

使用 dnsmasq 搭建本地 DNS 服务器完整指南

目录

文章目录

• 使用 dnsmasq 搭建本地 DNS 服务器完整指南
• • 目录
  • 概述
  • DNS 服务器工具选型指南
  • • 主要 DNS 服务器工具对比
    • 选型建议
  • 环境准备
  • 第一阶段：基础安装与初始配置
  • • 安装 dnsmasq
    • 初始配置文件
    • 启动服务
  • 为什么选择 dnsmasq
  • 第二阶段：遇到的问题与解决方案
  • • 问题 1: REFUSED 错误
    • 问题 2: SERVFAIL 错误
    • 问题 3: NXDOMAIN 错误
  • 详细的调试命令集
  • • 基本服务状态检查
    • 网络和端口检查
    • DNS 查询测试命令
    • 配置文件检查和验证
    • 高级调试技巧
  • 第三阶段：最终成功配置
  • • 完整配置文件 (`/etc/dnsmasq.conf`)
    • 配置验证命令
    • 最终验证结果
  • 其他 DNS 工具的使用场景
  • • 如果选择 BIND
    • 如果选择 CoreDNS
  • 第四阶段：同 IP 不同端口服务的域名配置
  • • DNS 配置部分
    • 使用 Nginx 反向代理处理端口差异
  • 第五阶段：高级功能与优化
  • • 通配符域名解析
    • 性能优化
    • 客户端配置
  • 工具选型总结表
  • 经验总结
  • • 调试命令总结
    • 成功关键点
    • 常见错误与解决思路
    • 最佳实践建议
  • 结语

概述

在企业内部网络或开发测试环境中，经常需要搭建本地 DNS 服务器来解析自定义域名。dnsmasq 是一个轻量级的 DNS 转发器和 DHCP 服务器，非常适合这种场景。本文将详细记录我从零开始搭建 dnsmasq DNS 服务器，并解决遇到的各种错误的完整过程。

DNS 服务器工具选型指南

主要 DNS 服务器工具对比

选型建议

环境准备

• 操作系统: CentOS/RHEL 或 Ubuntu/Debian
• 服务器 IP: 192.168.1.201
• 目标域名:
  • aaa-test.comm → 192.168.1.188
  • bbb.test.comm → 192.168.1.201

第一阶段：基础安装与初始配置

安装 dnsmasq

在 Ubuntu/Debian 上:

sudo apt update
sudo apt install dnsmasq

在 CentOS/RHEL 上:

sudo yum install dnsmasq

初始配置文件

创建初始配置文件 (/etc/dnsmasq.conf):

# 基本网络配置
port=53
listen-address=192.168.1.201,127.0.0.1

# 上游DNS服务器（用于解析非本地域名）
server=192.168.100.99

# 安全配置
user=dnsmasq
group=dnsmasq
local-service=host

# 域名处理
local=/comm/
domain=comm

# 域名解析 – 使用双重保障
address=/bbb.test.comm/192.168.1.201
host-record=bbb.test.comm,192.168.1.201

address=/aaa-test.comm/192.168.1.188
host-record=aaa-test.comm,192.168.1.188

启动服务

sudo systemctl start dnsmasq
sudo systemctl enable dnsmasq

为什么选择 dnsmasq

在本次实践中选择 dnsmasq 的主要原因：

第二阶段：遇到的问题与解决方案

问题 1: REFUSED 错误

错误信息:

nslookup aaa-test.comm 192.168.1.201
Server: 192.168.1.201
Address: 192.168.1.201#53

Name: aaa-test.comm
Address: 192.168.1.188
** server can't find aaa-test.comm: REFUSED

调试命令:

# 检查服务状态
sudo systemctl status dnsmasq

# 检查配置文件
sudo grep -v "^#" /etc/dnsmasq.conf | grep -v "^$"

# 测试配置语法
sudo dnsmasq –test

解决方案: 添加本地域名声明:

local=/comm/
domain=comm

问题 2: SERVFAIL 错误

错误信息:

nslookup aaa-test.comm 192.168.1.201
Server: 192.168.1.201
Address: 192.168.1.201#53

Name: aaa-test.comm
Address: 192.168.1.188
** server can't find aaa-test.comm: SERVFAIL

调试命令:

# 启用调试模式查看详细日志
sudo systemctl stop dnsmasq
sudo dnsmasq –no-daemon –log-queries –conf-file=/etc/dnsmasq.conf

解决方案: 完全禁用上游 DNS 转发:

no-resolv
no-poll

问题 3: NXDOMAIN 错误

错误信息:

nslookup aaa-test.comm 192.168.1.201
** server can't find aaa-test.comm: NXDOMAIN

调试命令:

# 检查当前配置
sudo grep -v "^#" /etc/dnsmasq.conf | grep -v "^$"

解决方案: 增加配置语法:

host-record=aaa-test.comm,192.168.1.188

详细的调试命令集

基本服务状态检查

# 检查服务状态
sudo systemctl status dnsmasq

# 查看服务日志
sudo journalctl -u dnsmasq -f

# 查看最近10条日志
sudo journalctl -u dnsmasq -n 10 –no-pager

网络和端口检查

# 检查53端口监听情况
sudo netstat -tulpn | grep :53

# 检查防火墙状态
sudo iptables -L -n

# 测试网络连通性
ping -c 3 192.168.1.201

DNS 查询测试命令

# 使用nslookup测试
nslookup aaa-test.comm 192.168.1.201

# 使用dig测试（更详细）
dig @192.168.1.201 aaa-test.comm

# 测试反向解析
dig @192.168.1.201 -x 192.168.1.188

# 使用host命令测试
host aaa-test.comm 192.168.1.201

配置文件检查和验证

# 检查主配置文件
sudo cat /etc/dnsmasq.conf

# 检查非注释行
sudo grep -v "^#" /etc/dnsmasq.conf | grep -v "^$"

# 测试配置文件语法
sudo dnsmasq –test

高级调试技巧

# 调试模式运行（前台运行，显示详细日志）
sudo systemctl stop dnsmasq
sudo pkill dnsmasq
sudo dnsmasq –no-daemon –log-queries –conf-file=/etc/dnsmasq.conf

# 检查进程运行参数
ps aux | grep dnsmasq | grep -v grep

第三阶段：最终成功配置

完整配置文件 (/etc/dnsmasq.conf)

# 基本网络配置
port=53
listen-address=192.168.1.201,127.0.0.1

# 上游DNS服务器（用于解析非本地域名）
server=192.168.100.99

# 安全配置
user=dnsmasq
group=dnsmasq
local-service=host

# 域名处理
local=/comm/
domain=comm

# 域名解析 – 使用双重保障
address=/bbb.test.comm/192.168.1.201
host-record=bbb.test.comm,192.168.1.201

address=/aaa-test.comm/192.168.1.188
host-record=aaa-test.comm,192.168.1.188

配置验证命令

# 重启服务应用新配置
sudo systemctl restart dnsmasq

# 验证配置语法
sudo dnsmasq –test

# 测试域名解析
nslookup aaa-test.comm 192.168.1.201
nslookup bbb.test.comm 192.168.1.201

# 使用dig进行详细验证
dig @192.168.1.201 aaa-test.comm +short
dig @192.168.1.201 bbb.test.comm +short

最终验证结果

成功解析的返回信息:

nslookup aaa-test.comm 192.168.1.201
Server: 192.168.1.201
Address: 192.168.1.201#53

Name: aaa-test.comm
Address: 192.168.1.188

其他 DNS 工具的使用场景

如果选择 BIND

BIND 的配置会更加复杂，但功能更强大:

# 安装 BIND
sudo yum install bind bind-utils

# 配置示例
zone "comm" IN {
type master;
file "comm.zone";
};

如果选择 CoreDNS

CoreDNS 使用更现代的配置方式:

# Corefile 配置
.:53 {
hosts {
192.168.1.188 aaa-test.comm
192.168.1.201 bbb.test.comm
fallthrough
}
forward . 192.168.100.99
cache
}

第四阶段：同 IP 不同端口服务的域名配置

DNS 配置部分

在 dnsmasq 中配置多个域名指向同一 IP:

address=/web.comm/192.168.1.188
address=/api.comm/192.168.1.188
address=/db.comm/192.168.1.188

使用 Nginx 反向代理处理端口差异

server {
listen 80;
server_name web.comm;
location / {
proxy_pass http://192.168.1.188:3000;
}
}

server {
listen 80;
server_name api.comm;
location / {
proxy_pass http://192.168.1.188:3001;
}
}

第五阶段：高级功能与优化

通配符域名解析

# 所有 .comm 子域名都解析到指定 IP
address=/.comm/192.168.1.188

性能优化

cache-size=1000
local-ttl=300

客户端配置

Linux/Mac:

echo "nameserver 192.168.1.201" | sudo tee /etc/resolv.conf

Windows: 在网络适配器设置中将 DNS 服务器设置为 192.168.1.201

工具选型总结表

经验总结

调试命令总结

成功关键点

常见错误与解决思路

最佳实践建议

结语

通过本次完整的 dnsmasq 配置实践，我们不仅成功搭建了本地 DNS 服务器，更重要的是掌握了系统性的问题排查方法。从最初的简单配置到最终的功能完善配置，每一步都基于对错误信息的深入分析和理解。

调试的重要性: 本文详细记录了各种调试命令的使用方法和输出分析，这些工具和技巧对于解决实际的网络服务问题至关重要。

工具选型建议: 对于大多数中小型企业的内部网络、开发测试环境以及家用网络，dnsmasq 是最佳选择。它的简单性和易用性大大降低了维护成本。

这种"从错误中学习"的方法对于任何技术实践都具有重要价值。希望本文的记录能够为遇到类似问题的读者提供有用的参考和解决问题的思路。