powerdns/pdns-auth-51

PowerDNS 权威服务器镜像文档

镜像概述和主要用途

PowerDNS 权威服务器（PowerDNS Authoritative Server）是由PowerDNS.COM BV及众多贡献者开发的DNS服务器软件，采用GNU GPLv2许可证（详见NOTICE文件了解确切许可条款和例外）。该软件主要用于提供域名解析服务，支持多种后端存储和灵活的模块配置，适用于构建企业级DNS服务、域名解析服务器等场景。

所有官方文档可访问 https://doc.powerdns.com/ 获取，最新更新请查看 https://doc.powerdns.com/authoritative/changelog/。

核心功能和特性

• 多后端支持：兼容多种数据存储后端，如Bind区域文件、MySQL（gmysql）、PostgreSQL（gpgsql）等
• 模块化设计：支持动态加载模块，可根据需求选择内置模块（默认包含bind和gmysql模块）
• DNSSEC支持：提供DNSSEC签名功能，支持ed25519算法（需编译时启用libsodium）
• 高性能：采用C++开发，支持C++17标准，具备高效的DNS请求处理能力
• 跨平台：支持Linux、FreeBSD、macOS等多种操作系统
• 丰富工具链：包含PowerDNS Recursor（递归服务器）和dnsdist（DNS负载均衡器）

使用场景和适用范围

• 企业内部DNS服务部署
• 互联网域名解析服务器搭建
• 多区域DNS管理和负载均衡
• 需要自定义DNS记录处理逻辑的场景
• 对DNSSEC安全有需求的环境

使用方法和配置说明

Docker镜像信息

Docker镜像相关说明请参考官方GitHub文档：https://github.com/PowerDNS/pdns/blob/master/Docker-README.md

源码获取

通过Git获取源码：

sh
git clone https://github.com/PowerDNS/pdns.git

该仓库包含PowerDNS Recursor、PowerDNS Authoritative Server和dnsdist的源代码，支持分别构建或打包为.tar.bz2、.deb、.rpm等格式。

编译权威服务器

依赖要求

• Boost、OpenSSL、Lua开发库
• 支持C++17的编译器（如GCC 7+、Clang 5+）

Debian系统依赖安装

sh
apt install g++ libboost-all-dev libtool make pkg-config default-libmysqlclient-dev libssl-dev libluajit-5.1-dev python3-venv

从Git源码编译时需额外安装：

sh
apt install autoconf automake ragel bison flex

Ubuntu系统依赖安装

sh
apt install libcurl4-openssl-dev luajit lua-yaml-dev libyaml-cpp-dev libtolua-dev lua5.3 autoconf automake ragel bison flex g++ libboost-all-dev libtool make pkg-config libssl-dev lua-yaml-dev libyaml-cpp-dev libluajit-5.1-dev libcurl4 gawk libsqlite3-dev python3-venv
# DNSSEC ed25519支持（算法15）
apt install libsodium-dev
# MySQL后端支持
apt install default-libmysqlclient-dev
# PostgreSQL后端支持
apt install libpq-dev
# systemd服务支持
apt install libsystemd0 libsystemd-dev
# GeoIP后端支持
apt install libmaxminddb-dev libmaxminddb0 libgeoip1 libgeoip-dev

编译步骤

1. 生成配置文件：

sh
autoreconf -vi

2. 基础编译（无模块）：

sh
./configure --with-modules="" --disable-lua-records
make
# 可选：make install

3. 带模块编译（例如bind、gmysql、gpgsql）：

sh
./configure --with-modules="bind gmysql gpgsql"
make

注意：添加特定后端模块时需确保已安装相应开发库（如PostgreSQL模块需libpq-dev）

更多编译细节请参考：https://doc.powerdns.com/authoritative/appendices/compiling.html

编译递归服务器

参考源码目录中的文档：pdns/recursordist/README.md

编译dnsdist

参考源码目录中的文档：pdns/README-dnsdist.md

构建HTML文档

HTML文档基于ReStructured Text（rst）文件构建，使用Sphinx工具生成：

1. 确保已安装编译依赖并运行autoreconf：

sh
autoreconf -vi

2. 进入docs目录并构建：

sh
cd docs
make html-docs

生成的HTML文档位于html-docs目录下。

系统特定注意事项

FreeBSD

• 必须使用gmake而非系统默认make
• Clang编译器需强制C++17模式：

sh
export CXXFLAGS=-std=c++17

macOS

• 通过Homebrew可直接安装：

sh
brew install pdns

• 手动编译依赖安装：

sh
brew install boost lua pkg-config ragel openssl
./configure --with-modules="" PKG_CONFIG_PATH=/usr/local/opt/openssl/lib/pkgconfig
make -j4

• 额外后端支持：
  • PostgreSQL：brew install postgresql，添加--with-modules="gpgsql"
  • MySQL：brew install mariadb，添加--with-modules="gmysql"

Linux

无特殊注意事项。

问题反馈

如遇bug，请先在GitHub Issues中检查是否已报告，再提交新issue：https://github.com/PowerDNS/pdns/issues