powerdns/pdns-recursor-53

PowerDNS 镜像文档

概述和主要用途

PowerDNS是由PowerDNS.COM BV及众多贡献者开发的开源DNS解决方案，采用GNU GPLv2许可。它集成了权威服务器（Authoritative Server）、递归器（Recursor）和dnsdist（DNS负载均衡器）三大组件，可满足企业级DNS服务的构建需求。完整文档请访问官方文档网站。

核心功能和特性

• 多组件集成：包含权威解析、递归解析和DNS负载均衡功能，一站式满足DNS服务需求
• 模块化架构：支持Bind、MySQL、PostgreSQL等多种后端模块，灵活适配不同数据存储场景
• 现代技术支持：基于C++17开发，确保性能优化和现代语言特性支持
• 跨平台兼容：可在Linux、FreeBSD、macOS等多种操作系统运行
• 安全增强：支持DNSSEC（含ed25519算法），提供安全的域名解析服务
• 容器化部署：提供Docker镜像支持，简化部署流程
• 活跃社区：通过GitHub进行开发维护，支持问题反馈和代码贡献

使用场景和适用范围

• 企业内部DNS服务搭建与管理
• 互联网服务提供商（ISP）的DNS基础设施建设
• 大型网络环境的DNS流量负载均衡与智能路由
• 对DNS服务可用性、可扩展性有高要求的业务场景
• 开发测试环境中的DNS服务模拟与验证

使用方法和配置说明

Docker镜像使用

PowerDNS Docker镜像的详细说明请参考https://github.com/PowerDNS/pdns/blob/master/Docker-README.md%E3%80%82

源代码获取

通过Git克隆源代码仓库：

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

仓库包含权威服务器、递归器和dnsdist的完整源代码，支持单独构建各组件。

编译指南

编译权威服务器

权威服务器依赖Boost、OpenSSL、Lua等库，需C++17兼容编译器。

依赖安装

• 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支持
  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+MySQL+PostgreSQL）：

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

   注：添加特定后端模块需安装对应开发依赖（如PostgreSQL需libpq-dev）

   更多编译细节参见官方编译文档。

   若遇到C++11符号兼容性问题，可尝试：

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

编译递归器

递归器编译说明见源码目录：pdns/recursordist/README.md

编译dnsdist

dnsdist编译说明见源码目录：pdns/README-dnsdist.md

构建HTML文档

基于Sphinx从ReStructured Text生成HTML文档：

1. 准备环境（已安装编译依赖并执行autoreconf）
2. 构建文档：

   sh
   cd docs
   make html-docs
   

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

平台特定注意事项

FreeBSD

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

  sh
  export CXXFLAGS=-std=c++17
  

macOS

• 通过Homebrew安装：

  sh
  brew install pdns
  

• 手动编译：

  sh
  # 安装依赖
  brew install boost lua pkg-config ragel openssl
  # 配置（指定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请先在https://github.com/PowerDNS/pdns/issues%E6%A3%80%E6%9F%A5%E6%98%AF%E5%90%A6%E5%B7%B2%E6%8A%A5%E5%91%8A%EF%BC%8C%E5%86%8D%E6%8F%90%E4%BA%A4%E6%96%B0issue%E3%80%82