|
|
|
|
@ -1,31 +1,40 @@
|
|
|
|
|
# adguardhome-filters
|
|
|
|
|
|
|
|
|
|
> [!WARNING]
|
|
|
|
|
> **THIS REPOSITORY IS PLANNED TO BE BACK SOON. PLEASE WAIT FUTURE UPDATES**
|
|
|
|
|
> [!NOTE]
|
|
|
|
|
> **UPDATES FOR THIS REPOSITORY HAS BEEN RESTORED. AS USUAL, CHANGES WILL BE PUSHED EVERY MONDAY, WEDNESDAY, AND FRIDAY. ENJOY!**
|
|
|
|
|
|
|
|
|
|
Filter lists prepared for use with AdGuard Home.
|
|
|
|
|
This repository contains filter lists specifically prepared for use with the AdGuard Home DNS filtering system.
|
|
|
|
|
|
|
|
|
|
All the lists are generated automatically with the script and use other sources supported by their autors and contributors.
|
|
|
|
|
If you see any error in the list (like disabled valid URL, banned legitimate service, etc.) please create issue in the Steven's repo (https://github.com/StevenBlack/hosts). Due to the automatic nature of the AdGuard Home lists generation, I do not correct these lists manually. All changes appled to the source hosts files by their authors to be reflected in AdGuard Home filter lists.
|
|
|
|
|
## Sources
|
|
|
|
|
|
|
|
|
|
Please also remember, that it is possible to create your own local filter with `important` markers and override any incorrect or unnecessary filters defined in lists from this repo.
|
|
|
|
|
**StevenBlack's repository**: includes filters for Adware+Malware, FakeNews, Gambling, Social, and more.
|
|
|
|
|
|
|
|
|
|
Use AdGuard Simplified Domain Names filter as a primary source for your AdGuard home.
|
|
|
|
|
**Schakal's repository**: includes RU AdList+EasyList.<br><br>
|
|
|
|
|
|
|
|
|
|
## Sources:
|
|
|
|
|
All filter lists in this repository are automatically generated using a script that incorporates sources supported by their respective authors and contributors. These lists are cleaned and reformatted from the `hosts` file format as follows:
|
|
|
|
|
* removed unnecessary lines (e.g., "local/localhost/broadcast/etc.");
|
|
|
|
|
* cleaned of IPv4 and IPv6 addresses as specified in RFC952;
|
|
|
|
|
* replaced `127.0.0.1` and `0.0.0.`0 with `||` to match AdGuard Home’s subdomain-blocking logic;
|
|
|
|
|
* maintained separate extension files for independent use (e.g., Fake News, Social, Gambling, etc.);
|
|
|
|
|
* removed subdomains if the top-level domain is already listed, as AdGuard blocks all subdomains automatically;
|
|
|
|
|
* fully blocked adult-related TLDs;
|
|
|
|
|
* improved domain lists with additional enhancements;
|
|
|
|
|
* combined RU AdList+EasyList with StevenBlack's Adware+Malware file, removing all duplicates;
|
|
|
|
|
* compared all files with AdGuard’s Simplified Domain Names filter to ensure deduplication.
|
|
|
|
|
|
|
|
|
|
1. StevenBlack repo (https://github.com/StevenBlack/hosts)
|
|
|
|
|
2. RuAdList + EasyList repo by Schakal (https://schakal.ru/hosts/alive_hosts.txt)
|
|
|
|
|
## Important notes
|
|
|
|
|
|
|
|
|
|
All filter lists are cleaned up and re-formatted from the 'hosts' file format:
|
|
|
|
|
* cleaned-up from "local/localhost/broadcast/etc." lines;
|
|
|
|
|
* cleaned-up from IPv4 and IPv6 addresses only as per RFC952;
|
|
|
|
|
* 127.0.0.1 and 0.0.0.0 are replaced to || (any sub-domains, supported by AdGuard Home);
|
|
|
|
|
* extensions files are left unmerged for independent use (fakenews, social, gambling etc.);
|
|
|
|
|
* all sub-domains are removed if upper-level domain is in the list. AdGuard will block all sub-domains;
|
|
|
|
|
* adult TLDs are fully blocked;
|
|
|
|
|
* some improvements added to domains lists;
|
|
|
|
|
* RuAdList file added to StevenBlack's Adware+Malware file, all duplicates removed;
|
|
|
|
|
* all files from this repo compared with AdGuard Simplified Domain Names filter, and duplicates removed.
|
|
|
|
|
Please ensure that you add the AdGuard Simplified Domain Names filter as a primary source in your AdGuard Home setup.
|
|
|
|
|
|
|
|
|
|
Files are compatible with AdGuard Home DNS filtering system.
|
|
|
|
|
If legitimate domains are mistakenly blocked using these filter lists, it is likely due to their inclusion in the source repositories (StevenBlack or Schakal). If you believe such domains should be excluded, please review the respective source repositories and open an issue there.
|
|
|
|
|
|
|
|
|
|
Due to the automated nature of the list generation, no manual corrections are made to these filter lists. Any changes made by the original authors to their source files will automatically reflect in the generated AdGuard Home filter lists.
|
|
|
|
|
|
|
|
|
|
As a workaround, you can always unblock domains locally via the AdGuard Home GUI.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Useful links
|
|
|
|
|
|
|
|
|
|
* [StevenBlack's repository on GitHub](https://github.com/StevenBlack "StevenBlack's repository on GitHub")
|
|
|
|
|
* [Schakal's HOSTS file](https://schakal.ru/hosts/alive_hosts.txt "Schakal's HOSTS file")
|
|
|
|
|
* [Schakal's post about the repo](https://4pda.to/forum/index.php?showtopic=275091&st=7980#entry89665467)
|
|
|
|
|
|
alexsannikov
1 month ago