powerdns/pdns-auth-50

PowerDNS Authoritative Server v5.0.x 文档

镜像概述和主要用途

PowerDNS Authoritative Server 是由 PowerDNS.COM BV 及众多贡献者开发的DNS权威服务器，采用GNU GPLv2许可协议（详见NOTICE文件获取确切许可及例外条款）。该服务器用于管理DNS区域数据并响应DNS查询，支持多种后端模块及灵活部署方式。所有官方文档可访问https://doc.powerdns.com/%EF%BC%8C%E6%9C%80%E6%96%B0%E6%9B%B4%E6%96%B0%E8%AF%B7%E6%9F%A5%E7%9C%8Bhttps://doc.powerdns.com/authoritative/changelog/%EF%BC%8Cbug%E6%8F%90%E4%BA%A4%E8%AF%B7%E8%AE%BF%E9%97%AEhttps://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%E6%8A%A5%E5%91%8A%EF%BC%89%E3%80%82

核心功能和特性

多后端支持

支持多种后端模块（如bind、gmysql、gpgsql等），可通过编译配置灵活选择，满足不同数据存储需求（文件、数据库等）。

可扩展性

支持动态加载模块，默认内置bind和gmysql模块，pipe-backend可编译为运行时加载，也可通过--with-modules指定多模块编译。

多部署方式

提供Docker镜像部署（详情参考GitHub Docker文档）及源码编译两种方式，支持跨平台（Debian、Ubuntu、FreeBSD、macOS、Linux等）。

源码开放

源代码托管于GitHub，包含PowerDNS Recursor、Authoritative Server及dnsdist（DNS负载均衡器），支持定制化编译。

使用场景和适用范围

企业DNS管理

适用于企业内部或外部DNS服务搭建，管理域名解析记录，支持多后端适配企业现有数据存储架构。

DNS服务提供商

作为权威DNS服务器，为大量域名提供稳定的解析服务，支持模块扩展以满足高可用性需求。

定制化DNS需求

通过源码编译配置特定模块（如geoip后端实现地理分布式解析），满足特殊业务场景。

使用方法和配置说明

Docker部署

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

源代码获取

通过Git克隆源码仓库：

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

该仓库包含Recursor、Authoritative Server及dnsdist的源代码，三者可分别编译为.tar.bz2、.deb和.rpm格式发布。

编译Authoritative Server

依赖安装

需安装Boost、OpenSSL、Lua等依赖及C++-2017兼容编译器：

• Debian系统：

  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系统：

  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
  # gmysql后端
  apt install default-libmysqlclient-dev
  # gpgsql后端
  apt install libpq-dev
  # systemd支持（生成systemctl/service管理的服务脚本）
  apt install libsystemd0 libsystemd-dev
  # geoip后端
  apt install libmaxminddb-dev libmaxminddb0 libgeoip1 libgeoip-dev
  

生成配置文件

从源码编译时，需先生成configure文件：

sh
autoreconf -vi

编译命令示例

• 最小化编译（无模块）：

  sh
  ./configure --with-modules="" --disable-lua-records
  make
  # make install  # 可选，安装至系统
  

  生成无内置模块的二进制文件。

• 默认编译：未指定--with-modules时，默认内置bind和gmysql模块，pipe-backend编译为运行时加载。

• 多模块编译：

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

  需确保已安装对应模块的开发头文件（如PostgreSQL开发头文件）。

编译注意事项

• 更多后端模块列表请参考https://doc.powerdns.com/authoritative/backends/index.html%E3%80%82
• 若遇到C++11相关符号问题，可尝试传递CPPFLAGS=-D_GLIBCXX_USE_CXX11_ABI=0（或1）给./configure，确保与依赖库兼容。
• 详细编译说明见https://doc.powerdns.com/authoritative/appendices/compiling.html%E3%80%82

其他组件编译说明

• Recursor编译：参考pdns/recursordist/README.md。
• dnsdist编译：参考pdns/README-dnsdist.md。

HTML文档构建

HTML文档（如https://doc.powerdns.com/authoritative/%EF%BC%89%E7%94%B1%60docs%60%E7%9B%AE%E5%BD%95%E4%B8%8B%E7%9A%84ReStructured Text (rst)文件通过Sphinx生成：

1. 安装上述“依赖安装”中的包，并运行autoreconf -vi。
2. 进入docs目录，执行：

   sh
   make html-docs
   

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