jandieman/adguardhome-filters
1
0
Fork 0
mirror of https://github.com/alexsannikov/adguardhome-filters.git synced 2025-02-21 04:39:04 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update README.md

Browse Source
This commit is contained in:
alexsannikov 2025-01-17 15:58:18 -05:00 committed by GitHub
parent fd84a9f640
commit 46f58308e2
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 26 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

46
README.md
View File

@ -1,33 +1,39 @@
# adguardhome-filters
> [!NOTE]
> **UPDATES FOR THIS REPOSITORY ARE RESTORED. AS USUAL, CHANGES WILL BE PUSHED EVERY MON, TUE, FRI. ENJOY!**
> **UPDATES FOR THIS REPOSITORY HAS BEEN RESTORED. AS USUAL, CHANGES WILL BE PUSHED EVERY MONDAY, WEDNESDAY, AND FRIDAY. ENJOY!**
Filter lists are prepared for use with AdGuard Home DNS filtering system.
This repository contains filter lists specifically prepared for use with the AdGuard Home DNS filtering system.
## Sources:
## Sources
1. StevenBlack's repository (Adware+Malware, Fakenews, Gambling, Social etc.)
2. Schakal's repository (RU AdList+EasyList)
**StevenBlack's repository**: includes filters for Adware+Malware, FakeNews, Gambling, Social, and more.
All filter lists in this repo are generated automatically with the script using sources supported by their autors and contributors.
Files 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, this is supported by AdGuard Home logic);
* 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 automatically;
* adult TLDs are fully blocked;
* some improvements added to domains lists;
* RU AdList+Easylist file added to StevenBlack's Adware+Malware file, all duplicates removed;
* all files from this repo compared with AdGuard Simplified Domain Names filter, and de-duplicated.
**Schakal's repository**: includes RU AdList+EasyList.<br><br>
Please don't forget to add AdGuard Simplified Domain Names filter as a primary source into your AdGuard Home.
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.
If legitimate domain names are banned with these lists, it may be because StevenBlack's repo or Schakal's repo included them into their sources. In this case if you think they must be excluded, please check these repos and open the issue. Due to the automatic nature of the AdGuard Home filter lists generation, I do not correct these lists manually. All changes applied to the source hosts files by their authors to be reflected in AdGuard Home filter lists.
As a workaround, please remember that you can always unblock any domain locally from the AdGuard home GUI.
## Important notes
## Links:
Please ensure that you add the AdGuard Simplified Domain Names filter as a primary source in your AdGuard Home setup.
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")