docksal/dns

Docksal DNS Docker镜像

该镜像属于Docksal镜像库的一部分，为本地开发环境提供通配符域名解析功能。

核心功能和特性

通配符域名解析

支持任意子域名解析到指定IP地址，简化本地开发环境的域名配置。

容器服务发现

内置docker-gen工具，可自动检测容器启停并更新DNS配置。通过环境变量或标签为容器分配自定义域名，解析到容器内部IP地址。

使用场景和适用范围

适用于本地开发环境，特别是需要多个子域名或容器间服务发现的开发场景，如多服务应用开发、微服务本地调试等。

使用方法和配置说明

通配符域名解析配置

bash
$ docker run --name dns -d -e DNS_DOMAIN=docksal -e DNS_IP=192.168.64.100 docksal/dns

$ nslookup something.docksal 192.168.64.100
Server:		192.168.64.100
Address:	192.168.64.100#53

Name:	something.docksal
Address: 192.168.64.100

说明：将192.168.64.100替换为您的Docker主机IP。上述命令启动DNS服务后，所有*.docksal格式的域名都会解析到指定的Docker主机IP。

容器服务发现配置

使用环境变量指定域名

bash
docker run --name dns-test -d -e DNS_NAME=test.mydomain.com docker.xuanyuan.run/busybox top
 
$ nslookup test.mydomain.com 192.168.64.100
Server:		192.168.64.100
Address:	192.168.64.100#53

Name:	test.mydomain.com
Address: 172.17.0.5

使用标签指定域名

bash
$ docker run --name dns-test2 -d --label dns.name=test2.mydomain2.com busybox top

$ nslookup test2.mydomain2.com 192.168.64.100
Server:		192.168.64.100
Address:	192.168.64.100#53

Name:	test2.mydomain2.com
Address: 172.17.0.6

说明：将192.168.64.100替换为您的Docker主机IP。通过DNS_NAME环境变量或dns.name标签为容器分配的域名，会自动解析到容器的内部IP地址。

调试

启动容器时设置LOG_QUERIES=true可启用查询日志：

bash
docker run --name dns -d -e DNS_DOMAIN=docksal -e DNS_IP=192.168.100.64 -e LOG_QUERIES=true docker.xuanyuan.run/docksal/dns

通过以下命令查看日志：

bash
docker logs dns

环境变量说明