AdGuard C++ DNS libraries

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

Supported platforms

• Linux
• macOS
• iOS
• Windows
• Android

Features

• Caching, filtering, encryption, and redirection of DNS requests.
• Support for all modern encrypted DNS protocols:
  • DNS-over-TLS (DoT)
  • DNS-over-HTTPS (DoH)
  • DNS-over-QUIC (DoQ)
  • DNSCrypt
• Cross-platform C++ core with platform-specific adapters for macOS, iOS, Android, and Windows.

Usage

The library is organized into a shared C++ core and platform-specific adapters.

• Proxy configuration:
  • native
  • macOS/iOS
  • Android
• Filtering rules syntax

adyg command-line tool

The repository includes adyg, a small dig-like command-line tool that can send DNS queries over all supported protocols (plain DNS, DoT, DoH, DoQ, and DNSCrypt via DNS Stamps). It is handy for ad-hoc DNS lookups and for exercising upstream configurations during development.

See docs/adyg.md for build instructions, usage, and options.

Documentation

• Developer documentation — how to build, test, and develop the library.
• Platform-specific build and integration guides:
  • macOS/iOS framework
  • macOS DNS proxy sample app
  • Android platform adapter
  • Windows C API DLL
  • Windows C# test application
  • NEDnsProxyProvider support
• Project conventions

License

Apache 2.0