MCPcopy Index your code
hub / github.com/AdguardTeam/AdGuardDNS

github.com/AdguardTeam/AdGuardDNS @v2.22.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v2.22.0 ↗ · + Follow
4,774 symbols 16,368 edges 613 files 3,227 documented · 68%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

AdGuard DNS

    <img alt="AdGuard DNS" src="https://cdn.adtidy.org/website/images/AdGuardDNS_black.svg" width="300px"/>












<a href="https://adguard-dns.io/">AdGuard DNS Website</a> |
<a href="https://reddit.com/r/Adguard">Reddit</a> |
<a href="https://twitter.com/AdGuard">Twitter</a>

AdGuard DNS is an alternative solution for tracker blocking, privacy protection, and parental control. Easy to set up and free to use, it provides a necessary minimum of best protection against online ads, trackers, and phishing, no matter what platform and device you use.

DNS privacy

If you use regular client-server protocol, you are at risk of your DNS requests being intercepted and, subsequently, eavesdropped and/or altered. For instance, in the US the Senate voted to eliminate rules that restricted ISPs from selling their users' browsing data. Moreover, DNS is often used for censorship and surveillance purposes on the government level.

All of this is possible due to the lack of encryption, and AdGuard DNS provides a solution. It supports all known DNS encryption protocols including DNS-over-HTTPS, DNS-over-TLS, DNS-over-QUIC, and DNSCrypt.

On top of that, AdGuard DNS provides no-logs privacy policy which means we do not record logs of your browsing activity.

Basic features

  • Blocking trackers network-wide with no additional software required. You can even set it up on your router to block ads on all devices connected to your home Wi-Fi network.

  • Protection from phishing and hazardous websites and malvertising (malicious ads).

  • Use the Family protection mode of AdGuard DNS to block access to all websites with adult content and enforce safe search in the browser, in addition to the regular perks of ad blocking and browsing security.

Can AdGuard DNS replace a traditional blocker?

It depends. DNS-level blocking lacks the flexibility of the traditional ad blockers. For instance, there is no cosmetic pages processing. So in general, traditional blockers provide higher quality.

Personal DNS server

A screenshot of the AdGuard DNS dashboard
AdGuard DNS dashboard

You can sign up for a personal AdGuard DNS account and get access to the following features:

  • Manage devices and their settings in one place.

  • Manage blocklists that are used to block ads.

  • View statistics on the DNS queries, companies, countries your devices try to connect to.

  • You can also maintain your own set of rules in the "User rules" section. AdGuard DNS provides a flexible rules system.

  • AdGuard DNS also provides an API that can be used to integrate with it if you need that.

Software license

Copyright (C) 2022-2026 AdGuard Software Ltd.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, version 3.

Extension points exported contracts — how you extend this code

Core symbols most depended-on inside this repo

Shape

Method 2,561
Function 1,237
Struct 769
Interface 133
TypeAlias 65
FuncType 9

Languages

Go100%

Modules by API surface

internal/backendgrpc/dnspb/dns.pb.go570 symbols
internal/profiledb/internal/fcpb/fc.pb.go555 symbols
internal/backendgrpc/dnspb/dns_grpc.pb.go121 symbols
internal/agdtest/interface.go66 symbols
internal/cmd/builder.go58 symbols
internal/backendgrpc/metrics.go38 symbols
internal/profiledb/filecacheopb/profile.go34 symbols
internal/dnsserver/serverbase.go28 symbols
internal/backendgrpc/dnspb/profile.go28 symbols
internal/profiledb/default.go27 symbols
internal/dnsserver/dnsservertest/msg.go27 symbols
internal/cmd/env.go27 symbols

For agents

$ claude mcp add AdGuardDNS \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page