jamgocoop/docker-dns

docker-dns

镜像概述

这是一个为Docker容器提供自动DNS解析服务的轻量镜像，通过单个Python文件实现，可自动将容器名称映射到其IP地址，并支持多种自定义配置，简化容器间的域名访问与服务发现。

核心功能

• 自动解析：容器启动/停止时自动添加/移除DNS记录
• 多域名支持：可为容器关联多个域名（如example.com、alias.com）
• 静态记录：支持添加容器内或外部的静态DNS记录
• 递归解析控制：可启用/禁用非指定域名的递归解析（默认使用Google DNS 8.8.8.8）
• 容器别名：通过org.jamgo.dns.alias标签为容器设置自定义DNS别名

使用场景

• Docker本地开发环境：简化容器间的域名访问
• 小型Docker集群：实现容器间的服务发现
• 自定义DNS需求：添加静态IP与域名的映射关系

配置说明

• 必须挂载Docker sock：-v /var/run/docker.sock:/docker.sock（用于监听容器事件）
• 指定域名：--domain example.com（支持多个域名，空格分隔）
• 禁用递归解析：--no-recursion（非指定域名将无法解析）
• 添加容器内静态记录：--record test:172.17.0.100（映射test.example.com到指定IP）
• 添加外部静态记录：--record-external www.example.org:10.0.0.5（映射外部域名到指定IP）
• 设置容器别名：--label org.jamgo.dns.alias=baz.otherdomain.org（为容器添加自定义别名）

部署示例

1. 基本运行

bash
docker run --name dns -v /var/run/docker.sock:/docker.sock jamgocoop/docker-dns --domain example.com

2. 多域名支持

bash
docker run --name dns -v /var/run/docker.sock:/docker.sock jamgocoop/docker-dns --domain example.com alias.com

3. 添加静态记录

bash
docker run --name dns -v /var/run/docker.sock:/docker.sock jamgocoop/docker-dns --domain example.com --record test:172.17.0.100

4. 禁用递归解析

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

5. 使用容器别名

bash
docker run -d --name foo --label org.jamgo.dns alias=baz.otherdomain.org ubuntu bash -c "sleep 600"

许可证

该镜像基于Apache License 2.0开源协议发布，详情请参考官方文档。