connectitnet/pdns

PowerDNS 4.1 Docker镜像（基于Debian 9 Stretch）

本仓库包含四个Docker镜像：pdns（权威服务器）、pdns-recursor（递归解析器）、pdns-admin（管理后台后端）及pdns-admin-nginx（管理后台前端），所有镜像均支持通过环境变量进行完全配置。

镜像概述

• pdns：PowerDNS 4.1.x权威服务器，支持MySQL、PostgreSQL、SQLite3后端，可配置为主/从模式，支持API及超级大师（supermaster）自动配置。
• pdns-recursor：PowerDNS 4.1.x递归解析器，提供高性能域名解析服务。
• pdns-admin：基于Flask的PowerDNS管理后台后端（gunicorn运行），需外部数据库支持，可集成LDAP认证。
• pdns-admin-nginx：管理后台前端，作为nginx代理连接pdns-admin-uwsgi后端。

核心功能

1. 权威服务器：支持多数据库后端，主从同步，API管理，超级大师自动配置。
2. 递归解析器：高性能递归查询，灵活的环境变量配置。
3. Web管理后台：可视化管理DNS记录，支持LDAP认证，数据持久化。

使用场景

• 搭建企业内部DNS服务器集群（主从架构）。
• 部署递归解析器加速内部域名解析。
• 通过Web界面统一管理多个PowerDNS服务器的域名记录。

配置说明

pdns配置

• 通过BACKEND指定数据库后端（gmysql/gpgsql/gsqlite3）。
• PDNS_前缀的环境变量会转换为pdns.conf配置（下划线转连字符），例如PDNS_gmysql_host=mysql → gmysql-host=mysql。
• SUPERMASTER_IPS：配置从服务器的超级大师IP（空格分隔多个IP）。

pdns-recursor配置

• PDNS_前缀变量转换为recursor.conf配置，方式同pdns。

pdns-admin配置

• PDNS_ADMIN_前缀变量写入config.py，字符串值需用单引号包裹（如PDNS_ADMIN_SQLA_DB_HOST="'sql'"）。
• 需配置PowerDNS服务器API地址及密钥（PDNS_ADMIN_PDNS_STATS_URL、PDNS_ADMIN_PDNS_API_KEY）。

部署示例

pdns主服务器（启用API）

shell
docker run -d -p 53:53 -p 53:53/udp --name pdns-master \
  --hostname ns1.example.com \
  -e BACKEND=gmysql \
  -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_soa_minimum_ttl=1200 \
  -e PDNS_default_soa_name=ns1.example.com \
  -e PDNS_default_soa_mail=hostmaster.example.com \
  -e PDNS_allow_axfr_ips=172.5.0.21 \
  -e PDNS_only_notify=172.5.0.21 \
  docker.xuanyuan.run/connectitnet/pdns

pdns从服务器（超级大师配置）

shell
docker run -d -p 53:53 -p 53:53/udp --name pdns-slave \
  --hostname ns2.example.com --link mariadb:mysql \
  -e BACKEND=gmysql \
  -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/connectitnet/pdns

pdns-recursor递归器

shell
docker run -d -p 53:53 -p 53:53/udp --name pdns-recursor docker.xuanyuan.run/connectitnet/pdns-recursor

pdns-admin-uwsgi后端（LDAP认证）

shell
docker run -d --name pdns-admin-uwsgi \
  --link mariadb:mysql --link pdns-master:pdns \
  -v pdns-admin-upload:/opt/powerdns-admin/upload \
  -e PDNS_ADMIN_LDAP_TYPE="'ldap'" \
  -e PDNS_ADMIN_LDAP_URI="'ldaps://your-ldap-server:636'" \
  -e PDNS_ADMIN_LDAP_USERNAME="'cn=dnsuser,ou=users,ou=services,dc=example,dc=com'" \
  -e PDNS_ADMIN_LDAP_PASSWORD="'dnsuser'" \
  -e PDNS_ADMIN_LDAP_SEARCH_BASE="'ou=System Admins,ou=People,dc=example,dc=com'" \
  -e PDNS_ADMIN_LDAP_USERNAMEFIELD="'uid'" \
  -e PDNS_ADMIN_LDAP_FILTER="'(objectClass=inetorgperson)'" \
  docker.xuanyuan.run/connectitnet/pdns-admin-uwsgi

pdns-admin-nginx前端

shell
docker run -d --name pdns-admin-nginx \
  --link pdns-admin-uwsgi:pdns-admin-uwsgi \
  connectitnet/pdns-admin-nginx