bratkartoffel/bind9

bind9-docker 镜像文档

1. 镜像概述

bind9-docker 是一个基于 BIND9 (Berkeley Internet Name Domain) 的 Docker 镜像，提供了轻量级、可移植的 DNS 服务器解决方案。BIND9 是互联网上使用最广泛的 DNS 服务器软件之一，支持 DNSSEC、动态更新、区域传输等高级功能。该镜像旨在简化 BIND9 的部署和管理流程，适用于开发环境、测试环境以及小型生产环境的 DNS 服务需求。

2. 核心功能与特性

• 基于最新 BIND9 稳定版本：确保安全补丁和功能更新
• 轻量级设计：基于 Alpine Linux，镜像体积小，资源占用低
• 灵活配置：支持通过环境变量和外部配置文件自定义 DNS 服务
• 多架构支持：兼容 amd64、armhf、arm64 等架构
• 自动配置：可选的初始化脚本，支持快速设置基础 DNS 配置
• 日志支持：完整的 DNS 查询和错误日志记录
• 持久化存储：支持配置文件和区域数据的持久化

3. 使用场景

• 开发/测试环境中的本地 DNS 服务
• 小型网络的权威 DNS 服务器
• 作为缓存 DNS 服务器加速域名解析
• DNS 转发器配置
• 实验室或教育环境中的 DNS 教学工具
• 需要快速部署的临时 DNS 服务

4. 快速开始

4.1 基本用法

使用默认配置启动 DNS 服务器：

bash
docker run -d --name bind9 -p 53:53/tcp -p 53:53/udp bratkartoffel/bind9

4.2 自定义配置

使用外部配置文件启动：

bash
docker run -d --name bind9 \
  -p 53:53/tcp -p 53:53/udp \
  -v /path/to/named.conf:/etc/bind/named.conf \
  -v /path/to/zones:/etc/bind/zones \
  bratkartoffel/bind9

5. 详细配置

5.1 环境变量

5.2 目录结构

容器内部主要目录结构：

• /etc/bind/: BIND9 配置文件目录
  • named.conf: 主配置文件
  • named.conf.options: 全局选项配置
  • named.conf.local: 本地区域配置
• /var/cache/bind/: 缓存和区域文件目录
• /var/log/bind/: 日志文件目录

5.3 持久化数据

为确保配置和数据持久化，建议挂载以下目录：

bash
-v /host/path/config:/etc/bind
-v /host/path/cache:/var/cache/bind
-v /host/path/log:/var/log/bind

6. Docker Compose 配置

6.1 基础配置

yaml
version: '3'
services:
  bind9:
    image: bratkartoffel/bind9
    container_name: bind9
    restart: always
    ports:
      - "53:53/tcp"
      - "53:53/udp"
    environment:
      - TZ=Asia/Shanghai
      - DNS_FORWARDERS=114.114.114.114; 119.29.29.29
      - ALLOW_QUERY=192.168.0.0/24; 10.0.0.0/8
    volumes:
      - ./config:/etc/bind
      - ./cache:/var/cache/bind
      - ./log:/var/log/bind
    networks:
      - dns-network

networks:
  dns-network:
    driver: bridge

6.2 带自定义区域配置

yaml
version: '3'
services:
  bind9:
    image: bratkartoffel/bind9
    container_name: bind9
    restart: always
    ports:
      - "53:53/tcp"
      - "53:53/udp"
    environment:
      - TZ=UTC
    volumes:
      - ./named.conf:/etc/bind/named.conf
      - ./zones:/etc/bind/zones
      - ./cache:/var/cache/bind
      - ./log:/var/log/bind
    cap_add:
      - NET_ADMIN

7. 详细使用方法

7.1 自定义 DNS 区域

1. 创建区域配置文件 zones/db.example.com：

$TTL 86400
@   IN  SOA ns1.example.com. admin.example.com. (
        2023010101  ; Serial
        3600        ; Refresh
        1800        ; Retry
        604800      ; Expire
        86400       ; Minimum TTL
)
@       IN  NS  ns1.example.com.
ns1     IN  A   192.168.1.100
www     IN  A   192.168.1.101
mail    IN  A   192.168.1.102

2. 在 named.conf.local 中添加区域配置：

zone "example.com" {
    type master;
    file "/etc/bind/zones/db.example.com";
};

3. 重启容器使配置生效：

bash
docker restart bind9

7.2 查看日志

bash
docker exec -it bind9 tail -f /var/log/bind/query.log

7.3 验证 DNS 配置

bash
docker exec -it bind9 named-checkconf
docker exec -it bind9 named-checkzone example.com /etc/bind/zones/db.example.com

8. 安全注意事项

• 限制 ALLOW_QUERY 范围，避免将 DNS 服务器暴露给公网
• 定期更新镜像以获取安全补丁
• 使用非 root 用户运行容器（如配置）
• 保护 DNS 服务器免受 DDoS ***
• 考虑启用 DNSSEC 增强域名解析安全性

9. 故障排除

9.1 端口冲突

若启动时提示端口已被占用，检查宿主机是否已有服务占用 53 端口：

bash
sudo lsof -i :53

9.2 配置错误

查看容器日志排查配置问题：

bash
docker logs bind9

9.3 网络连接问题

确保容器网络配置正确，测试 DNS 解析：

bash
nslookup example.com <容器IP>

10. 相关资源

• BIND9 官方文档
• Docker 官方文档
• https://github.com/bratkartoffel/bind9-docker