grahamdumpleton/wildcard-dns-server

Wildcard DNS服务器镜像

镜像概述

本镜像提供一个实验性的DNS服务器，实现了xip.io风格的通配符DNS解析、传统glob风格的通配符映射，以及对其他DNS查询的转发功能。它基于Python的Twisted框架构建，便于进行DNS拦截相关的实验。

核心功能

• 支持xip.io风格的IP通配符解析（如myapp.10.2.2.2.xip.io解析为10.2.2.2）
• 支持glob风格的主机映射（如*.foo.com映射到指定IP或域名）
• 可自定义通配符域名（默认使用xip.io）
• 可配置备用DNS服务器（默认使用Google DNS）
• 支持调试模式查看DNS查询日志
• 非root用户运行（使用www-data用户）

使用场景

• 本地开发环境：无需修改hosts文件即可访问多个本地服务
• 测试多域名应用：快速验证不同域名指向同一服务的场景
• 实验DNS拦截功能：基于Twisted框架进行DNS相关的扩展开发

配置说明

构建镜像

bash
docker build -t wildcard-dns-server .

运行镜像

默认运行

映射TCP和UDP的53端口（需确保本地53端口未被占用）：

bash
docker run --rm -p 53:10053/tcp -p 53:10053/udp wildcard-dns-server

自定义通配符域名

使用WILDCARD_DOMAIN环境变量指定自定义域名：

bash
docker run --rm -p 53:10053/tcp -p 53:10053/udp \
  -e WILDCARD_DOMAIN=wildcard.dev wildcard-dns-server

测试示例：

bash
dig @$(docker-machine ip default) myapp.10.2.2.2.wildcard.dev A +short

预期结果为10.2.2.2。

配置备用DNS服务器

使用NAME_SERVERS环境变量指定备用DNS（逗号分隔，可带端口）：

bash
docker run --rm -p 53:10053/tcp -p 53:10053/udp \
  -e NAME_SERVERS="8.8.8.8:53,8.8.4.4:53" wildcard-dns-server

配置主机映射表

创建JSON格式的映射文件（如mappings.json）：

json
{
  "*.foo.com": "127.0.0.1",
  "www.bar.com": "bar.com",
  "bar.com": "127.0.0.1",
  "search.com": "www.google.com"
}

通过卷挂载和MAPPED_HOSTS环境变量加载映射：

bash
docker run --rm -p 53:10053/tcp -p 53:10053/udp \
  -e MAPPED_HOSTS=/usr/src/app/etc/mappings.json \
  -v $(pwd)/etc:/usr/src/app/etc wildcard-dns-server

启用调试模式

设置DEBUG_LEVEL环境变量（最高为3）：

bash
docker run --rm -p 53:10053/tcp -p 53:10053/udp \
  -e DEBUG_LEVEL=3 -e WILDCARD_DOMAIN=wildcard.dev wildcard-dns-server

使用Registry镜像

直接拉取Docker Hub上的镜像：

bash
docker pull grahamdumpleton/wildcard-dns-server

更新系统DNS设置

将系统DNS指向Docker服务主机的IP：

bash
docker-machine ip default

（注：在无网络连接的MacOS系统中可能无法使用，需连接网络或使用物理环回设备）