pschiffe/pdns-admin
pschiffe
用于管理PowerDNS服务器的PowerDNS Admin Web应用程序，包含前端（Caddy）和后端（uWSGI），支持通过环境变量配置，需外部MySQL或PostgreSQL数据库。
下载次数: 0状态：社区镜像维护者：pschiffe仓库类型：镜像最近更新：16 天前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这段话即可：
请先阅读并遵守：https://xuanyuan.cloud/agents.md
未读文档前不要生成 pull 命令或排错方案。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
PowerDNS Docker镜像
本仓库包含以下Docker镜像：pdns-mysql、pdns-pgsql、pdns-recursor和pdns-admin。pdns-mysql镜像包含可完全配置的https://doc.powerdns.com/authoritative/，带有MySQL后端（不含MySQL服务器）。**pdns-pgsql**镜像包含可完全配置的https://doc.powerdns.com/authoritative/，带有PostgreSQL后端（不含PostgreSQL服务器）。**pdns-recursor**镜像包含可完全配置的https://doc.powerdns.com/recursor/。**pdns-admin**镜像包含https://github.com/PowerDNS-Admin/PowerDNS-Admin Web应用的前端（Caddy）和后端（uWSGI），该应用基于Flask编写，用于管理PowerDNS服务器。
pdns-mysql、pdns-pgsql和pdns-recursor镜像还提供alpine标签（感谢@PoppyPop）。
所有镜像均可在Docker Hub获取：
- https://hub.docker.com/r/pschiffe/pdns-mysql/
- https://hub.docker.com/r/pschiffe/pdns-pgsql/
- https://hub.docker.com/r/pschiffe/pdns-recursor/
- https://hub.docker.com/r/pschiffe/pdns-admin/
源码GitHub仓库：https://github.com/pschiffe/docker-pdns
pdns-mysql
https://hub.docker.com/r/pschiffe/pdns-mysql/
带有MySQL后端的PowerDNS 4.x服务器Docker镜像，需外部MySQL服务器。MySQL配置环境变量：
（名称=默认值） PDNS_gmysql_host=mysql PDNS_gmysql_port=3306 PDNS_gmysql_user=root PDNS_gmysql_password=powerdns PDNS_gmysql_dbname=powerdns
若使用别名mysql链接官方https://hub.docker.com/_/mariadb/镜像，可自动配置连接，无需指定上述任何变量。若数据库表缺失，将自动初始化数据库。
PowerDNS服务器可通过环境变量配置。所有以PDNS_开头的变量将按以下方式插入/etc/pdns/pdns.conf配置文件：去除前缀PDNS_，并将所有_替换为-。例如，上述MySQL配置中的PDNS_gmysql_host=mysql将在/etc/pdns/pdns.conf中变为gmysql-host=mysql。通过这种方式，可在docker run命令中按需配置PowerDNS服务器。
同时支持SUPERMASTER_IPS环境变量，用于配置从DNS服务器的超级主服务器。https://doc.powerdns.com/authoritative/modes-of-operation.html#autoprimary-automatic-provisioning-of-secondaries。支持空格分隔的多个IP地址。
所有可用设置可参考https://doc.powerdns.com/authoritative/settings.html。
示例
启用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 \ docker.xuanyuan.run/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 \ docker.xuanyuan.run/pschiffe/pdns-mysql
pdns-pgsql
https://hub.docker.com/r/pschiffe/pdns-pgsql/
带有PostgreSQL后端的PowerDNS 4.x服务器Docker镜像，需外部PostgreSQL服务器。PostgreSQL配置环境变量：
（名称=默认值） PDNS_gpgsql_host=pgsql PDNS_gpgsql_port=5432 PDNS_gpgsql_user=postgres PDNS_gpgsql_password=powerdns PDNS_gpgsql_dbname=powerdns
若使用别名pgsql链接官方https://hub.docker.com/_/postgres镜像，可自动配置连接，无需指定上述任何变量。若数据库表缺失，将自动初始化数据库。
PowerDNS服务器可通过环境变量配置。所有以PDNS_开头的变量将按以下方式插入/etc/pdns/pdns.conf配置文件：去除前缀PDNS_，并将所有_替换为-。例如，上述PostgreSQL配置中的PDNS_gpgsql_host=pgsql将在/etc/pdns/pdns.conf中变为gpgsql-host=pgsql。通过这种方式，可在docker run命令中按需配置PowerDNS服务器。
同时支持SUPERMASTER_IPS环境变量，用于配置从DNS服务器的超级主服务器。https://doc.powerdns.com/authoritative/modes-of-operation.html#autoprimary-automatic-provisioning-of-secondaries。支持空格分隔的多个IP地址。
所有可用设置可参考https://doc.powerdns.com/authoritative/settings.html。
示例
启用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 \ docker.xuanyuan.run/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 \ docker.xuanyuan.run/pschiffe/pdns-pgsql
pdns-recursor
https://hub.docker.com/r/pschiffe/pdns-recursor/
带有https://doc.powerdns.com/recursor/的Docker镜像。
PowerDNS递归器可通过环境变量配置。所有以PDNS_开头的变量将按以下方式插入/etc/pdns/recursor.conf配置文件：去除前缀PDNS_，并将所有_替换为-。例如，PDNS_gmysql_host=mysql将在/etc/pdns/recursor.conf中变为gmysql-host=mysql。通过这种方式，可在docker run命令中按需配置PowerDNS递归器。
所有可用设置可参考https://doc.powerdns.com/recursor/settings.html。
示例
启用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 \ docker.xuanyuan.run/pschiffe/pdns-recursor
pdns-admin
https://hub.docker.com/r/pschiffe/pdns-admin/
带有https://github.com/PowerDNS-Admin/PowerDNS-Admin Web应用的Docker镜像，该应用基于Flask编写，用于管理PowerDNS服务器。需外部MySQL或PostgreSQL服务器。
Docker Hub上还有官方的pdns-admin镜像https://hub.docker.com/r/powerdnsadmin/pda-legacy，该镜像仅包含处理静态文件和Python应用的gunicorn进程。本仓库的镜像包含处理Python应用请求的uWSGI服务器和处理静态文件及可选Let's Encrypt HTTPS的Caddy Web服务器。
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
若使用别名mysql链接官方https://hub.docker.com/_/mariadb/镜像，可自动配置连接，无需指定上述任何变量。
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-mysql类似，pdns-admin也可通过环境变量完全配置。此处前缀为PDNS_ADMIN_，配置将写入/opt/powerdns-admin/powerdnsadmin/default_config.py文件。
连接PowerDNS服务器
pdns-admin需管理PowerDNS服务器才能发挥作用。PowerDNS服务器需暴露API（PowerDNS 4.x示例配置）：
api=yes api-key=secret webserver=yes webserver-address=0.0.0.0 webserver-allow-from=172.5.0.0/16
PowerDNS连接通过环境变量配置（需PowerDNS服务器URL、API密钥和服务器版本，例如4.0）：
（名称=默认值） PDNS_API_URL="http://pdns:8081/" PDNS_API_KEY="" PDNS_VERSION=""
若此容器使用别名pdns链接本仓库的pdns-mysql镜像，将自动配置，无需指定上述任何环境变量。
PowerDNS Admin API密钥和SALT
为生成API密钥，需通过PDNS_ADMIN_SALT环境变量指定SALT。这是一个机密值，可通过以下命令生成：
python3 -c 'import bcrypt; print(bcrypt.gensalt().decode("utf-8"));'
示例值类似$2b$12$xxxxxxxxxxxxxxxxxxxxxx——注意使用docker-compose时，文字`# PowerDNS Docker镜像
本仓库包含以下Docker镜像：pdns-mysql、pdns-pgsql、pdns-recursor和pdns-admin。pdns-mysql镜像包含可完全配置的https://doc.powerdns.com/authoritative/，带有MySQL后端（不含MySQL服务器）。**pdns-pgsql**镜像包含可完全配置的https://doc.powerdns.com/authoritative/，带有PostgreSQL后端（不含PostgreSQL服务器）。**pdns-recursor**镜像包含可完全配置的https://doc.powerdns.com/recursor/。**pdns-admin**镜像包含https://github.com/PowerDNS-Admin/PowerDNS-Admin Web应用的前端（Caddy）和后端（uWSGI），该应用基于Flask编写，用于管理PowerDNS服务器。
pdns-mysql、pdns-pgsql和pdns-recursor镜像还提供alpine标签（感谢@PoppyPop）。
所有镜像均可在Docker Hub获取：
- https://hub.docker.com/r/pschiffe/pdns-mysql/
- https://hub.docker.com/r/pschiffe/pdns-pgsql/
- https://hub.docker.com/r/pschiffe/pdns-recursor/
- https://hub.docker.com/r/pschiffe/pdns-admin/
源码GitHub仓库：https://github.com/pschiffe/docker-pdns
pdns-mysql
https://hub.docker.com/r/pschiffe/pdns-mysql/
带有MySQL后端的PowerDNS 4.x服务器Docker镜像，需外部MySQL服务器。MySQL配置环境变量：
（名称=默认值） PDNS_gmysql_host=mysql PDNS_gmysql_port=3306 PDNS_gmysql_user=root PDNS_gmysql_password=powerdns PDNS_gmysql_dbname=powerdns
若使用别名mysql链接官方https://hub.docker.com/_/mariadb/镜像，可自动配置连接，无需指定上述任何变量。若数据库表缺失，将自动初始化数据库。
PowerDNS服务器可通过环境变量配置。所有以PDNS_开头的变量将按以下方式插入/etc/pdns/pdns.conf配置文件：去除前缀PDNS_，并将所有_替换为-。例如，上述MySQL配置中的PDNS_gmysql_host=mysql将在/etc/pdns/pdns.conf中变为gmysql-host=mysql。通过这种方式，可在docker run命令中按需配置PowerDNS服务器。
同时支持SUPERMASTER_IPS环境变量，用于配置从DNS服务器的超级主服务器。https://doc.powerdns.com/authoritative/modes-of-operation.html#autoprimary-automatic-provisioning-of-secondaries。支持空格分隔的多个IP地址。
所有可用设置可参考https://doc.powerdns.com/authoritative/settings.html。
示例
启用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 \ docker.xuanyuan.run/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 \ docker.xuanyuan.run/pschiffe/pdns-mysql
pdns-pgsql
https://hub.docker.com/r/pschiffe/pdns-pgsql/
带有PostgreSQL后端的PowerDNS 4.x服务器Docker镜像，需外部PostgreSQL服务器。PostgreSQL配置环境变量：
（名称=默认值） PDNS_gpgsql_host=pgsql PDNS_gpgsql_port=5432 PDNS_gpgsql_user=postgres PDNS_gpgsql_password=powerdns PDNS_gpgsql_dbname=powerdns
若使用别名pgsql链接官方https://hub.docker.com/_/postgres镜像，可自动配置连接，无需指定上述任何变量。若数据库表缺失，将自动初始化数据库。
PowerDNS服务器可通过环境变量配置。所有以PDNS_开头的变量将按以下方式插入/etc/pdns/pdns.conf配置文件：去除前缀PDNS_，并将所有_替换为-。例如，上述PostgreSQL配置中的PDNS_gpgsql_host=pgsql将在/etc/pdns/pdns.conf中变为gpgsql-host=pgsql。通过这种方式，可在docker run命令中按需配置PowerDNS服务器。
同时支持SUPERMASTER_IPS环境变量，用于配置从DNS服务器的超级主服务器。https://doc.powerdns.com/authoritative/modes-of-operation.html#autoprimary-automatic-provisioning-of-secondaries。支持空格分隔的多个IP地址。
所有可用设置可参考https://doc.powerdns.com/authoritative/settings.html。
示例
启用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 \ docker.xuanyuan.run/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 \ docker.xuanyuan.run/pschiffe/pdns-pgsql
pdns-recursor
https://hub.docker.com/r/pschiffe/pdns-recursor/
带有https://doc.powerdns.com/recursor/的Docker镜像。
PowerDNS递归器可通过环境变量配置。所有以PDNS_开头的变量将按以下方式插入/etc/pdns/recursor.conf配置文件：去除前缀PDNS_，并将所有_替换为-。例如，PDNS_gmysql_host=mysql将在/etc/pdns/recursor.conf中变为gmysql-host=mysql。通过这种方式，可在docker run命令中按需配置PowerDNS递归器。
所有可用设置可参考https://doc.powerdns.com/recursor/settings.html。
示例
启用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 \ docker.xuanyuan.run/pschiffe/pdns-recursor
pdns-admin
https://hub.docker.com/r/pschiffe/pdns-admin/
带有https://github.com/PowerDNS-Admin/PowerDNS-Admin Web应用的Docker镜像，该应用基于Flask编写，用于管理PowerDNS服务器。需外部MySQL或PostgreSQL服务器。
Docker Hub上还有官方的pdns-admin镜像https://hub.docker.com/r/powerdnsadmin/pda-legacy，该镜像仅包含处理静态文件和Python应用的gunicorn进程。本仓库的镜像包含处理Python应用请求的uWSGI服务器和处理静态文件及可选Let's Encrypt HTTPS的Caddy Web服务器。
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
若使用别名mysql链接官方https://hub.docker.com/_/mariadb/镜像，可自动配置连接，无需指定上述任何变量。
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-mysql类似，pdns-admin也可通过环境变量完全配置。此处前缀为PDNS_ADMIN_，配置将写入/opt/powerdns-admin/powerdnsadmin/default_config.py文件。
连接PowerDNS服务器
pdns-admin需管理PowerDNS服务器才能发挥作用。PowerDNS服务器需暴露API（PowerDNS 4.x示例配置）：
api=yes api-key=secret webserver=yes webserver-address=0.0.0.0 webserver-allow-from=172.5.0.0/16
PowerDNS连接通过环境变量配置（需PowerDNS服务器URL、API密钥和服务器版本，例如4.0）：
（名称=默认值） PDNS_API_URL="http://pdns:8081/" PDNS_API_KEY="" PDNS_VERSION=""
若此容器使用别名pdns链接本仓库的pdns-mysql镜像，将自动配置，无需指定上述任何环境变量。
PowerDNS Admin API密钥和SALT
为生成API密钥，需通过PDNS_ADMIN_SALT环境变量指定SALT。这是一个机密值，可通过以下命令生成：
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环境变量可包含逗号分隔的域名列表，这些域名将重定向到SSL_MAIN_DOMAIN。需正确配置公共DNS，并将pdns-admin的端口8080、8443和8443/udp映射为80、443和443/udp（443/udp用于HTTP/3流量）。
最后，需持久化pdns-admin容器内的/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 \ docker.xuanyuan.run/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=www.pdns-admin.com \ -e SSL_EXTRA_DOMAINS=pdns-admin.com,pdns-admin.eu \ docker.xuanyuan.run/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
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 pdns-admin 镜像标签
docker pull docker.xuanyuan.run/pschiffe/pdns-admin:<标签>
DockerHub 原生拉取命令
docker pull pschiffe/pdns-admin:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"
