{ "componentChunkName": "component---src-templates-issues-tsx", "path": "/issues/431", "result": {"data":{"issuesJson":{"id":"6600c724-94fe-596d-928d-2dfb8880117b","title":"PowerDNS/pdns: PowerDNS 权威、PowerDNS 递归、dnsdist","number":431,"bodyHTML":"
\n



\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ReposPowerDNS/pdns
Views\"views\"
Stars\"stars\"
Forks\"forks\"
License\"license\"
UpdatedAt\"last-commit\"
CreatedAt\"create-at\"
\n\n

\"\"

\n\n
\n

PowerDNS is copyright © by PowerDNS.COM BV and lots of
\ncontributors, using the GNU GPLv2 license (see NOTICE for the
\nexact license and exception used).

\n

All documentation can be found on https://doc.powerdns.com/

\n

This file may lag behind at times. For most recent updates, always check
\nhttps://doc.powerdns.com/authoritative/changelog/

\n

Another good place to look for information is:
\nhttps://doc.powerdns.com/authoritative/appendices/compiling.html

\n

To file bugs, head towards:
\nhttps://github.com/PowerDNS/pdns/issues

\n

But please check if the issue is already reported there first.

\n

DOCKER

\n

This README is mirrored from GitHub to dockerhub.
\nFor information about our Docker images, please refer to https://github.com/PowerDNS/pdns/blob/master/Docker-README.md

\n

SOURCE CODE / GIT

\n

Source code is available on GitHub:

\n
git clone https://github.com/PowerDNS/pdns.git
\n

This repository contains the sources for the PowerDNS Recursor, the PowerDNS
\nAuthoritative Server, and dnsdist (a powerful DNS loadbalancer). All three can
\nbe built from this repository. However, all three released separately as .tar.bz2,
\n.deb and .rpm.

\n

The different releases can be built by the help of pdns-builder, which uses a
\ndocker-based build process. To get started with this, run these commands in the root
\nof this repository:

\n
git submodule init\ngit submodule update\n./builder/build.sh
\n

This will bring up a USAGE-page which will explain how to build the different releases.

\n

COMPILING Authoritative Server

\n

The PowerDNS Authoritative Server depends on Boost, OpenSSL and Lua, and requires a
\ncompiler with C++-2017 support.

\n

On Debian, the following is useful:

\n
apt install g++ libboost-all-dev libtool make pkg-config default-libmysqlclient-dev libssl-dev libluajit-5.1-dev python3-venv
\n

When building from git, the following packages are also required:

\n
apt install autoconf automake ragel bison flex
\n

For Ubuntu, the following packages should be installed:

\n
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\n# For DNSSEC ed25519 (algorithm 15) support with --with-libsodium\napt install libsodium-dev\n# If using the gmysql (Generic MySQL) backend\napt install default-libmysqlclient-dev\n# If using the gpgsql (Generic PostgreSQL) backend\napt install libpq-dev\n# If using --enable-systemd (will create the service scripts so it can be managed with systemctl/service)\napt install libsystemd0 libsystemd-dev\n# If using the geoip backend\napt install libmaxminddb-dev libmaxminddb0 libgeoip1 libgeoip-dev
\n

Then generate the configure file:

\n
autoreconf -vi
\n

To compile a very clean version, use:

\n
./configure --with-modules=\"\" --disable-lua-records\nmake\n# make install
\n

This generates a PowerDNS Authoritative Server binary with no modules built in.

\n

See https://doc.powerdns.com/authoritative/backends/index.html for a list of available modules.

\n

When ./configure is run without --with-modules, the bind and gmysql module are
\nbuilt-in by default and the pipe-backend is compiled for runtime loading.

\n

To add multiple modules, try:

\n
./configure --with-modules=\"bind gmysql gpgsql\"
\n

Note that you will need the development headers for PostgreSQL as well in this case.

\n

See https://doc.powerdns.com/authoritative/appendices/compiling.html for more details.

\n

If you run into C++11-related symbol trouble, please try passing CPPFLAGS=-D_GLIBCXX_USE_CXX11_ABI=0 (or 1) to ./configure to make sure you are compatible with the installed dependencies.

\n

Compiling the Recursor

\n

See README.md in pdns/recursordist/.

\n

Compiling dnsdist

\n

See README-dnsdist.md in pdns/.

\n

Building the HTML documentation

\n

The HTML documentation (as seen on the PowerDNS docs site) is built from ReStructured Text (rst) files located in docs. They are compiled into HTML files using Sphinx, a documentation generator tool which is built in Python.

\n

Install the dependencies under \"COMPILING\", and run autoreconf if you haven't already:

\n
autoreconf -vi
\n

Enter the docs folder, and use make to build the HTML docs.

\n
cd docs\nmake html-docs\n
\n

The HTML documentation will now be available in html-docs.

\n

FreeBSD Notes

\n

You need to compile using gmake - regular make only appears to work, but doesn't in fact. Use gmake, not make.

\n

The clang compiler installed through FreeBSD's package manager does not expose all of the C++17 features needed under the default std=gnuc++14. Force the compiler to use std=c++17 mode instead.

\n
export CXXFLAGS=-std=c++17
\n

macOS Notes

\n

PowerDNS Authoritative Server is available through Homebrew:

\n
brew install pdns\n
\n

If you want to compile yourself, the dependencies can be installed using
\nHomebrew. You need to tell configure where to find OpenSSL, too.

\n
brew install boost lua pkg-config ragel openssl\n./configure --with-modules=\"\" PKG_CONFIG_PATH=/usr/local/opt/openssl/lib/pkgconfig\nmake -j4
\n

Additionally, for PostgreSQL support, run brew install postgresql and add --with-modules=\"gpgsql\" to ./configure.
\nFor MySQL support, run brew install mariadb and add --with-modules=\"gmysql\" to ./configure.

\n

Linux notes

\n

None really.

","updatedAt":"2025-05-21T16:15:28Z","upvoteCount":null,"author":{"login":"eryajf","avatarUrl":"https://avatars.githubusercontent.com/u/33259379?u=e4a4090a38ac2473aaed4ef9945233636776c6c3&v=4","url":"https://github.com/eryajf"},"category":null,"labels":{"edges":[{"node":{"name":"更多","color":"25B472"}},{"node":{"name":"DNS","color":"d6c39d"}},{"node":{"name":"PowerDNS","color":"7a80b5"}}]},"comments":{"edges":[]}}},"pageContext":{"number":431,"previous":{"title":"pdm-project/pdm: 一个现代的 Python 包管理器，支持 PEP 最新标准。","number":430},"next":{"title":"peco/peco: 简单的交互式过滤工具。","number":432}}}, "staticQueryHashes": ["151096407","2861350382"]}