phensley/docker-dns-rest

docker-dns-rest 镜像说明

镜像概述

docker-dns-rest是一个为Docker容器设计的RESTful DNS服务，主要用于测试依赖DNS进行服务发现的应用。它支持通过API动态管理域名与容器的关联，当容器启停时自动注册或注销域名，解决测试场景下的DNS解析需求。

核心功能

1. 提供REST API接口，可通过容器ID或名称关联一个或多个域名（支持通配符）
2. 容器启动时自动将关联域名解析到容器IP，停止时自动移除解析记录
3. 默认转发未匹配的域名查询到公共DNS（8.8.8.8），可通过参数关闭递归解析
4. 实时日志记录DNS解析请求和容器状态变化

使用场景

• 测试依赖DNS服务发现的微服务应用，模拟生产环境的域名解析逻辑
• 本地开发环境中，为容器分配自定义域名，简化访问流程
• 模拟staging环境的DNS配置，验证应用在特定域名下的功能正确性

配置说明

启动容器

需挂载Docker socket以监听容器事件，映射端口（默认80）：

bash
docker run -d -p 5080:80 -v /var/run/docker.sock:/docker.sock --name dns docker.xuanyuan.run/phensley/docker-dns-rest --verbose

查看日志

bash
docker logs -f dns

添加域名关联

以容器名称www为例，关联通配符域名和内部域名：

bash
# 获取DNS容器IP
DNS_IP=$(docker inspect -f '{{.NetworkSettings.IPAddress}}' dns)
# 发送PUT请求关联域名
curl -X PUT -H 'Content-Type: application/json' -d '{"domains": ["*.example.com", "www.staging.internal.com"]}' http://$DNS_IP:80/container/name/www

使用DNS服务

启动容器时指定DNS服务器：

bash
docker run -it --name shell --dns $DNS_IP --dns-search example.com ubuntu bash

关闭递归解析

启动容器时添加--no-recursion参数：

bash
docker run -d -p 5080:80 -v /var/run/docker.sock:/docker.sock --name dns docker.xuanyuan.run/phensley/docker-dns-rest --verbose --no-recursion