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仓库：[***]

![Static Badge]([] ![Static Badge]([]

如果本项目对您有用，请考虑赞助以支持维护和进一步开发。感谢！

pdns-mysql

!Docker镜像大小（latest标签） !Docker镜像大小（alpine标签） !Docker拉取次数

[***]

带有PowerDNS 4.x权威服务器和MySQL后端的Docker镜像，需外部MySQL服务器。MySQL配置环境变量：

（名称=默认值）
PDNS_gmysql_host=mysql
PDNS_gmysql_port=3306
PDNS_gmysql_user=root
PDNS_gmysql_password=powerdns
PDNS_gmysql_dbname=powerdns

若与官方mariadb镜像以别名mysql链接，可自动配置连接（无需指定上述变量）。数据库表缺失时会自动初始化。

PowerDNS服务器通过环境变量配置：以PDNS_为前缀的变量会去除前缀并将_替换为-后写入/etc/pdns/pdns.conf。例如PDNS_gmysql_host=mysql会变为gmysql-host=mysql。支持SUPERMASTER_IPS变量配置超级主服务器（多IP用空格分隔），详情见文档。所有配置项见官方文档。

部署示例

主服务器（启用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镜像大小（latest标签） !Docker镜像大小（alpine标签） !Docker拉取次数

[***]

带有PowerDNS 4.x权威服务器和PostgreSQL后端的Docker镜像，需外部PostgreSQL服务器。PostgreSQL配置环境变量：

（名称=默认值）
PDNS_gpgsql_host=pgsql
PDNS_gpgsql_port=5432
PDNS_gpgsql_user=postgres
PDNS_gpgsql_password=powerdns
PDNS_gpgsql_dbname=powerdns

若与官方postgres镜像以别名pgsql链接，可自动配置连接。数据库表缺失时自动初始化。配置方式与pdns-mysql相同（通过PDNS_前缀变量），支持SUPERMASTER_IPS变量。所有配置项见官方文档。

部署示例

主服务器（启用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镜像大小（latest标签） !Docker镜像大小（alpine标签） !Docker拉取次数

[***]

带有PowerDNS 4.x递归服务器的Docker镜像。通过环境变量配置：以PDNS_为前缀的变量去除前缀并将_替换为-后写入/etc/pdns/recursor.conf。所有配置项见官方文档。

部署示例

启用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镜像大小（latest标签） !Docker拉取次数

[***]

包含PowerDNS Admin Web应用的Docker镜像，用于管理PowerDNS服务器，需外部MySQL或PostgreSQL服务器。该镜像包含uWSGI（处理Python应用请求）和Caddy（处理静态文件及可选HTTPS），区别于仅含gunicorn的官方镜像。

数据库配置

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

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

与对应数据库镜像链接（别名mysql/pgsql）可自动配置，表缺失时自动初始化。

PowerDNS服务器连接

需配置PowerDNS服务器API（示例配置：api=yes、api-key=secret、webserver=yes、webserver-address=0.0.0.0）。通过环境变量连接：

（名称=默认值）
PDNS_API_URL="[***]"
PDNS_API_KEY=""
PDNS_VERSION=""

与本仓库的pdns-mysql/pdns-pgsql镜像以别名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（主域名）和SSL_EXTRA_DOMAINS（逗号分隔的重定向域名），暴露端口8080->80、8443->443、8443/udp->443/udp，并持久化/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部署

使用内置Ansible剧本构建运行容器：

ansible-playbook ansible-playbook-mysql.yml