A DNS proxy library that supports all existing DNS protocols including DNS-over-TLS, DNS-over-HTTPS, and DNSCrypt.

git submodule init
git submodule update

• CMake 3.6 or higher
• GCC 9 or higher / Clang 8 or higher

Execute the following commands in Terminal:

cd <path/to/dnsproxy>
mkdir build && cd build
cmake ..
make -j 4 dnsproxy

For testing execute the following:

make -j 4 tests
ctest -j 4

• CMake 3.6 or higher
• Clang 8 or higher
• Xcode 11 or higher

Execute the following commands in Terminal:

cd <path/to/dnsproxy>
bash platform/mac/framework/build_dnsproxy_framework.sh --bp <build_path> --fwp <path/to/dnsproxy>/platform/mac/framework/ --iosv 13.0

For details of the building script usage execute the following:

bash platform/mac/framework/build_dnsproxy_framework.sh --help

As a result the DNS proxy framework will be located in <build_path>/<target_name>.<framework_type>, where <build_path> is the build path one passed to script, <target_name> is the framework name, <framework_type> is either framework (if one specified the target platform) or xcframework (if one didn't specify any platform, or passed all).

• use already written third-party libraries (Google Test for tests, etc.)
• use submodules
• use CMake
• for code style see CODE_STYLE.md

Every subproject consists of the following directories and files:

• include/ - public headers
• src/ - source code files and provate headers
• test/ - tests and its data
• CMakeLists.txt - cmake build config. Should be self-configurable.

Root project consists of the following directories and files:

• common/ - Set of useful general-purpose utilities
• dnscrypt/ - DNSCrypt client implementation
• dnsfilter/ - DNS filter implementation
• dnsstamp/ - DNSCrypt server stamps encoder/decoder
• platform/ - Platform-specific interfaces and adapters
• proxy/ - DNS proxy implementation
• third-party/ - third-party libraries (this is not a subproject, so subproject's rules are not enforced)
• tls/ - TLS communication-related things (e.g. certificate verifier)
• upstream/ - Working with DNS upstreams
• CMakeLists.txt - main cmake build config. Should build common things and include platform-specific things.

• Proxy configuration: native, mac, android
• Rules syntax

Copyright (C) AdGuard Software Ltd.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.