powerdns/pdns-auth-46

PowerDNS Authoritative Server 镜像文档

概述

PowerDNS Authoritative Server是一款功能强大的开源权威DNS服务器，版权归PowerDNS.COM BV及众多贡献者所有（2001-2021），采用GNU GPLv2许可证（详见NOTICE文件了解确切许可及例外条款）。该服务器支持多种后端存储，提供高性能和灵活的DNS服务配置，适用于各类DNS服务场景。

完整文档请访问：https://doc.powerdns.com/。最新更新请查阅https://doc.powerdns.com/authoritative/changelog/，编译相关信息可参考https://doc.powerdns.com/authoritative/appendices/compiling.html。问题反馈请提交至https://github.com/PowerDNS/pdns/issues（提交前请先检查是否已有相关issue）。

核心功能与特性

• 多后端支持：兼容Bind区域文件、MySQL、PostgreSQL等多种数据存储后端
• 开源免费：基于GNU GPLv2许可证，源代码完全开放可定制
• 高性能架构：优化的DNS查询处理机制，支持高并发解析场景
• 模块化设计：可按需编译加载不同功能模块，降低资源占用
• 丰富组件生态：包含Recursor（递归DNS服务器）和dnsdist（DNS负载均衡器）

适用场景

• 企业内部DNS服务部署与管理
• 互联网域名解析服务搭建
• 复杂网络环境下的DNS架构构建
• 需要自定义DNS处理逻辑的场景

使用方法

Docker镜像信息

Docker镜像相关详细说明请参考：https://github.com/PowerDNS/pdns/blob/master/Docker-README.md

源代码获取

通过Git克隆完整源代码仓库：

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

该仓库包含PowerDNS Recursor、Authoritative Server和dnsdist的源代码，三者可独立构建并分别发布为.tar.bz2、.deb和.rpm包。

编译指南

权威服务器编译依赖

PowerDNS Authoritative Server依赖Boost、OpenSSL、Lua，且需要支持C++-2011标准的编译器。

Debian 9依赖安装

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 18.04 (Bionic Beaver)依赖安装

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）支持（--with-libsodium）
apt install libsodium-dev
# 如需gmysql（通用MySQL）后端
apt install default-libmysqlclient-dev
# 如需gpgsql（通用PostgreSQL）后端
apt install libpq-dev
# 如需--enable-systemd（创建systemctl/service管理的服务脚本）
apt install libsystemd0 libsystemd-dev
# 如需geoip后端
apt install libmaxminddb-dev libmaxminddb0 libgeoip1 libgeoip-dev

编译步骤

1. 生成configure配置文件：

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开发头文件）。更多后端模块信息见https://doc.powerdns.com/authoritative/backends/index.html。

4. 解决C++11符号问题：如遇相关错误，可通过CPPFLAGS指定ABI版本：

sh
./configure CPPFLAGS=-D_GLIBCXX_USE_CXX11_ABI=0  # 或1，根据依赖库ABI版本调整

Recursor编译

详见源代码目录中的pdns/recursordist/README.md。

dnsdist编译

详见源代码目录中的pdns/README-dnsdist.md。

HTML文档构建

HTML文档（如https://doc.powerdns.com/authoritative/所示）由`docs`目录下的ReStructured Text (rst)文件通过Sphinx生成。

构建步骤：

1. 安装上述"编译依赖"，并生成configure文件：

sh
autoreconf -vi

2. 进入docs目录执行构建命令：

sh
cd docs
make html-docs

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

系统特定说明

FreeBSD注意事项

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

sh
export CXXFLAGS=-std=c++11

macOS注意事项

• 通过Homebrew可直接安装：

sh
brew install pdns

• 手动编译时，需通过Homebrew安装依赖并指定OpenSSL路径：

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注意事项

无特殊说明。