oakmoss/powerdns-recursor

powerdns-recursor-docker镜像说明

镜像概述

本镜像基于tcely/powerdns-recursor构建，作为DNS递归器，在权威DNS服务器与转发/递归DNS服务器（如PiHole）之间转发查询。支持将特定域名转发到指定权威服务器，其余域名转发到其他递归服务器，并可从Docker Swarm服务自动获取DNS服务器IP。v2.0.0版本与v1.0.6功能等效，但调整了部分环境变量名称。

核心功能

1. 域名转发策略：通过forward-zones和forward-zones-recurse配置，实现特定域名到权威服务器、其余到转发服务器的分流。
2. Docker Swarm支持：可通过服务名称自动获取集群内权威/转发DNS服务器的IP地址。
3. 灵活配置：支持环境变量设置转发规则，也可通过命令行参数覆盖默认配置。

使用场景

• 企业内部DNS架构：私有域名转发到内部权威DNS，公共域名转发到PiHole过滤广告。
• Docker Swarm集群：自动发现DNS服务IP，简化部署维护。

配置说明

环境变量

权威域名转发

• DNS_AUTH_ZONES：需转发到权威服务器的域名列表（空格/逗号分隔，如myprivatedomain.co.uk,private2.com）。

权威服务器配置

• DNS_AUTH_IP_ADDRESSES：权威DNS IP列表（;分隔，支持端口如10.10.100.1:5300）。
• DNS_AUTH_SERVICE：Docker Swarm中权威DNS服务名称（自动获取IP）。
  注：两者至少设置一个，同时设置时DNS_AUTH_IP_ADDRESSES失效。

转发服务器配置

• DNS_FORWARDER_IP_ADDRESSES：转发DNS IP列表（语法同权威IP）。
• DNS_FORWARDER_SERVICE：Docker Swarm中转发DNS服务名称。
  注：两者至少设置一个，同时设置时DNS_FORWARDER_IP_ADDRESSES失效。

默认配置调整

原镜像配置修改如下：

• disable-syslog=yes
• log-timestamp=no
• local-address=0.0.0.0
• setuid=pdns-recursor
• setgid=pdns-recursor

配置覆盖

通过命令行参数覆盖默认配置：

bash
docker run -d -p 53:53 -p53:53/tcp \
  --name powerdns-recursor \
  -e DNS_AUTH_ZONES=myprivatedomain.co.uk,private2.com \
  -e DNS_AUTH_IP_ADDRESSES=10.10.100.1;10.20.100.2 \
  -e DNS_FORWARDER_IP_ADDRESSES=10.30.100.3 \
  oakmoss/powerdns-recursor \
  --local-address=10.100.100.1

部署示例

Docker Run命令

bash
docker run -d -p53:53 -p53:53/tcp \
  --name powerdns-recursor \
  -e DNS_AUTH_ZONES=myprivatedomain.co.uk,private2.com \
  -e DNS_AUTH_IP_ADDRESSES=10.10.100.1;10.20.100.2 \
   -e DNS_FORWARDER_IP_ADDRESSES=10.30.100.3 \
  oakmoss/powerdns-recursor

Docker Compose（Swarm Stack）

yaml
version: '3.5'
services:
  powerdns_recursor:
    image: oakmoss/powerdns-recursor
    networks: [default]
    environment:
      - DNS_AUTH_ZONES=myprivatedomain.co.uk,private2.com
      - DNS_AUTH_SERVICE=pdns_auth
      - DNS_FORWARDER_IP_ADDRESSES=10.30.100.3
    deploy: {mode: replicated, replicas:1}

  powerdns_auth:
    image: psitrax/powerdns:4
    networks: [default]
    environment:
      - MYSQL_USER=root
      - MYSQL_PASS=password
      - MYSQL_HOST=10.10.10.10
      - MYSQL_DB=pdns
    deploy: {mode: replicated, replicas:1}

# MySQL配置省略