tonnerre/bind-companion

Bind Companion 镜像说明

镜像概述

Bind Companion是一款用于容器环境的Bind DNS服务器控制进程，核心作用是构建Bind配置文件，并在域名区域文件变更时自动触发Bind重载配置，确保DNS服务实时更新。

核心功能

• 监控外部文件写入事件，自动触发Bind配置重载
• 基于文本协议缓冲区配置文件生成Bind配置
• 支持与Git sidecar容器联动，同步域名区域文件并更新DNS配置
• 通过Makefile生成域名配置模板，适配动态场景

使用场景

• 容器化DNS服务部署，需自动同步Git仓库中域名区域文件的场景
• 管理多类型域名区域（主、从、转发）的DNS服务器环境
• 需要实时响应域名配置变更的企业级DNS服务场景

配置说明

卷挂载要求

该镜像需要挂载以下卷：

1. /etc/bind/git/masterzones：主区域文件目录，文件命名格式为域名.db（如example.org.db）
2. /etc/bind/slavezones：从区域文件缓存目录（建议持久化存储）
3. /config：存放Bind配置协议缓冲区文件bind.config

主区域目录规则

• 目录下需放置Makefile，用于从模板生成域名配置
• 目录需允许named用户写入（Makefile将以该用户身份执行）
• 检测到文件变更时，自动执行Makefile并触发Bind重载

Bind配置协议缓冲区格式

配置文件包含域名配置和传输权限两部分：

• 域名配置：指定域名名称、类型（MASTER/SLAVE/FORWARD）及主服务器地址（仅SLAVE/FORWARD类型需填写）
• 传输权限：允许全区域传输的IP列表（通常为从服务器IP）

示例配置：

domain {
    name: "example.org"
    type: MASTER
}

domain {
    name: "example.net"
    type: SLAVE
    master: "127.0.0.1"
}

domain {
    name: "kubernetesexample.net"
    type: FORWARD
    master: "127.0.2.1"
}

allow_transfer: "127.0.0.1"
allow_transfer: "127.0.0.2"
allow_transfer: "127.0.1.1"

部署示例

Docker Run命令

bash
docker run -d \
  --name bind-companion \
  -v /host/masterzones:/etc/bind/git/masterzones \
  -v /host/slavezones:/etc/bind/slavezones \
  -v /host/config:/config \
  --link bind-server:bind \
  docker.xuanyuan.run/tonnerre/bind-companion

注意事项

• 确保Bind服务器容器已正确运行并命名为bind-server
• 主区域目录需提前准备Makefile及域名文件
• 配置文件bind.config需放置在/host/config目录下

TODO

• 增加Prometheus监控支持（提取Bind进程统计信息）
• 添加健康检查处理程序