本仓库包含以下Docker镜像:pdns-mysql、pdns-pgsql、pdns-recursor和pdns-admin。pdns-pgsql镜像包含可完全配置的PowerDNS 4.x服务器,带有PostgreSQL后端(不含PostgreSQL服务器)。pdns-mysql镜像包含带有MySQL后端的可完全配置PowerDNS 4.x服务器(不含MySQL服务器)。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仓库:[***]
 !Docker Image Size (tag) !Docker Pulls
[***]
带有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
若使用别名pgsql链接***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服务器配置超级主服务器。文档。支持多个IP地址,以空格分隔。
所有可用设置可在此处找到。
启用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
!Docker Image Size (tag) !Docker Image Size (tag) !Docker Pulls
[***]
带有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
若使用别名mysql链接***MariaDB镜像,可自动配置连接,无需指定上述任何变量。如果表不存在,数据库将自动初始化。
PowerDNS服务器可通过环境变量配置。所有以PDNS_开头的变量将插入/etc/pdns/pdns.conf配置文件,规则与pdns-pgsql相同(去除PDNS_前缀,_替换为-)。
支持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
!Docker Image Size (tag) !Docker Image Size (tag) !Docker Pulls
[***]
带有PowerDNS 4.x递归服务器的Docker镜像。
PowerDNS递归服务器可通过环境变量配置。所有以PDNS_开头的变量将插入/etc/pdns/recursor.conf配置文件,规则为:去除PDNS_前缀,_替换为-。例如,PDNS_api_key=secret将变为api-key=secret。
所有可用设置可在此处找到。
启用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
!Docker Image Size (tag) !Docker Pulls
[***]
带有PowerDNS Admin Web应用的Docker镜像,该应用基于Flask编写,用于管理PowerDNS服务器。需要外部MySQL或PostgreSQL服务器。
Docker Hub上还有***pdns-admin镜像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链接***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-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连接(需服务器URL、API密钥和版本,如4.0):
(名称=默认值) PDNS_API_URL="[***]" PDNS_API_KEY="" PDNS_VERSION=""
若使用别名pdns链接本仓库的pdns-mysql镜像,将自动配置,无需指定上述变量。
要生成API密钥,需通过PDNS_ADMIN_SALT环境变量指定SALT。这是一个机密值,可通过以下命令生成:
python3 -c 'import bcrypt; print(bcrypt.gensalt().decode("utf-8"));'
示例值如$2b$12$xxxxxxxxxxxxxxxxxxxxxx。使用docker-compose时,字面$需指定为$$。
内置Caddy服务器可通过Let's Encrypt处理HTTPS。需添加SSL_MAIN_DOMAIN环境变量指定HTTPS主域名,SSL_EXTRA_DOMAINS可包含逗号分隔的域名列表,将重定向到主域名。需正确配置公共DNS,并将pdns-admin的8080、8443和8443/udp端口映射为80、443和443/udp(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 -f docker-compose-mysql.yml up -d
包含的Ansible剧本可用于构建和运行容器:
ansible-playbook ansible-playbook-mysql.yml
来自真实用户的反馈,见证轩辕镜像的优质服务
免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
在 Linux 系统配置镜像加速服务
在 Docker Desktop 配置镜像加速
Docker Compose 项目配置加速
Kubernetes 集群配置 Containerd
在宝塔面板一键配置镜像加速
Synology 群晖 NAS 配置加速
飞牛 fnOS 系统配置镜像加速
极空间 NAS 系统配置加速服务
爱快 iKuai 路由系统配置加速
绿联 NAS 系统配置镜像加速
QNAP 威联通 NAS 配置加速
Podman 容器引擎配置加速
HPC 科学计算容器配置加速
ghcr、Quay、nvcr 等镜像仓库
无需登录使用专属域名加速
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429