digitallumberjack/docker-bind9

docker-bind9 镜像说明

镜像概述

本镜像提供BIND9域名服务器的Docker化部署，支持通过环境变量配置根域名、访问密钥、DNS转发器等参数，可快速搭建针对单个根域名的DNS服务，并接受合法更新请求。

核心功能

1. 为指定根域名提供权威DNS解析服务
2. 支持通过环境变量配置访问密钥（用于DNS更新）
3. 可设置DNS转发器（如公共DNS服务器）
4. 允许添加静态DNS条目
5. 支持仅IPV4模式
6. 可配置缓存查询和递归请求的允许IP范围

使用场景

• 企业内部网络的私有DNS服务
• 个人或项目的自定义域名解析需求
• 测试环境中的DNS配置验证
• 需要灵活更新DNS条目的场景

配置说明

以下环境变量可在运行时设置：

• BIND9_IP：DNS服务器的公网IP
• BIND9_ROOTDOMAIN：根域名（如example.com）
• BIND9_KEYNAME：更新密钥的名称
• BIND9_KEY：Base64编码的更新密钥
• BIND9_KEY_ALGORITHM：密钥算法（如hmac-md5、hmac-sha256等）
• BIND9_FORWARDERS：DNS转发器（如"8.8.8.8;8.8.4.4;"）
• BIND9_IPV4ONLY：是否仅支持IPV4（设置后启用）
• BIND9_QUERY_CACHE_ACCEPT：允许缓存查询的IP范围（默认127.0.0.1）
• BIND9_RECURSION_ACCEPT：允许递归请求的IP范围（默认127.0.0.1）
• BIND9_STATIC_ENTRIES：多行静态DNS条目（如"www CNAME a.fqdn.com\nblog 60 A 10.10.10.10"）

部署示例

带转发器的部署

bash
sudo docker run --name bind9 --restart=unless-stopped \
    -e "BIND9_IP=10.10.12.23" \
    -e "BIND9_ROOTDOMAIN=example.com" \
    -e "BIND9_KEYNAME=secret" \
    -e "BIND9_KEY_ALGORITHM=hmac-md5" \
    -e "BIND9_KEY=c2VjcmV0" \
    -e "BIND9_FORWARDERS=8.8.8.8;8.8.4.4;" \
    -p "172.17.0.1:53:53/udp" \
    -p "172.17.0.1:53:53" digitallumberjack/docker-bind9:latest

仅权威服务（无转发器）

bash
sudo docker run --name bind9 --restart=unless-stopped \
    -e "BIND9_IP=10.10.12.23" \
    -e "BIND9_ROOTDOMAIN=example.com" \
    -e "BIND9_KEYNAME=secret" \
    -e "BIND9_KEY_ALGORITHM=hmac-md5" \
    -e "BIND9_KEY=c2VjcmV0" \
    -e "BIND9_FORWARDERS=" \
    -p 53:53/udp \
    -p 53:53 digitallumberjack/docker-bind9:latest

带静态条目的部署

bash
sudo docker run --name bind9 --restart=unless-stopped \
    -e "BIND9_IP=10.10.12.23" \
    -e "BIND9_ROOTDOMAIN=example.com" \
    -e "BIND9_KEYNAME=secret" \
    -e "BIND9_KEY_ALGORITHM=hmac-md5" \
    -e "BIND9_KEY=c2VjcmV0" \
    -e "BIND9_FORWARDERS=" \
    -e BIND9_STATIC_ENTRIES="www CNAME a.fqdn.com\nblog 60 A 10.10.10.10" \
    -p 53:53/udp \
    -p 53:53 digitallumberjack/docker-bind9:latest

手动更新DNS条目

使用nsupdate工具添加条目：

bash
nsupdate -y secret:c2VjcmV0
server 10.10.12.23
update add myentry.example.com 60 A 10.10.14.100
send

查询域名所有条目

通过AXFR请求获取完整域名条目：

bash
dig -y secret:c2VjcmV0 @10.10.12.23 example.com axfr

详细用法请参考nsupdate和dig的官方文档。