# 🛡️ HaGeZi DNS Blocklist Setup Guide

This guide provides the necessary links and instructions to set up HaGeZi's blocklists on both **AdGuard Home** and **Pi-hole**.

---

## 🚀 Setup Instructions

### For AdGuard Home Users
1. **Filters** > **DNS blocklists** > **Add blocklist** > **Add a custom list**.
2. Copy & paste the Name and URL from the tiers below.

### For Pi-hole Users
1. **Adlists** (left sidebar) > Copy & paste the URLs from the tiers below > **Add**.
2. **Tools** > **Gravity** > **Update**.

---

## 💎 Essential Security: TiF & TiF IPs
Regardless of which "Multi" tier you choose, it is **highly recommended** to use the Threat Intelligence Feeds to significantly increase your security posture against malware, phishing, and botnets.

| List Name | Description | URL |
| :--- | :--- | :--- |
| **TiF (Standard)** | High-confidence threat data. | `https://cdn.jsdelivr.net/gh/hagezi/dns-blocklists@latest/adblock/tif.txt` |
| **TiF IPs** | Blocks known malicious IP addresses. | `https://cdn.jsdelivr.net/gh/hagezi/dns-blocklists@latest/adblock/tif-ips.txt` |

---

## 📊 Blocklist Tiers (The "Multi" Series)

| Protection Level | List Name | URL |
| :--- | :--- | :--- |
| **🟢 Problem Free** | Multi Normal | `https://cdn.jsdelivr.net/gh/hagezi/dns-blocklists@latest/adblock/multi.txt` |
| **🟡 Stress Free** | Multi Pro | `https://cdn.jsdelivr.net/gh/hagezi/dns-blocklists@latest/adblock/pro.txt` |
| **🟠 Advanced** | Multi Pro++ | `https://cdn.jsdelivr.net/gh/hagezi/dns-blocklists@latest/adblock/pro.plus.txt` |
| **🔴 Aggressive** | Multi Ultimate | `https://cdn.jsdelivr.net/gh/hagezi/dns-blocklists@latest/adblock/ultimate.txt` |

---

## 🧩 Other Specialized Lists
For specific needs (e.g., blocking Gambling, Social Media, or Native Trackers), you can find the individual URLs in the official Table of Contents:

🔗 **[View All HaGeZi List URLs (Table of Contents)](https://github.com/hagezi/dns-blocklists?tab=readme-ov-file#bookmark_tabs-table-of-contents)**

### Available Specialized Filters:
* **Security:** Fake/Scam, NRD/DGA (Newly Registered), DNS Rebind, Bypass (VPN/Tor).
* **Lifestyle:** NSFW (Adult), Gambling, Social Networks, Anti-Piracy.
* **Technical:** Native Tracker (OS Telemetry), URL Shortener, Badware Hoster.

---

## ⚪ Whitelisting & Troubleshooting

### FAQ: What is a referral domain?
Affiliate & Referral domains (often found in emails or search ads) are triggered by manual clicks. If you use the **Aggressive** profile, you will likely need to whitelist these.

**Referral Domain Whitelist URL:**
`https://raw.githubusercontent.com/hagezi/dns-blocklists/main/adblock/whitelist-referral.txt`

---
*Source Repository: [HaGeZi GitHub](https://github.com/hagezi/dns-blocklists)*