jderusse/dns-gen

Docker DNS-gen镜像中文文档

镜像概述

该镜像部署运行Dnsmasq和docker-gen工具的容器，自动生成Dnsmasq配置并在容器启停时重新加载，实现Docker容器的动态DNS解析。默认提供多种容器域名格式，未知域名将fallback到主机resolv.conf处理。

核心功能

• 动态生成Dnsmasq配置，容器启停时自动更新
• 支持的默认域名格式：
  • container_name.docker
  • container_name.network_name.docker
  • docker-compose_service.docker-compose_project.docker
  • docker-compose_service.docker-compose_project.network_name.docker
• 暴露标准Dnsmasq服务，返回已知容器IP，未知域名转发至主机DNS

使用场景

• Docker开发环境中快速通过域名访问容器服务
• 多容器/多网络的Compose项目简化域名管理
• 替代手动DNS配置，提升容器网络访问效率

配置说明

前置要求

推荐安装resolvconf工具：

bash
apt install resolvconf

检查docker0接口53端口是否占用：

bash
sudo netstat -ntlp --udp|grep ":53 "

若占用，需修改服务配置排除docker0（如Dnsmasq添加except-interface=docker0）。

快速安装

执行一键脚本：

bash
sudo sh -c "$(curl -fsSL https://raw.githubusercontent.com/jderusse/docker-dns-gen/master/bin/install)"

手动安装步骤

1. 获取docker0接口IP：

bash
GATEWAY=$(ip -4 addr show docker0 | grep -oP '(?<=inet\s)\d+(\.\d+){3}')
echo ${GATEWAY}

2. 启动容器：

bash
docker run -d --name dns-gen \
  --restart always \
  --net host \
  -e GATEWAY=$GATEWAY \
  --log-opt "max-size=10m" \
  --volume /:/host \
  --volume /var/run/docker.sock:/var/run/docker.sock \
  jderusse/dns-gen:2

3. 测试解析：

bash
docker run --name test nginx:alpine
dig test.docker @${GATEWAY}

4. 更新本地 resolver：

bash
echo "nameserver ${GATEWAY}" | sudo tee --append /etc/resolvconf/resolv.conf.d/head
resolvconf -u

注意事项

• 主机重启后docker0IP可能变化，可固定IP（修改/etc/docker/daemon.json添加"bip": "172.17.42.1/24"）
• 启用Docker自动启动：sudo update-rc.d docker enable，避免启动时DNS延迟

故障排除

• 查看Dnsmasq配置：docker exec dns-gen cat /etc/dnsmasq.conf
• 检查NetworkManager状态：service NetworkManager status
• 验证resolv.conf：cat /etc/resolv.conf（需包含docker0IP）
• 查看容器日志：docker logs --tail 100 -f dns-gen