devries/dnsmasq

Docker化Dnsmasq镜像

镜像概述

本镜像基于ubuntu14.04构建，内置dnsmasq服务。默认情况下，dnsmasq以root用户在控制台模式运行，主要用于提供DNS解析服务，并支持通过自定义额外hosts文件实现灵活的服务发现。

核心功能与特性

• 基础配置：运行在标准DNS端口53，使用系统默认resolv.conf进行DNS解析
• 多hosts文件支持：同时读取/etc/hosts和/etc/althosts中的主机记录
• 灵活的服务发现：通过自定义althosts文件可快速添加主机名与IP的映射关系
• 可选自动重载：在"autoreload"分支中，通过inotify监控/etc/althosts文件变化，自动重启服务（非生产环境建议）

使用场景与适用范围

• 本地开发环境中需要临时映射主机名到特定IP的场景
• 测试环境中的服务发现，无需修改系统全局hosts文件
• 需要快速切换不同服务地址映射的场景

使用方法与配置说明

基本使用步骤

1. 创建althosts文件
   在本地创建自定义hosts文件，格式与标准hosts文件一致：

   192.168.1.3 server1
   192.168.1.4 server2
   192.168.1.5 server3
   

2. 启动容器
   通过卷挂载方式将本地althosts文件映射到容器内/etc/althosts：

   bash
   docker run -d -v /path/to/althosts:/etc/althosts -p 53:53/udp docker.xuanyuan.run/devries/dnsmasq
   

3. 验证解析
   此时DNS请求server1、server2、server3将分别解析为192.168.1.3、192.168.1.4、192.168.1.5。

自动重载功能（仅autoreload分支）

"autoreload"分支提供文件变化监控功能，当/etc/althosts文件被修改时自动重启dnsmasq服务：

bash
docker run -d -v /path/to/althosts:/etc/althosts -p 53:53/udp docker.xuanyuan.run/devries/dnsmasq:autoreload

注意：此功能仅适用于开发测试环境，请勿在生产环境中使用。

致谢

感谢Rion Dooley为inotify自动重载功能提供的贡献。