PowerDNS Docker镜像

本仓库包含以下Docker镜像：pdns-mysql、pdns-pgsql、pdns-recursor和pdns-admin。pdns-mysql镜像包含可完全配置的PowerDNS 4.x权威服务器（带MySQL后端，不含MySQL服务器）。pdns-pgsql镜像包含可完全配置的PowerDNS 4.x权威服务器（带PostgreSQL后端，不含PostgreSQL服务器）。pdns-recursor镜像包含可完全配置的PowerDNS 4.x递归器。pdns-admin镜像包含PowerDNS Admin web应用的前端（Caddy）和后端（uWSGI），该应用基于Flask开发，用于管理PowerDNS服务器。

pdns-mysql、pdns-pgsql和pdns-recursor镜像还提供alpine标签（感谢@PoppyPop）。

所有镜像均在Docker Hub可用：

• [***]
• [***]
• [***]
• [***]

源代码GitHub仓库：[***]

---

pdns-mysql

!Docker Image Size (tag) !Docker Image Size (tag) !Docker Pulls

[***]

概述

包含PowerDNS 4.x权威服务器及MySQL后端（需外部MySQL服务器）。支持通过环境变量配置数据库连接及PowerDNS服务，自动初始化缺失的数据库表。

配置说明

数据库连接配置

通过以下环境变量配置MySQL连接（默认值如下）：

PDNS_gmysql_host=mysql
PDNS_gmysql_port=3306
PDNS_gmysql_user=root
PDNS_gmysql_password=powerdns
PDNS_gmysql_dbname=powerdns

若与***mariadb镜像以别名mysql链接，上述变量可自动配置，无需手动指定。

PowerDNS服务配置

PowerDNS通过环境变量配置：所有以PDNS_为前缀的变量会被处理并写入/etc/pdns/pdns.conf，规则为：去除PDNS_前缀，将_替换为-。例如，PDNS_gmysql_host=mysql会转换为gmysql-host=mysql。

超级主服务器配置

支持SUPERMASTER_IPS环境变量，用于配置从DNS服务器的超级主服务器（文档），支持空格分隔的多个IP地址。

所有可用设置

详见PowerDNS权威服务器设置文档。

使用示例

启用API的主服务器（含从服务器配置）

docker run -d -p 53:53 -p 53:53/udp --name pdns-master \
  --hostname ns1.example.com --link mariadb:mysql \
  -e PDNS_master=yes \
  -e PDNS_api=yes \
  -e PDNS_api_key=secret \
  -e PDNS_webserver=yes \
  -e PDNS_webserver_address=0.0.0.0 \
  -e PDNS_webserver_password=secret2 \
  -e PDNS_version_string=anonymous \
  -e PDNS_default_ttl=1500 \
  -e PDNS_allow_axfr_ips=172.5.0.21 \
  -e PDNS_only_notify=172.5.0.21 \
  pschiffe/pdns-mysql

带超级主服务器的从服务器

docker run -d -p 53:53 -p 53:53/udp --name pdns-slave \
  --hostname ns2.example.com --link mariadb:mysql \
  -e PDNS_gmysql_dbname=powerdnsslave \
  -e PDNS_slave=yes \
  -e PDNS_version_string=anonymous \
  -e PDNS_disable_axfr=yes \
  -e PDNS_allow_notify_from=172.5.0.20 \
  -e SUPERMASTER_IPS=172.5.0.20 \
  pschiffe/pdns-mysql

pdns-pgsql

!Docker Image Size (tag) !Docker Image Size (tag) !Docker Pulls

[***]

概述

包含PowerDNS 4.x权威服务器及PostgreSQL后端（需外部PostgreSQL服务器）。支持通过环境变量配置数据库连接及PowerDNS服务，自动初始化缺失的数据库表。

配置说明

数据库连接配置

通过以下环境变量配置PostgreSQL连接（默认值如下）：

PDNS_gpgsql_host=pgsql
PDNS_gpgsql_port=5432
PDNS_gpgsql_user=postgres
PDNS_gpgsql_password=powerdns
PDNS_gpgsql_dbname=powerdns

若与***postgres镜像以别名pgsql链接，上述变量可自动配置，无需手动指定。

PowerDNS服务配置

与pdns-mysql相同，通过PDNS_前缀环境变量配置，变量转换规则一致。

超级主服务器配置

支持SUPERMASTER_IPS环境变量，用法同pdns-mysql。

所有可用设置

详见PowerDNS权威服务器设置文档。

使用示例

启用API的主服务器（含从服务器配置）

docker run -d -p 53:53 -p 53:53/udp --name pdns-master \
  --hostname ns1.example.com --link postgres:pgsql \
  -e PDNS_master=yes \
  -e PDNS_api=yes \
  -e PDNS_api_key=secret \
  -e PDNS_webserver=yes \
  -e PDNS_webserver_address=0.0.0.0 \
  -e PDNS_webserver_password=secret2 \
  -e PDNS_version_string=anonymous \
  -e PDNS_default_ttl=1500 \
  -e PDNS_allow_axfr_ips=172.5.0.21 \
  -e PDNS_only_notify=172.5.0.21 \
  pschiffe/pdns-pgsql

带超级主服务器的从服务器

docker run -d -p 53:53 -p 53:53/udp --name pdns-slave \
  --hostname ns2.example.com --link postgres:pgsql \
  -e PDNS_gpgsql_dbname=powerdnsslave \
  -e PDNS_slave=yes \
  -e PDNS_version_string=anonymous \
  -e PDNS_disable_axfr=yes \
  -e PDNS_allow_notify_from=172.5.0.20 \
  -e SUPERMASTER_IPS=172.5.0.20 \
  pschiffe/pdns-pgsql

pdns-recursor

!Docker Image Size (tag) !Docker Image Size (tag) !Docker Pulls

[***]

概述

包含可完全配置的PowerDNS 4.x递归器，支持通过环境变量自定义配置。

配置说明

通过PDNS_前缀环境变量配置，变量会被写入/etc/pdns/recursor.conf，转换规则为：去除PDNS_前缀，_替换为-。例如，PDNS_api_key=secret会转换为api-key=secret。

所有可用设置详见PowerDNS递归器设置文档。

使用示例

启用API的递归器

docker run -d -p 53:53 -p 53:53/udp --name pdns-recursor \
  -e PDNS_api_key=secret \
  -e PDNS_webserver=yes \
  -e PDNS_webserver_address=0.0.0.0 \
  -e PDNS_webserver_password=secret2 \
  pschiffe/pdns-recursor

pdns-admin

!Docker Image Size (tag) !Docker Pulls

[***]

概述

包含PowerDNS Admin web应用（基于Flask开发），用于管理PowerDNS服务器。需外部MySQL或PostgreSQL服务器，包含Caddy前端（处理静态文件及HTTPS）和uWSGI后端。

配置说明

数据库连接配置

MySQL配置

PDNS_ADMIN_SQLA_DB_HOST=mysql
PDNS_ADMIN_SQLA_DB_PORT=3306
PDNS_ADMIN_SQLA_DB_USER=root
PDNS_ADMIN_SQLA_DB_PASSWORD=powerdnsadmin
PDNS_ADMIN_SQLA_DB_NAME=powerdnsadmin

与***mariadb镜像以别名mysql链接时，自动配置连接。

PostgreSQL配置

PDNS_ADMIN_SQLA_DB_TYPE=postgres
PDNS_ADMIN_SQLA_DB_HOST=pgsql
PDNS_ADMIN_SQLA_DB_PORT=5432
PDNS_ADMIN_SQLA_DB_USER=postgres
PDNS_ADMIN_SQLA_DB_PASSWORD=powerdnsadmin
PDNS_ADMIN_SQLA_DB_NAME=powerdnsadmin

数据库表缺失时会自动初始化。

应用配置

通过PDNS_ADMIN_前缀环境变量配置，变量会写入/opt/powerdns-admin/powerdnsadmin/default_config.py。

连接PowerDNS服务器

需PowerDNS服务器启用API（示例配置）：

api=yes
api-key=secret
webserver=yes
webserver-address=0.0.0.0
webserver-allow-from=172.5.0.0/16

通过以下环境变量配置连接：

PDNS_API_URL="[***]"
PDNS_API_KEY=""
PDNS_VERSION=""

与本仓库的pdns-mysql镜像以别名pdns链接时，自动配置连接，无需手动指定上述变量。

API密钥与SALT

需通过PDNS_ADMIN_SALT环境变量指定SALT（用于生成API密钥），可通过以下命令生成：

python3 -c 'import bcrypt; print(bcrypt.gensalt().decode("utf-8"));'

示例值：$2b$12$xxxxxxxxxxxxxxxxxxxxxx（使用docker-compose时，$需转义为$$）。

Let's Encrypt SSL配置

包含的Caddy服务器支持通过Let's Encrypt自动配置HTTPS：

• SSL_MAIN_DOMAIN：HTTPS主域名
• SSL_EXTRA_DOMAINS：逗号分隔的额外域名（重定向至主域名）
• 需暴露端口：8080→80，8443→443（含UDP，用于HTTP/3）
• 持久化目录：/var/lib/caddy（存储证书）

持久化数据

用户上传目录需持久化：/opt/powerdns-admin/upload

使用示例

链接pdns-mysql和数据库

docker run -d -p 8080:8080 --name pdns-admin \
  --link mariadb:mysql --link pdns-master:pdns \
  -v pdns-admin-upload:/opt/powerdns-admin/upload \
  pschiffe/pdns-admin

启用HTTPS

docker run -d -p 80:8080 -p 443:8443 -p 443:8443/udp --name pdns-admin \
  --link mariadb:mysql --link pdns-master:pdns \
  -v pdns-admin-caddy:/var/lib/caddy \
  -v pdns-admin-upload:/opt/powerdns-admin/upload \
  -e SSL_MAIN_DOMAIN=[***] \
  -e SSL_EXTRA_DOMAINS=pdns-admin.com,pdns-admin.eu \
  pschiffe/pdns-admin

Docker Compose

提供示例docker-compose文件，可通过以下命令启动：

docker-compose -f docker-compose-mysql.yml up -d

Ansible Playbook

提供Ansible playbook用于构建和运行容器：

ansible-playbook ansible-playbook-mysql.yml