powerdns/pdns-recursor-47

PowerDNS Recursor v4.7.x 镜像文档

概述

PowerDNS Recursor 是一款功能强大的DNS递归服务器，版权归 PowerDNS.COM BV 及众多贡献者所有，采用 GNU GPLv2 许可证（详见 NOTICE 文件获取确切许可及例外条款）。v4.7.x 版本提供稳定的DNS递归查询处理能力，广泛应用于各类DNS基础设施。

所有官方文档可访问 [***] 获取。最新更新请查阅 变更日志，编译相关详情可参考 编译附录。问题反馈请提交至 https://github.com/PowerDNS/pdns/issues%EF%BC%88%E6%8F%90%E4%BA%A4%E5%89%8D%E8%AF%B7%E5%85%88%E6%A3%80%E6%9F%A5%E6%98%AF%E5%90%A6%E5%B7%B2%E6%9C%89%E7%9B%B8%E5%85%B3 issue）。

核心功能与特性

• 高性能递归查询：高效处理DNS递归请求，支持大规模并发查询
• 模块化架构：可通过 --with-modules 配置多种后端模块（如 bind、gmysql、gpgsql 等）
• 跨平台支持：兼容 Linux、FreeBSD、macOS 等多种操作系统
• 灵活配置：支持丰富的配置选项，满足不同场景需求
• 安全特性：支持 DNSSEC（需配置相应依赖），增强查询安全性

使用场景

• 企业内部DNS服务基础设施
• 互联网服务提供商（ISP）的DNS递归服务
• 大型网络环境中的DNS流量负载均衡
• 开发测试环境中的DNS服务搭建

使用方法

Docker部署

PowerDNS Docker 镜像相关信息请参考 https://github.com/PowerDNS/pdns/blob/master/Docker-README.md%E3%80%82

源代码获取与编译

源代码克隆

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

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

编译依赖

PowerDNS 编译依赖 Boost、OpenSSL、Lua 及支持 C++-2017 的编译器。不同系统的依赖安装命令如下：

Debian 9：

sh
apt install g++ libboost-all-dev libtool make pkg-config default-libmysqlclient-dev libssl-dev libluajit-5.1-dev python3-venv
# 从源码编译时需额外安装
apt install autoconf automake ragel bison flex

Ubuntu 18.04：

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）。更多编译细节见 官方编译文档。

系统特定编译注意事项

FreeBSD

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

sh
export CXXFLAGS=-std=c++17

macOS

• 通过 Homebrew 安装依赖：

sh
brew install boost lua pkg-config ragel openssl

• 编译配置：

sh
./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

无特殊注意事项，按常规编译步骤操作即可。

HTML文档构建

PowerDNS 文档基于 ReStructured Text (rst) 文件（位于 docs 目录），使用 Sphinx 生成 HTML。构建步骤：

1. 安装编译依赖并生成配置文件（见前文）
2. 进入 docs 目录执行构建：

sh
cd docs
make html-docs

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