PowerDNS 镜像文档

概述

PowerDNS 是由 PowerDNS.COM BV 及众多贡献者开发的 DNS 软件套件，采用 GNU GPLv2 许可证（详见 NOTICE 文件了解确切许可证及例外条款）。该套件包含 PowerDNS Recursor（DNS 递归服务器）、PowerDNS Authoritative Server（DNS 权威服务器）和 dnsdist（DNS 负载均衡器），三者可从同一源代码仓库构建，并分别以 .tar.bz2、.deb 和 .rpm 格式发布。

所有文档请访问：[]
最新更新日志：[]
编译相关附录：[]
Bug 提交地址：[***] issue）

Docker 镜像信息

本 README 从 GitHub 同步至 Docker Hub。关于 Docker 镜像的详细信息，请参考：[***]

源代码获取

PowerDNS 源代码托管于 GitHub，可通过以下命令克隆：

sh
git clone [***]

核心功能与特性

• 多组件集成：包含递归服务器（Recursor）、权威服务器（Authoritative Server）和 DNS 负载均衡器（dnsdist），覆盖 DNS 服务全链路需求。
• 模块化设计：支持多种后端模块（如 bind、gmysql、gpgsql 等），可按需配置，灵活扩展功能。
• 高性能：优化的查询处理机制，支持高并发 DNS 查询，适用于大规模网络环境。
• 跨平台支持：可在 Linux、FreeBSD、macOS 等多种操作系统上编译和运行。
• 安全可靠：遵循 DNS 行业标准，支持 DNSSEC 等安全特性（需相应模块支持）。

使用场景与适用范围

• 企业网络：作为内部 DNS 递归服务器，提供稳定的域名解析服务。
• 互联网服务提供商（ISP）：处理大量用户 DNS 查询，保障解析效率与稳定性。
• 数据中心：配合 dnsdist 实现 DNS 流量负载均衡，提升服务可用性。
• 开发与测试：通过源代码编译自定义配置，满足特定功能测试需求。

编译与安装指南

编译依赖说明

PowerDNS 各组件编译需依赖以下工具与库（以 Authoritative Server 为例）：

• 编译器：支持 C++17 的编译器（如 GCC、Clang）
• 基础工具：autoconf、automake、ragel、bison、flex、make、pkg-config
• 依赖库：Boost、OpenSSL、Lua
• 后端模块依赖：根据选择的模块（如 gmysql、gpgsql）需安装对应数据库开发库

Debian 系统依赖安装

sh
apt install g++ libboost-all-dev libtool make pkg-config default-libmysqlclient-dev libssl-dev libluajit-5.1-dev python3-venv
# 从 Git 源码编译时额外依赖
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
# Generic MySQL 后端
apt install default-libmysqlclient-dev
# Generic PostgreSQL 后端
apt install libpq-dev
# systemd 服务支持
apt install libsystemd0 libsystemd-dev
# GeoIP 后端
apt install libmaxminddb-dev libmaxminddb0 libgeoip1 libgeoip-dev

PowerDNS Authoritative Server 编译步骤

1. 生成 configure 文件（从 Git 源码编译时需要）

sh
autoreconf -vi

2. 配置编译选项

• 编译无模块的基础版本：

  sh
  ./configure --with-modules="" --disable-lua-records
  

• 编译默认模块（bind、gmysql 内置，pipe-backend 运行时加载）：

  sh
  ./configure
  

• 自定义模块（如同时支持 bind、gmysql、gpgsql）：

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

注意：自定义模块时需安装对应后端开发库（如 PostgreSQL 开发库 for gpgsql）。

3. 编译与安装

sh
make
# 可选：安装到系统
# make install

PowerDNS Recursor 编译步骤

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

dnsdist 编译步骤

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

HTML 文档构建

PowerDNS ***文档由 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++17 模式：

  sh
  export CXXFLAGS=-std=c++17
  

macOS 系统

• 通过 Homebrew 安装依赖：

  sh
  brew install boost lua pkg-config ragel openssl
  

• 配置时指定 OpenSSL 路径：

  sh
  ./configure --with-modules="" PKG_CONFIG_PATH=/usr/local/opt/openssl/lib/pkgconfig
  

• 可选模块依赖：
  • PostgreSQL 支持：brew install postgresql，配置添加 --with-modules="gpgsql"
  • MySQL 支持：brew install mariadb，配置添加 --with-modules="gmysql"

Linux 系统

无特殊注意事项，按通用编译步骤进行即可。

注意事项

• 编译时若遇到 C++11 相关符号问题，可尝试通过 CPPFLAGS 指定 ABI 版本：

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

• 更多编译细节请参考文档：[]