hybridadmin/pdns-auth

PowerDNS权威服务器Docker镜像

https://github.com/hybridadmin/docker-pdns-auth/actions/workflows/build.yml/badge.svg](https://github.com/hybridadmin/docker-pdns-auth/actions/workflows/build.yml) !https://img.shields.io/docker/pulls/hybridadmin/pdns-auth

支持的标签及对应Dockerfile链接

• https://github.com/hybridadmin/docker-pdns-auth/tree/main/5.0/Dockerfile
• https://github.com/hybridadmin/docker-pdns-auth/tree/main/4.9/Dockerfile
• https://github.com/hybridadmin/docker-pdns-auth/tree/main/4.8/Dockerfile

镜像概述

PowerDNS权威域名服务器是一款多功能的域名解析服务器，支持多种后端（包括纯区域文件和动态类型）。本Docker镜像提供了便捷的部署方式，包含多个版本，支持通过环境变量灵活配置服务参数，适用于各类DNS解析场景。

核心功能

1. 支持多种后端（如LMDB），满足不同存储需求；
2. 提供Web监控界面，可实时查看服务状态；
3. 内置HTTP API，支持程序化管理DNS服务；
4. 支持AXFR区域传输、DNS查询日志等核心DNS功能；
5. 多线程处理机制，提升服务性能；
6. 通过环境变量快速配置服务参数，无需手动修改配置文件。

使用场景

1. 企业内部DNS服务部署，满足内部域名解析需求；
2. 域名托管服务商搭建公共DNS解析服务；
3. 测试环境中快速搭建DNS服务，验证域名解析逻辑；
4. 需要自定义DNS配置的场景（如特殊记录类型、访问控制等）。

配置说明

Docker Compose部署示例

yaml
---
version: "3"
services:
  pdns-auth:
    image: hybridadmin/pdns-auth:latest
    container_name: pdns-auth-server
    hostname: pdns-auth-server # 可选
    environment:
      - ALLOW_AXFR_IPS=127.0.0.0/8,::1 # 可选：允许AXFR的IP范围
      - ALLOW_NOTIFY_FROM_IPS=0.0.0.0/0 # 可选：允许通知的IP范围
      - ALLOW_WEB_ACCESS=yes # 可选：启用Web监控
      - WEBSERVER_PASSWORD=changemepass # 可选：Web监控密码
      - ALLOW_API_ACCESS=yes # 可选：启用API访问
      - API_KEY=dfdfdfdf # 可选：API密钥
      - DISABLE_AXFR=yes # 可选：禁用AXFR
      - DISABLE_SYSLOG=yes # 可选：禁用syslog日志
      - DNAME_PROCESSING=no # 可选：是否处理DNAME记录
      - EXPAND_ALIAS=no # 可选：是否展开ALIAS记录
      - USE_GUARDIAN=no # 可选：是否使用守护进程
      - LOG_DNS_DETAILS=no # 可选：是否记录DNS详细信息
      - LOG_DNS_QUERIES=no # 可选：是否记录DNS查询
      - MAX_TCP_CONNECTION_DURATION=0 # 可选：TCP连接最大时长
      - MAX_TCP_CONNECTIONS=20 # 可选：最大TCP连接数
      - QUERY_LOGGING=no # 可选：是否记录查询日志
      - RECEIVER_THREADS=2 # 可选：接收线程数
      - RETRIEVAL_THREADS=2 # 可选：检索线程数
      - SIGNING_THREADS=2 # 可选：签名线程数
    ports:
      - 53:53/tcp # DNS TCP端口
      - 53:53/udp # DNS UDP端口
      - 8081:8081/tcp # Web监控端口
    restart: always

Docker CLI部署示例

默认配置启动

console
docker run --name pdns-auth -d -p 53:53/udp -p 53:53/tcp -p 8081:8081/tcp --restart=always hybridadmin/pdns-auth:latest

自定义配置启动

console
docker run -d --name pdns-auth \
-e ALLOW_AXFR_IPS=127.0.0.0/8,::1 `# 允许AXFR的IP范围` \
-e ALLOW_NOTIFY_FROM_IPS=0.0.0.0/0 `# 允许通知的IP范围` \
-e ALLOW_WEB_ACCESS=yes `# 启用Web监控` \
-e WEBSERVER_PASSWORD=changemepass `# Web监控密码` \
-e ALLOW_API_ACCESS=yes `# 启用API` \
-e API_KEY=dfdfdfdf `# API密钥` \
-e DISABLE_AXFR=yes `# 禁用AXFR` \
-e DISABLE_SYSLOG=yes `# 禁用syslog` \
-e DNAME_PROCESSING=no `# 不处理DNAME` \
-e EXPAND_ALIAS=no `# 不展开ALIAS` \
-e USE_GUARDIAN=no `# 不使用守护进程` \
-e LOG_DNS_DETAILS=no `# 不记录DNS详细信息` \
-e LOG_DNS_QUERIES=no `# 不记录DNS查询` \
-e MAX_TCP_CONNECTION_DURATION=0 `# TCP连接无超时` \
-e MAX_TCP_CONNECTIONS=20 `# 最大TCP连接数` \
-e QUERY_LOGGING=no `# 不记录查询日志` \
-e RECEIVER_THREADS=2 `# 接收线程数` \
-e RETRIEVAL_THREADS=2 `# 检索线程数` \
-e SIGNING_THREADS=2 `# 签名线程数` \
-p 53:53/udp -p 53:53/tcp -p 8081:8081/tcp --restart=always hybridadmin/pdns-auth:latest

添加DNS区域

console
docker exec --tty --user pdns [container_id] env TERM=xterm pdnsutil create-zone example.com
docker exec --tty --user pdns [container_id] env TERM=xterm pdnsutil add-record example.com @ NS ns1.example.com
docker exec --tty --user pdns [container_id] env TERM=xterm pdnsutil add-record example.com @ NS ns2.example.com

进入容器

console
docker exec -it [container_id] /bin/bash

环境变量说明

默认配置说明

容器内部通过docker-entrypoint.sh脚本自动配置/etc/powerdns/pdns.d/pdns.lmdb.conf，默认使用LMDB后端。如需添加更多配置，可参考官方文档（https://doc.powerdns.com/authoritative/settings.html%EF%BC%89%E3%80%82