jpillora/dnsmasq

docker-dnsmasq

镜像概述

docker-dnsmasq是一个在Docker容器中运行dnsmasq的镜像，集成了基于webproc项目的简单Web UI，提供便捷的DNS服务配置与管理功能。

核心功能与特性

• 支持DNS查询日志记录（log-queries）
• 可禁用系统默认DNS服务器（no-resolv）
• 自定义上游DNS服务器（如Cloudflare、内部专用服务器等）
• 基于域名后缀的DNS服务器路由（如将特定域名查询定向到专用服务器）
• 显式定义主机-IP映射关系
• 内置Web管理界面，支持用户名密码认证
• 容器日志大小限制及自动重启功能

使用场景与适用范围

• 本地网络DNS服务管理
• 开发环境中自定义域名解析配置
• 企业内部网络DNS服务部署
• 需要快速搭建和管理DNS服务的场景

使用方法与配置说明

1. 创建配置文件

在Docker主机上创建/opt/dnsmasq.conf配置文件，示例配置如下：

ini
# dnsmasq配置，完整示例参见：http://oss.segetech.com/intra/srv/dnsmasq.conf
# 记录所有DNS查询
log-queries
# 不使用系统默认DNS服务器
no-resolv
# 使用Cloudflare作为默认DNS服务器，优先IPv4
server=1.0.0.1
server=1.1.1.1
strict-order
# 将所有.company域名查询路由到特定DNS服务器
server=/company/10.0.0.1
# 显式定义主机-IP映射
address=/myhost.company/10.0.0.2

2. 运行容器

执行以下命令启动容器：

bash
docker run \
  --name dnsmasq \
  -d \
  -p 53:53/udp \
  -p 5380:8080 \
  -v /opt/dnsmasq.conf:/etc/dnsmasq.conf \
  --log-opt "max-size=100m" \
  -e "HTTP_USER=foo" \
  -e "HTTP_PASS=bar" \
  --restart always \
  jpillora/dnsmasq

参数说明：

• -p 53:53/udp：映射DNS服务端口（UDP协议）
• -p 5380:8080：映射Web UI访问端口
• -v /opt/dnsmasq.conf:/etc/dnsmasq.conf：挂载本地配置文件到容器内
• --log-opt "max-size=100m"：限制日志文件大小为100MB
• -e "HTTP_USER=foo"：设置Web UI登录用户名
• -e "HTTP_PASS=bar"：设置Web UI登录密码
• --restart always：配置容器异常退出后自动重启

3. 访问Web UI

在浏览器中访问 http://<docker-host>:5380，使用设置的用户名（foo）和密码（bar）进行认证，即可进入Web管理界面。

4. 测试DNS服务

使用host命令测试DNS解析功能：

bash
host myhost.company <docker-host>

预期输出：

Using domain server:
Name: <docker-host>
Address: <docker-host>#53
Aliases:

myhost.company has address 10.0.0.2

许可协议

MIT License

Copyright © 2018 Jaime Pillora <***>

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.