cilium/docker-dns-rest

docker-dns-rest

镜像概述

docker-dns-rest是一个为Docker容器提供RESTful DNS服务的工具，主要用于测试依赖DNS进行服务发现的应用。它能够将指定域名映射到Docker容器的IP地址，并在容器启停时自动注册或注销DNS记录，从而模拟特定环境（如 staging 环境）的DNS解析场景。

核心功能与特性

• RESTful API管理：通过HTTP API注册/注销容器与域名的映射关系
• 动态IP映射：容器启动时自动将域名映射到其IP，停止时自动移除映射
• 通配符域名支持：可配置带通配符的域名（如 *.example.com）
• DNS查询转发：默认将未匹配的域名查询转发至8.8.8.8，可通过参数禁用
• 容器生命周期感知：监听Docker事件，自动同步容器状态与DNS记录
• 详细日志：支持 verbose 模式输出详细操作日志

使用场景

• 测试环境中模拟服务发现场景，无需修改系统DNS配置
• 开发环境中为容器分配自定义域名，简化服务间通信
• 验证依赖DNS解析的应用在不同环境下的行为
• 快速搭建临时DNS服务，动态管理容器域名解析

使用方法

1. 启动docker-dns-rest容器

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

参数说明：

• -p 5080:80：将容器80端口映射到主机5080端口
• -v /var/run/docker.sock:/docker.sock：挂载Docker socket，用于监听容器事件
• --name dns：指定容器名称为dns
• --verbose：启用详细日志模式

2. 查看日志

bash
docker logs -f dns

3. 配置网络路由（如使用Vagrant VM）

若Docker运行在Vagrant虚拟机中，需添加路由确保主机可访问容器网络：

bash
route add -net 172.17.0.0 <Vagrant VM IP>  # 示例：route add -net 172.17.0.0 192.168.222.5

4. 获取DNS容器IP

bash
docker inspect -f '{{.NetworkSettings.IPAddress}}' dns
# 输出示例：172.17.0.2

5. 注册域名与容器映射

通过REST API将域名关联到指定容器（按名称或ID）：

bash
curl -X PUT \
  -d '{"domains": ["*.example.com", "www.staging.internal.com"]}' \
  http://<DNS容器IP>:80/container/name/www  # 示例：http://172.17.0.2:80/container/name/www

响应：{"code": 0} 表示成功

6. 启动目标容器

启动名称为www的容器（需与上一步注册的名称匹配）：

bash
docker run -it --name www docker.xuanyuan.run/ubuntu bash

此时DNS日志会显示域名映射信息：

2014-10-11T15:26:29.198673 [dnsrest] setting www (83854cf229) as active
2014-10-11T15:26:29.198821 [dnsrest] added *.example.com. -> 172.17.0.3
2014-10-11T15:26:29.198900 [dnsrest] added www.staging.internal.com. -> 172.17.0.3

7. 测试DNS解析

使用host命令测试域名解析：

bash
host test.example.com <DNS容器IP>  # 示例：host test.example.com 172.17.0.2

输出示例：

test.example.com has address 172.17.0.3

8. 容器停止与重启

• 停止容器：DNS记录自动注销

  bash
  docker stop www
  

  日志显示：

  2014-10-11T15:28:35.050232 [dnsrest] setting www (83854cf229) as inactive
  2014-10-11T15:28:35.050378 [dnsrest] removed *.example.com. -> 172.17.0.3
  

• 重启容器：DNS记录自动重新注册（使用新IP）

  bash
  docker start www
  

9. 其他容器使用该DNS服务

启动容器时通过--dns参数指定DNS服务器：

bash
docker run -it --name shell --dns <DNS容器IP> --dns-search example.com ubuntu bash

在容器内测试解析：

bash
ping foo  # 解析为 foo.example.com
ping www.staging.internal.com

配置选项

示例：禁用递归转发

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