blackikeeagle/developer-dns

Docker开发者DNS

镜像概述

该DNS服务器旨在帮助开发者运行本地开发环境时，无需手动修改/etc/hosts文件，即可实现容器域名的动态解析。它通过读取容器的环境变量自动生成DNS条目，同时适配多种操作系统的解析配置方式。

核心功能

• 动态解析：基于容器的VIRTUAL_HOST或DOMAIN_NAME环境变量自动生成DNS记录
• 多域名支持：单个容器可配置多个域名（用逗号分隔）
• 系统兼容：支持resolvconf、openresolv、systemd resolved等主流解析工具
• 工具协作：与dinghy等开发工具兼容（推荐HTTP服务用VIRTUAL_HOST，其他服务用DOMAIN_NAME）

使用场景

• 本地Web开发：为微服务或多容器应用配置自定义域名，避免频繁修改hosts
• 环境模拟：在本地复现线上域名环境，简化调试流程
• 团队协作：统一开发环境的域名配置，提升协作效率

配置说明

安装部署

需挂载Docker socket以动态获取容器信息：

sh
docker run --name developer-dns \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -p 127.0.0.1:53:53/udp \
    blackikeeagle/developer-dns

Systemd服务配置
创建服务文件/etc/systemd/system/docker.developer-dns.service：

[Unit]
Description=developer-dns
After=network-online.target docker.service

[Service]
TimeoutStartSec=0
ExecStartPre=-/usr/bin/docker rm developer-dns
ExecStart=/usr/bin/docker run --rm --name developer-dns \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -p 127.0.0.1:53:53/udp \
    -p 127.0.0.1:53:53 \
    blackikeeagle/developer-dns
ExecStartPost=-/usr/bin/docker pull blackikeeagle/developer-dns
ExecStop=/usr/bin/docker stop developer-dns

[Install]
WantedBy=multi-user.target

启用并启动服务：

sh
sudo systemctl enable --now docker.developer-dns.service

添加resolv.conf支持
若需使用DHCP获取的解析配置，挂载自定义resolv.conf：

sh
-v /etc/dnsmasq-resolv.conf:/etc/resolv.conf:ro

容器域名配置

通过环境变量为容器添加DNS条目：

• 单个域名：

  sh
  docker run --env VIRTUAL_HOST=test.dev nginx
  docker run --env DOMAIN_NAME=memcached.test.dev memcached
  

• 多个域名：

  sh
  docker run --env VIRTUAL_HOST=mysite.dev,nl.mysite.dev,fr.mysite.dev nginx
  

本地解析配置

需将本地DNS指向127.0.0.1，以下是常见方法：

resolvconf（如Ubuntu）

sh
echo "nameserver 127.0.0.1" > /etc/resolvconf/resolv.conf.d/head
sudo resolvconf -u

openresolv
替换/etc/resolvconf.conf为contrib/openresolv/resolvconf.conf文件

systemd resolved（如Ubuntu 17.04+）

sh
echo "DNS=127.0.0.1" >> /etc/systemd/resolved.conf
sudo systemctl restart systemd-resolved.service

手动配置
通过NetworkManager等工具添加127.0.0.1作为DNS服务器 ===END===