本仓库包含以下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仓库:[***]
!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通过环境变量配置:所有以PDNS_为前缀的变量会被处理并写入/etc/pdns/pdns.conf,规则为:去除PDNS_前缀,将_替换为-。例如,PDNS_gmysql_host=mysql会转换为gmysql-host=mysql。
支持SUPERMASTER_IPS环境变量,用于配置从DNS服务器的超级主服务器(文档),支持空格分隔的多个IP地址。
详见PowerDNS权威服务器设置文档。
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
[***]
包含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链接,上述变量可自动配置,无需手动指定。
与pdns-mysql相同,通过PDNS_前缀环境变量配置,变量转换规则一致。
支持SUPERMASTER_IPS环境变量,用法同pdns-mysql。
详见PowerDNS权威服务器设置文档。
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
[***]
包含可完全配置的PowerDNS 4.x递归器,支持通过环境变量自定义配置。
通过PDNS_前缀环境变量配置,变量会被写入/etc/pdns/recursor.conf,转换规则为:去除PDNS_前缀,_替换为-。例如,PDNS_api_key=secret会转换为api-key=secret。
所有可用设置详见PowerDNS递归器设置文档。
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
[***]
包含PowerDNS Admin web应用(基于Flask开发),用于管理PowerDNS服务器。需外部MySQL或PostgreSQL服务器,包含Caddy前端(处理静态文件及HTTPS)和uWSGI后端。
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链接时,自动配置连接。
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服务器启用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链接时,自动配置连接,无需手动指定上述变量。
需通过PDNS_ADMIN_SALT环境变量指定SALT(用于生成API密钥),可通过以下命令生成:
bashpython3 -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:逗号分隔的额外域名(重定向至主域名)8080→80,8443→443(含UDP,用于HTTP/3)/var/lib/caddy(存储证书)用户上传目录需持久化:/opt/powerdns-admin/upload
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
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=[***] \ -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 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