explaingit

privacy-protection-tools/anti-ad

10,389Audience · generalComplexity · 1/5Setup · easy

TLDR

A regularly updated DNS blocklist focused on Chinese-language ad and tracking domains, subscribe with AdGuardHome, Pi-Hole, Clash, or similar tools to block ads across all devices on your network.

Mindmap

mindmap
  root((anti-AD))
    Purpose
      Block Chinese Ads
      Block Trackers
    How It Works
      DNS Level Blocking
      Merged Upstream Lists
    Supported Tools
      AdGuardHome
      Pi-Hole
      Clash
      Dnsmasq
    Formats
      Multiple File Formats
      Auto Updated
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Block Chinese-language ads on smart TV boxes and mobile apps at the network level without any browser extension.

USE CASE 2

Add Chinese ad domain coverage to AdGuardHome or Pi-Hole to catch ads that generic blocklists miss.

USE CASE 3

Block tracking and analytics domains that quietly collect personal data on the Chinese-language internet.

USE CASE 4

Subscribe to a regularly maintained, deduplicated blocklist that automatically merges dozens of upstream sources.

Getting it running

Difficulty · easy Time to first run · 5min
No license information is mentioned in the explanation.

In plain English

anti-AD is a regularly updated blocklist aimed at the Chinese-language internet. Its purpose is to block ads and stop websites from quietly collecting personal data. It focuses on achieving a high hit rate for Chinese ad domains, meaning it catches a large proportion of ads that other general blocklists miss. The list works at the DNS level. Instead of blocking ads after a page loads, it prevents your device from even reaching the ad server by blocking the domain name lookup. This approach works across websites, smart TV boxes, and in-app ads inside mobile applications. It also blocks domains known to gather analytics data and personal information without user awareness. To use anti-AD, you add one of its filter files to a supported tool. The project provides files in multiple formats to cover the most common network tools: AdGuardHome, dnsmasq, Pi-Hole, Surge, Clash, mihomo, smartdns, and sing-box. Each tool has a matching file format available for download directly from the project's website or from GitHub. Behind the scenes, the project merges dozens of upstream blocklists from other well-known sources, removes duplicate entries, strips out expired domains, and applies additional processing to improve accuracy. This is meant to reduce false positives (accidentally blocking things that are not ads) while maximizing coverage of actual ad and tracking domains. A curated list of disputed domains is also maintained separately for cases where a domain serves both ads and legitimate functions, so users can decide for themselves whether to block them. The project is fully open source, and all filter rules are sourced from upstream lists or contributed by users through the issue tracker. The README and most of the project documentation are written in Chinese.

Copy-paste prompts

Prompt 1
I'm running AdGuardHome on my home network. Give me the exact URL to add anti-AD's AdGuardHome filter file as a custom blocklist subscription.
Prompt 2
I use Pi-Hole. How do I add the anti-AD blocklist to block Chinese ad domains, and how often does it need to be refreshed?
Prompt 3
I want to use anti-AD with Clash on my router. Which file format should I use and how do I add it to my Clash configuration?
Prompt 4
How do I self-host the anti-AD filter file so my Pi-Hole pulls updates from my own server instead of GitHub?
Open on GitHub → Explain another repo

← privacy-protection-tools on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.