Ad-Flusher

A powerful blocklist that combines multiple DNS blocklists into one - just add the URL and you're protected from ads, trackers, and malware!

Quick Start

Step 1: Choose Your DNS Software

AdGuard Home

1. Open AdGuard Home dashboard
2. Go to Filters → DNS blocklists
3. Add this URL:

   https://media.githubusercontent.com/media/techroy23/Ad-Flusher/refs/heads/main/output/blocklist.txt
   

Pi-hole

1. Go to Pi-hole admin dashboard
2. Navigate to Group Management → Adlists
3. Add this URL:

   https://media.githubusercontent.com/media/techroy23/Ad-Flusher/refs/heads/main/output/blocklist.txt
   

Step 2: Done!

The list updates automatically every day.

---

Blocklist Format

This blocklist uses AdGuard DNS Filter syntax (||domain.com^). Compatible with:

• AdGuard Home
• AdGuard DNS (Private/Public)
• AdGuard Browser Assistant
• Pi-hole
• Technitium DNS Server
• Blocky
• DNSProxy

Note: Pi-hole supports ||domain.com^ syntax directly since v5.0.

---

Whitelist (Unblock Domains)

Sometimes a domain you need gets blocked. Add the whitelist to unblock it:

AdGuard Home

1. Go to Filters → DNS allowlists
2. Add:

   https://media.githubusercontent.com/media/techroy23/Ad-Flusher/refs/heads/main/output/whitelist.txt
   

Pi-hole

1. Navigate to Group Management → Adlists (allowlist section)
2. Add:

   https://media.githubusercontent.com/media/techroy23/Ad-Flusher/refs/heads/main/output/whitelist.txt
   

---

Custom Entries

Want to add your own blocked domains?

Blocklist

Edit scripts/custom-blocklist.txt and add domains:

||my-custom-block.com
||another-block.com

Whitelist

Edit scripts/custom-whitelist.txt and add domains:

@@||my-custom-allow.com^
@@||unblock-this.com^

---

Requirements

Warning: This blocklist contains millions of entries. It requires 1GB+ RAM to process. If you're using a Raspberry Pi or old hardware, consider using lighter blocklists.

---

Sources

This blocklist aggregates from trusted sources:

Main Blocklists

• oisd.nl - Basic, Small, NSFW, NSFW-Small
• 1Hosts (badmojr) - Lite adblock
• AdGuard DNS Filter - Official AdGuard filter
• StevenBlack Hosts - Unified hosts file

Ad & Tracker Filters

• AdGuard Base, Spyware, Team filters
• EasyList & EasyList variants
• EasyPrivacy

Threat Protection

• HaGeZi DNS Blocklists
• Phishing Army
• Malware-filter
• ShadowWhisperer BlockLists

Regional Filters

• Cyrillic, Dutch, Turkish, Korean, Hebrew, and more

---

Auto-Update

The blocklist updates automatically every day via GitHub Actions.

---

License

MIT