lostlink/pdns

PowerDNS Auth with local Recursor Docker镜像文档

镜像概述

本镜像集成了PowerDNS Authoritative Server（权威服务器）和PowerDNS Recursor（递归解析器），提供DNS权威解析与递归查询一体化解决方案。无需单独部署递归服务器，可在单个容器内同时处理域名权威数据管理（如区域文件解析）和外部域名递归查询（如互联网域名解析），简化DNS服务架构。

核心功能与特性

权威服务器功能

• 支持多后端存储（SQLite、MySQL、PostgreSQL等），灵活管理DNS区域数据
• 支持动态DNS更新（DDNS），允许通过API或协议实时修改记录
• 兼容DNSSEC，可配置域名签名与验证
• 提供Web管理接口（可选集成PowerDNS-Admin）

递归解析器功能

• 本地缓存机制，减少重复查询，提升解析效率
• 支持DNSSEC验证，增强域名解析安全性
• 可配置访问控制（允许/拒绝特定IP段的递归请求）
• 低资源占用，优化查询性能

部署特性

• 一体化部署：单个容器集成两种服务，减少组件间通信开销
• 轻量级基础镜像：基于Alpine Linux，镜像体积小，启动速度快
• 灵活配置：支持通过环境变量或挂载配置文件自定义服务参数
• 数据持久化：权威区域数据、递归缓存可通过卷挂载实现宿主机持久化

使用场景

• 开发测试环境：本地模拟DNS服务，快速验证域名解析逻辑
• 小型网络环境：家庭、办公室等小型网络的DNS服务器，同时处理内部域名（权威解析）和外部域名（递归查询）
• 边缘计算节点：需本地化DNS解析能力的边缘设备，减少对外部DNS依赖
• 教学演示：DNS服务原理教学，直观展示权威解析与递归查询流程

使用方法

快速启动

基础运行命令

bash
docker run -d \
  --name pdns-auth-recursor \
  -p 53:53/udp -p 53:53/tcp \
  -e PDNS_AUTH_ZONES="example.com=./zones/example.com.zone" \
  -e PDNS_RECURSOR_ALLOW_FROM="0.0.0.0/0" \
  -v /host/pdns/zones:/etc/powerdns/zones \
  powerdns-auth-recursor:latest

参数说明

• -p 53:53/udp -p 53:53/tcp：映射DNS服务默认端口（UDP用于查询，TCP用于区域传输）
• -e PDNS_AUTH_ZONES：指定权威区域（格式：域名=区域文件路径，多个区域用逗号分隔）
• -e PDNS_RECURSOR_ALLOW_FROM：允许递归查询的IP段（默认限制本地网络，示例开放所有IP）
• -v /host/pdns/zones:/etc/powerdns/zones：挂载宿主机区域文件目录到容器，持久化权威数据

docker-compose配置示例

yaml
version: '3'
services:
  pdns:
    image: powerdns-auth-recursor:latest
    container_name: pdns
    ports:
      - "53:53/udp"
      - "53:53/tcp"
    environment:
      - PDNS_AUTH_BACKEND=sqlite3
      - PDNS_AUTH_DB_PATH=/etc/powerdns/db/pdns.sqlite3
      - PDNS_AUTH_ZONES=example.com=./zones/example.com.zone,test.com=./zones/test.com.zone
      - PDNS_RECURSOR_DNSSEC=yes
      - PDNS_RECURSOR_CACHE_SIZE=10000
    volumes:
      - ./pdns/zones:/etc/powerdns/zones
      - ./pdns/db:/etc/powerdns/db
    restart: unless-stopped

配置参数说明

权威服务器环境变量

递归解析器环境变量

配置文件自定义

如需更复杂配置，可挂载自定义配置文件到容器：

• 权威服务器配置：-v /host/pdns.conf:/etc/powerdns/pdns.conf
• 递归解析器配置：-v /host/recursor.conf:/etc/powerdns/recursor.conf

数据持久化

为避免容器重启后数据丢失，建议挂载以下目录：

• 权威区域文件目录：/etc/powerdns/zones（存储.zone文件）
• 数据库目录（如SQLite）：/etc/powerdns/db（存储后端数据）
• 递归器缓存目录：/var/cache/powerdns-recursor（可选，提升缓存持久性）

验证服务可用性

权威解析验证（本地区域）：

bash
dig @localhost example.com A

递归解析验证（外部域名）：

bash
dig @localhost google.com A