m4rcu5/pdns-recursor

PowerDNS Recursor Docker镜像文档

镜像概述和主要用途

本镜像基于Alpine Linux 3.8构建，包含PowerDNS Recursor 4.1.9，提供DNS递归解析服务。PowerDNS Recursor是一款高性能的DNS递归服务器，能够处理大量DNS查询并返回权威结果。该镜像设计为开箱即用，同时支持灵活的自定义配置，适用于需要可靠DNS解析服务的私有网络环境。

核心功能和特性

• 默认配置可用：无需额外配置即可在私有网络中提供DNS递归解析服务
• 轻量级基础：基于Alpine Linux 3.8，镜像体积小，资源占用低
• 自定义配置支持：通过挂载卷添加自定义配置文件，覆盖默认设置
• 时间同步：支持挂载主机时间文件，确保容器内时间准确性
• DNSSEC验证：可通过配置启用DNSSEC查询验证功能
• 灵活的区域管理：支持添加自定义DNS区域文件，实现本地域名解析

使用场景和适用范围

• 私有网络环境中的DNS递归解析服务
• 需要自定义DNS区域解析的场景（如本地域名映射）
• 对DNS查询性能有要求的应用环境
• 需要启用DNSSEC验证的安全敏感环境
• 开发测试环境中的DNS服务搭建

使用方法和配置说明

默认配置

在私有网络环境中，无需额外配置即可直接使用镜像。创建容器命令如下：

bash
docker container run \
    --detach \
    --hostname resolver.local \
    --name pdns-recursor \
    --mount type=bind,src=/etc/localtime,dst=/etc/localtime,readonly=true \
    m4rcu5/pdns-recursor:latest

参数说明：

• --detach：后台运行容器
• --hostname resolver.local：设置容器主机名
• --name pdns-recursor：指定容器名称
• --mount：挂载主机时间文件，确保容器时间与主机同步

验证服务

假设容器IP为172.17.0.4，可使用dig命令测试DNS解析：

bash
dig +tcp @172.17.0.4 google.com

预期输出示例：

; <<>> DiG 9.10.3-P4-Ubuntu <<>> +tcp google.com @172.17.0.4
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 55033
;; flags: qr rd ra; QUERY: 1, ANSWER: 1, AUTHORITY: 0, ADDITIONAL: 1

;; OPT PSEUDOSECTION:
; EDNS: version: 0, flags:; udp: 4096
;; QUESTION SECTION:
;google.com.            IN  A

;; ANSWER SECTION:
google.com.     300 IN  A   216.58.211.110

;; Query time: 37 msec
;; SERVER: 172.17.0.4#53(172.17.0.4)
;; WHEN: Thu Aug 31 23:35:44 CEST 2017
;; MSG SIZE  rcvd: 55

自定义配置

通过挂载包含自定义配置文件的目录，可以覆盖默认设置。配置文件需放置在/data/recursor-conf.d/目录下，支持.conf格式文件。

配置文件结构

假设主机上的配置目录结构如下（以/opt/pdns-recursor/data为例）：

/opt
└── pdns-recursor
    └── data
        ├── recursor-conf.d  # 自定义配置文件目录
        │   └── auth-zones.conf  # 区域授权配置示例
        ├── scripts  # 脚本目录（如需要）
        └── zones  # 区域文件目录
            └── localhost  # localhost区域文件

挂载自定义配置

使用以下命令挂载本地配置目录并启动容器：

bash
docker container run \
    --detach \
    --hostname resolver.local \
    --name pdns-recursor \
    --mount type=bind,src=/etc/localtime,dst=/etc/localtime,readonly=true \
    --mount type=bind,src=/opt/pdns-recursor/data,dst=/data,readonly=true \
    m4rcu5/pdns-recursor:latest

此时，Recursor会自动加载/data/recursor-conf.d/目录下的配置文件，并使用/data/zones/目录中的区域文件处理对应域名查询。

启用DNSSEC验证

创建DNSSEC配置文件并重启容器即可启用DNSSEC验证：

bash
# 创建DNSSEC配置文件
echo 'dnssec=validate' > /opt/pdns-recursor/data/recursor-conf.d/dnssec.conf

# 重启容器使配置生效
docker container restart pdns-recursor

完整配置参数

PowerDNS Recursor的所有配置参数详见官方文档：https://doc.powerdns.com/md/recursor/settings/