zachbg/docker-dns

Docker DNS

为Docker容器提供自动DNS解析服务，您可以通过名称访问任何容器（例如 curl http://myapp.docker），无需硬编码IP或依赖Docker的内部DNS。

为什么选择它？

Docker内置DNS仅在同一Compose网络内有效，跨网络、跨项目以及主机到容器的DNS解析不存在。您最终可能需要硬编码IP或创建大型共享网络。Docker-dns通过运行本地DNS服务器解决了这个问题，该服务器自动将容器名称解析为IP地址。

快速启动

yaml
services:
  dns:
    image: docker.xuanyuan.run/zachbg/docker-dns:latest
    restart: unless-stopped
    ports:
      - "53:53/udp"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
    environment:
      DNS_DOMAIN: docker

然后配置您的系统使用它：

macOS:

bash
sudo mkdir -p /etc/resolver
echo "nameserver 127.0.0.1" | sudo tee /etc/resolver/docker

Linux: 添加到 /etc/resolv.conf:

nameserver 127.0.0.1

现在您可以：curl http://myapp.docker、ping postgres.docker、dig redis.docker

环境变量

容器标签

工作原理

1. 监听Docker中运行的容器
2. 将容器名称映射到其IP地址
3. 通过dnsmasq提供DNS查询服务
4. 容器启动/停止时自动更新

示例

自定义域名

yaml
environment:
  DNS_DOMAIN: dev
# 访问：myapp.dev、postgres.dev、redis.dev

通过标签自定义主机名

yaml
services:
  webapp:
    image: docker.xuanyuan.run/nginx
    labels:
      dns.hostname: "app"
# 访问：app.docker

仅解析带有指定标签的容器

yaml
services:
  dns:
    image: docker.xuanyuan.run/zachbg/docker-dns:latest
    environment:
      DNS_LABEL: "dns.enable"

  webapp:
    image: docker.xuanyuan.run/nginx
    labels:
      dns.enable: "true"
# 仅webapp会被解析，其他容器将被忽略

跨项目解析

# 项目A（docker compose -p projecta up）
projecta-web-1.docker -> 172.18.0.2

# 项目B（docker compose -p projectb up）
projectb-api-1.docker -> 172.19.0.3

# 从主机访问：
curl [***]
curl [***]