skopciewski/dnsmasq

dnsmasq 镜像文档

镜像概述和主要用途

本镜像为个人使用的dnsmasq DNS服务器镜像，提供轻量级、可自定义的DNS服务部署方案。适用于需要本地DNS解析、网络测试或自定义DNS规则的场景，支持通过挂载配置文件实现灵活配置管理。

核心功能和特性

• 参数重定向：入口点将所有传递参数直接转发至dnsmasq命令，支持完整的dnsmasq功能配置
• 默认配置：内置默认运行参数-d -C dnsmasq.conf，简化基础部署流程
• 多命令支持：通过escto参数可切换执行容器内其他命令（如shell）
• 固定工作目录：工作目录设为/mnt/dnsmasq，便于配置文件的挂载和管理

使用场景和适用范围

• 本地DNS服务器搭建
• 自定义DNS解析规则（如广告拦截、本地域名映射）
• 网络环境测试与调试
• 开发/测试环境中的DNS服务模拟

使用方法和配置说明

基本部署

通过以下命令启动dnsmasq容器，映射DNS服务端口并挂载配置目录：

bash
docker run -d --rm --name dnsmasq -p 53:53/udp -v /my/dnsmasq_dir:/mnt/dnsmasq skopciewski/dnsmasq

入口点（Entrypoint）

容器入口点负责将所有命令行参数传递给dnsmasq进程，工作目录固定为/mnt/dnsmasq。

默认运行参数

若未指定额外参数，容器将使用默认参数组合运行：

bash
-d -C dnsmasq.conf

参数说明：

• -d：以守护进程模式运行dnsmasq
• -C dnsmasq.conf：指定配置文件路径为工作目录下的dnsmasq.conf

执行其他命令（Escape to）

如需在容器内执行dnsmasq以外的命令，可将escto作为首个参数传入。例如启动交互式shell：

bash
docker run -it --rm --name dnsmasq -p 52:52/udp -v /my/dnsmasq_dir:/mnt/dnsmasq skopciewski/dnsmasq escto sh

依赖和要求

运行容器前需满足以下条件：

• 配置目录挂载：必须将本地配置目录挂载至容器内/mnt/dnsmasq路径
• 配置文件要求：挂载目录中需包含dnsmasq.conf文件，作为dnsmasq的主配置文件