pwa666/bind9

Bind9 镜像文档

1. 镜像概述

Bind9 镜像是一个基于 Alpine Linux 的轻量级容器，集成了 Bind9 DNS 服务器和 Webmin 管理界面。该镜像旨在提供简单易用的 DNS 服务部署方案，同时支持通过 Web 界面便捷管理 Bind9 配置。自 2.1.x 版本起，镜像提供多架构支持。

2. 核心功能与特性

2.1 核心组件

• Bind9：DNS 服务器软件，包含 bind9、bind9-tools（工具集）、bind9-dnssec（DNSSEC 支持）
• Webmin：仅包含 Bind 模块（版本 1.979），提供 Web 管理界面
• Perl：Webmin 运行依赖

2.2 关键特性

• 轻量级：基于 Alpine Linux，镜像体积小，资源占用低
• 多架构支持：自 2.1.x 版本起支持多种硬件架构
• IPv6 控制：可通过环境变量启用/禁用 IPv6 支持
• 扩展日志：支持开启扩展日志模式，允许在 Bind 配置中自定义 logging {} 块
• 灵活配置：支持通过卷挂载自定义 Bind 配置文件

3. 使用场景

• 小型网络 DNS 服务：需要轻量级、易管理的 DNS 服务器场景
• 开发/测试环境：快速部署 DNS 服务用于应用测试
• Web 管理需求：需要通过 Web 界面（而非命令行）管理 DNS 配置的场景
• 多架构部署：需在不同硬件架构（如 x86_64、ARM）上统一部署 DNS 服务的场景

4. 使用方法

4.1 构建镜像

从源码构建镜像：

bash
docker build -t <镜像名称>:<标签> .

4.2 Docker Run 部署

直接运行容器（基础示例）：

bash
docker run -d \
  --name bind9-server \
  -v /本地路径/bind/config:/etc/bind \  # 挂载 Bind 配置目录
  -e TZ="Asia/Shanghai" \              # 设置时区
  -e GUI_USER="admin" \                # 自定义 Webmin 用户名
  -e GUI_PASSWORD="mypassword" \       # 自定义 Webmin 密码
  -p 53:53/udp \                       # DNS 服务端口（UDP）
  -p 10000:10000/tcp \                 # Webmin 管理端口（TCP）
  --restart always \
  <镜像名称>:<标签>

4.3 Docker Compose 部署

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  bind:
    image: <镜像名称>:<标签>
    volumes:
      - "/本地路径/bind/config:/etc/bind"  # 挂载本地 Bind 配置目录
    restart: always
    environment:
      TZ: "Asia/Shanghai"                  # 时区（如 "Region/City" 格式）
      GUI_USER: "admin"                    # Webmin 用户名（可选，默认：admin）
      GUI_PASSWORD: "mypassword"           # Webmin 密码（可选，默认：difficult）
      IPV6: "disable"                      # IPv6 开关（可选，默认：disable）
      EXTEND_LOGGING: "false"              # 扩展日志开关（可选，默认：false）
    ports:
      - "53:53/udp"                        # DNS 服务端口（UDP）
      - "10000:10000/tcp"                  # Webmin 管理端口（TCP）
    # 可选：使用 host 网络模式（替代 ports 映射，直接使用主机网络）
    # network_mode: host

启动服务：

bash
docker-compose up -d

5. 配置说明

5.1 卷挂载

• /etc/bind：Bind 配置文件目录。需将本地配置目录挂载至此，实现配置持久化和自定义。示例：-v /local/bind/config:/etc/bind

5.2 端口映射

替代方案：若使用 network_mode: host，无需单独映射端口，容器直接使用主机网络。

6. 环境变量详解