phensley/docker-dns

docker-dns 镜像说明

镜像概述

docker-dns是一款轻量级Docker容器自动DNS工具，通过单个Python文件实现，能够自动为Docker容器分配域名并提供DNS解析服务。它支持动态关联容器名称/ID与域名，还可通过扩展项目docker-dns-rest添加REST API，实现多域名绑定、通配符等进阶功能。

核心功能

• 自动为Docker容器生成域名（格式：容器名.指定域名）
• 支持Docker实例的TLS连接配置
• 可选递归解析（默认使用Google DNS 8.8.8.8）
• 支持自定义域名记录（含通配符）
• 提供反向IP地址解析能力

使用场景

• Docker容器间的域名解析与服务发现
• 内部测试环境中容器的便捷访问
• 配合反向代理实现多容器服务的统一入口

配置说明

基础部署

bash
# 启动示例容器
docker run -d --name foo docker.xuanyuan.run/ubuntu bash -c "sleep 600"

# 非TLS模式启动docker-dns
docker run -d --name dns -v /var/run/docker.sock:/docker.sock docker.xuanyuan.run/phensley/docker-dns \
  --domain example.com

# TLS模式启动（需配置Docker TLS地址）
docker run --name dns -e DOCKER_HOST=https://<host>:<port> --rm docker.xuanyuan.run/phensley/docker-dns --domain example.com

自定义记录配置

• 添加单条域名记录：

bash
docker run --name dns -v /var/run/docker.sock:/docker.sock docker.xuanyuan.run/phensley/docker-dns \
  --domain example.com --record localhost:127.0.0.1

• 添加通配符记录（适用于反向代理场景）：

bash
docker run --name dns -v /var/run/docker.sock:/docker.sock docker.xuanyuan.run/phensley/docker-dns \
  --domain example.com --record *:172.18.0.4

禁用递归解析

bash
docker run --name dns -v /var/run/docker.sock:/docker.sock docker.xuanyuan.run/phensley/docker-dns \
  --domain example.com --no-recursion

容器内使用示例

将docker-dns作为容器的DNS解析器：

bash
# 获取dns容器IP
DNS_IP=$(docker inspect -f '{{.NetworkSettings.IPAddress}}' dns)

# 启动容器并使用该DNS
docker run -it --dns $DNS_IP --dns-search example.com ubuntu bash

# 容器内测试解析
root@container:/# ping foo  # 自动解析为foo.example.com
root@container:/# ping github.com  # 递归解析外部域名（默认开启）

许可证

本镜像基于Apache License 2.0开源协议，详情见http://www.apache.org/licenses/LICENSE-2.0%E3%80%82