
本仓库包含以下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镜像包含https://github.com/PowerDNS-Admin/PowerDNS-Admin web应用的前端(Caddy)和后端(uWSGI),该应用基于Flask开发,用于管理PowerDNS服务器。
pdns-mysql、pdns-pgsql和pdns-recursor镜像还提供alpine标签(感谢@PoppyPop)。
所有镜像均在Docker Hub可用:
源代码GitHub仓库:https://github.com/pschiffe/docker-pdns
!Docker Image Size (tag) !Docker Image Size (tag) !Docker Pulls
https://hub.docker.com/r/pschiffe/pdns-mysql/
包含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
若与官方https://hub.docker.com/_/mariadb/%E9%95%9C%E5%83%8F%E4%BB%A5%E5%88%AB%E5%90%8D%60mysql%60%E9%93%BE%E6%8E%A5%EF%BC%8C%E4%B8%8A%E8%BF%B0%E5%8F%98%E9%87%8F%E5%8F%AF%E8%87%AA%E5%8A%A8%E9%85%8D%E7%BD%AE%EF%BC%8C%E6%97%A0%E9%9C%80%E6%89%8B%E5%8A%A8%E6%8C%87%E5%AE%9A%E3%80%82
PowerDNS服务配置
PowerDNS通过环境变量配置:所有以PDNS_为前缀的变量会被处理并写入/etc/pdns/pdns.conf,规则为:去除PDNS_前缀,将_替换为-。例如,PDNS_gmysql_host=mysql会转换为gmysql-host=mysql。
超级主服务器配置
支持SUPERMASTER_IPS环境变量,用于配置从DNS服务器的超级主服务器(文档),支持空格分隔的多个IP地址。
所有可用设置
详见PowerDNS权威服务器设置文档。
启用API的主服务器(含从服务器配置)
bashdocker 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
带超级主服务器的从服务器
bashdocker 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
!Docker Image Size (tag) !Docker Image Size (tag) !Docker Pulls
https://hub.docker.com/r/pschiffe/pdns-pgsql/
包含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
若与官方https://hub.docker.com/_/postgres%E9%95%9C%E5%83%8F%E4%BB%A5%E5%88%AB%E5%90%8D%60pgsql%60%E9%93%BE%E6%8E%A5%EF%BC%8C%E4%B8%8A%E8%BF%B0%E5%8F%98%E9%87%8F%E5%8F%AF%E8%87%AA%E5%8A%A8%E9%85%8D%E7%BD%AE%EF%BC%8C%E6%97%A0%E9%9C%80%E6%89%8B%E5%8A%A8%E6%8C%87%E5%AE%9A%E3%80%82
PowerDNS服务配置
与pdns-mysql相同,通过PDNS_前缀环境变量配置,变量转换规则一致。
超级主服务器配置
支持SUPERMASTER_IPS环境变量,用法同pdns-mysql。
所有可用设置
详见PowerDNS权威服务器设置文档。
启用API的主服务器(含从服务器配置)
bashdocker 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
带超级主服务器的从服务器
bashdocker 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
!Docker Image Size (tag) !Docker Image Size (tag) !Docker Pulls
https://hub.docker.com/r/pschiffe/pdns-recursor/
包含可完全配置的PowerDNS 4.x递归器,支持通过环境变量自定义配置。
通过PDNS_前缀环境变量配置,变量会被写入/etc/pdns/recursor.conf,转换规则为:去除PDNS_前缀,_替换为-。例如,PDNS_api_key=secret会转换为api-key=secret。
所有可用设置详见PowerDNS递归器设置文档。
启用API的递归器
bashdocker 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
!Docker Image Size (tag) !Docker Pulls
https://hub.docker.com/r/pschiffe/pdns-admin/
包含https://github.com/PowerDNS-Admin/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
与官方https://hub.docker.com/_/mariadb/%E9%95%9C%E5%83%8F%E4%BB%A5%E5%88%AB%E5%90%8D%60mysql%60%E9%93%BE%E6%8E%A5%E6%97%B6%EF%BC%8C%E8%87%AA%E5%8A%A8%E9%85%8D%E7%BD%AE%E8%BF%9E%E6%8E%A5%E3%80%82
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="http://pdns:8081/" PDNS_API_KEY="" PDNS_VERSION=""
与本仓库的pdns-mysql镜像以别名pdns链接时,自动配置连接,无需手动指定上述变量。
API密钥与SALT
需通过PDNS_ADMIN_SALT环境变量指定SALT(用于生成API密钥),可通过以下命令生成:
bashpython3 -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镜像包含可完全配置的PowerDNS 4.x权威服务器(带MySQL后端,不含MySQL服务器)。pdns-pgsql镜像包含可完全配置的PowerDNS 4.x权威服务器(带PostgreSQL后端,不含PostgreSQL服务器)。pdns-recursor镜像包含可完全配置的PowerDNS 4.x递归器。pdns-admin镜像包含https://github.com/PowerDNS-Admin/PowerDNS-Admin web应用的前端(Caddy)和后端(uWSGI),该应用基于Flask开发,用于管理PowerDNS服务器。
pdns-mysql、pdns-pgsql和pdns-recursor镜像还提供alpine标签(感谢@PoppyPop)。
所有镜像均在Docker Hub可用:
源代码GitHub仓库:https://github.com/pschiffe/docker-pdns
!Docker Image Size (tag) !Docker Image Size (tag) !Docker Pulls
https://hub.docker.com/r/pschiffe/pdns-mysql/
包含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
若与官方https://hub.docker.com/_/mariadb/%E9%95%9C%E5%83%8F%E4%BB%A5%E5%88%AB%E5%90%8D%60mysql%60%E9%93%BE%E6%8E%A5%EF%BC%8C%E4%B8%8A%E8%BF%B0%E5%8F%98%E9%87%8F%E5%8F%AF%E8%87%AA%E5%8A%A8%E9%85%8D%E7%BD%AE%EF%BC%8C%E6%97%A0%E9%9C%80%E6%89%8B%E5%8A%A8%E6%8C%87%E5%AE%9A%E3%80%82
PowerDNS服务配置
PowerDNS通过环境变量配置:所有以PDNS_为前缀的变量会被处理并写入/etc/pdns/pdns.conf,规则为:去除PDNS_前缀,将_替换为-。例如,PDNS_gmysql_host=mysql会转换为gmysql-host=mysql。
超级主服务器配置
支持SUPERMASTER_IPS环境变量,用于配置从DNS服务器的超级主服务器(文档),支持空格分隔的多个IP地址。
所有可用设置
详见PowerDNS权威服务器设置文档。
启用API的主服务器(含从服务器配置)
bashdocker 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
带超级主服务器的从服务器
bashdocker 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
!Docker Image Size (tag) !Docker Image Size (tag) !Docker Pulls
https://hub.docker.com/r/pschiffe/pdns-pgsql/
包含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
若与官方https://hub.docker.com/_/postgres%E9%95%9C%E5%83%8F%E4%BB%A5%E5%88%AB%E5%90%8D%60pgsql%60%E9%93%BE%E6%8E%A5%EF%BC%8C%E4%B8%8A%E8%BF%B0%E5%8F%98%E9%87%8F%E5%8F%AF%E8%87%AA%E5%8A%A8%E9%85%8D%E7%BD%AE%EF%BC%8C%E6%97%A0%E9%9C%80%E6%89%8B%E5%8A%A8%E6%8C%87%E5%AE%9A%E3%80%82
PowerDNS服务配置
与pdns-mysql相同,通过PDNS_前缀环境变量配置,变量转换规则一致。
超级主服务器配置
支持SUPERMASTER_IPS环境变量,用法同pdns-mysql。
所有可用设置
详见PowerDNS权威服务器设置文档。
启用API的主服务器(含从服务器配置)
bashdocker 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
带超级主服务器的从服务器
bashdocker 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
!Docker Image Size (tag) !Docker Image Size (tag) !Docker Pulls
https://hub.docker.com/r/pschiffe/pdns-recursor/
包含可完全配置的PowerDNS 4.x递归器,支持通过环境变量自定义配置。
通过PDNS_前缀环境变量配置,变量会被写入/etc/pdns/recursor.conf,转换规则为:去除PDNS_前缀,_替换为-。例如,PDNS_api_key=secret会转换为api-key=secret。
所有可用设置详见PowerDNS递归器设置文档。
启用API的递归器
bashdocker 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
!Docker Image Size (tag) !Docker Pulls
https://hub.docker.com/r/pschiffe/pdns-admin/
包含https://github.com/PowerDNS-Admin/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
与官方https://hub.docker.com/_/mariadb/%E9%95%9C%E5%83%8F%E4%BB%A5%E5%88%AB%E5%90%8D%60mysql%60%E9%93%BE%E6%8E%A5%E6%97%B6%EF%BC%8C%E8%87%AA%E5%8A%A8%E9%85%8D%E7%BD%AE%E8%BF%9E%E6%8E%A5%E3%80%82
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="http://pdns:8081/" PDNS_API_KEY="" PDNS_VERSION=""
与本仓库的pdns-mysql镜像以别名pdns链接时,自动配置连接,无需手动指定上述变量。
API密钥与SALT
需通过PDNS_ADMIN_SALT环境变量指定SALT(用于生成API密钥),可通过以下命令生成:
bashpython3 -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和数据库
bashdocker 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
bashdocker 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 \ pschiffe/pdns-admin
提供示例docker-compose文件,可通过以下命令启动:
bashdocker-compose -f docker-compose-mysql.yml up -d
提供Ansible playbook用于构建和运行容器:
bashansible-playbook ansible-playbook-mysql.yml
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。






探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
无需登录使用专属域名
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
VS Code Dev Containers 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
Harbor Proxy Repository 对接专属域名
Portainer Registries 加速拉取
Nexus3 Docker Proxy 内网缓存
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
docker search 限制
站内搜不到镜像
离线 save/load
插件要用 plugin install
WSL 拉取慢
安全与 digest
新手拉取配置
镜像合规机制
manifest unknown
no matching manifest(架构)
invalid tar header(解压)
TLS 证书失败
DNS 超时
域名连通性排查
410 Gone 排查
402 与流量用尽
401 认证失败
429 限流
D-Bus 凭证提示
413 与超大单层
来自真实用户的反馈,见证轩辕镜像的优质服务