diff --git a/README.md b/README.md index 5897c24f..45e3d8f5 100644 --- a/README.md +++ b/README.md @@ -6,6 +6,19 @@ 本工具是通过域名解析层来屏蔽广告和保护隐私的，其将各大著名的hosts，ad filter lists，adblock list等的列表进行合并去重，再进行一系列的抽象化，例如主动剔除失效域名、easylist优化模糊匹配、增强的黑白名单机制等措施，最终生成期望的高命中率列表。 +![dist](https://github.com/privacy-protection-tools/anti-AD/workflows/sync%20list%20to%20dist/badge.svg) + +## 快速使用 + +| 文件 | raw链接 | jsDelivr | 操作参考 | 适用于 | +|:-------------------------- |:-------: |:--------: |:------------------------------------------------------------------------------------------------------------------------------------------- |:--------------------------------------------- | +| `adblock-for-dnsmasq.conf` | [raw链接](https://raw.githubusercontent.com/privacy-protection-tools/anti-AD/master/adblock-for-dnsmasq.conf) | [jsDelivr](https://cdn.jsdelivr.net/gh/privacy-protection-tools/anti-AD@master/adblock-for-dnsmasq.conf) | 1. 下载过滤列表文件后, 保存到你的dnsmasq配置的正确目录下；
2. 重启dnsmasq服务；
3. 已经生效了，enjoy it。 | dnsmasq及其衍生版本 | +| `anti-ad-easylist.txt` | [raw链接](https://raw.githubusercontent.com/privacy-protection-tools/anti-AD/master/anti-ad-easylist.txt) | [jsDelivr](https://cdn.jsdelivr.net/gh/privacy-protection-tools/anti-AD@master/anti-ad-easylist.txt) | 1. 进入AdGuardHome过滤器页面；
2. 选择添加过滤器输入名称 anti-AD，url地址填raw链接或者jsDelivr；
3. 点击确认后即生效 | AdGuardHome | +| `anti-ad-domains.txt` | [raw链接](https://raw.githubusercontent.com/privacy-protection-tools/anti-AD/master/anti-ad-domains.txt) | [jsDelivr](https://cdn.jsdelivr.net/gh/privacy-protection-tools/anti-AD@master/anti-ad-domains.txt) | 以Pi-Hole为例
1. 进入pi-hole设置界面
2. 添加本domains列表链接到pi-hole的过滤器列表中
3. 点击save & update
4. 更新成功后即可生效 | Pi-Hole以及任何支持
域名过滤列表的工具。 | +| `anti-ad-surge.txt` | [raw链接](https://raw.githubusercontent.com/privacy-protection-tools/anti-AD/master/anti-ad-surge.txt) | [jsDelivr](https://cdn.jsdelivr.net/gh/privacy-protection-tools/anti-AD@master/anti-ad-surge.txt) | 直接订阅本条链接，保存后生效 | Surge或任何支持解析该
格式的广告过滤工具。 | + +## 版本历史 + #### v4.3 (2020.02.04) - 引入无效域名、无效hosts剔除机制，大幅提升各过滤列表命中率 @@ -21,63 +34,18 @@ - 开始引入官网，逐步建设完善 - 修复一些逻辑bug -#### v4.2.1 (2020.01.19) +#### [更多版本演进历史>>>](https://github.com/privacy-protection-tools/anti-AD/blob/master/changelog.md) -- 增加对恶意挖矿域名列表的屏蔽 -- 引入严格模式，对恶意挖矿程序屏蔽时，默认屏蔽其主域名，例如www.baidu.com,严格模式启用时屏蔽baidu.com及其所有子域名 -- 修复.cn域名匹配中发现的bug -- 一些正则表达式规则的进一步提取优化 - - -#### v4.2 (2020.01.16) - -- easylist支持正则表达式语法 -- easylist白名单机制增强 - -#### v4.1 (2019.12.24) - -- easylist支持通配符匹配域名 -- easylist引入白名单赦免机制 - -#### v4.0 (2019.12.14) - -- 开始支持主动探测无效域名，进一步降低最终生成文件（位于dist目录）的体积，提升命中率 -- 开始支持dnsmasq，easylist，surge等多种格式 -- 分离出国内域名的精简配置(`dist/*-basic.*`)和优化后的完整配置(`dist/*-full.*`)，可以根据需求选择屏蔽等级 -- 代码重构，工程化，分离class，分离工具，逻辑更清晰 - -## 快速使用 - -### 1. dnsmasq -1. 下载[adblock-for-dnsmasq.conf](https://raw.githubusercontent.com/privacy-protection-tools/anti-AD/master/adblock-for-dnsmasq.conf) ([jsDelivr加速](https://cdn.jsdelivr.net/gh/privacy-protection-tools/anti-AD@master/adblock-for-dnsmasq.conf)), 保存到你的dnsmasq配置的正确目录下； -2. 重启dnsmasq服务； -3. 已经生效了，enjoy it！ - -### 2. AdGuardHome -1. 进入AdGuardHome过滤器页面，选择添加过滤器 -2. 输入名称 `anti-AD`，url地址：`https://raw.githubusercontent.com/privacy-protection-tools/anti-AD/master/anti-ad-easylist.txt`([jsDelivr加速](https://cdn.jsdelivr.net/gh/privacy-protection-tools/anti-AD@master/anti-ad-easylist.txt)) -3. 点击确认后即生效 - -### 3. Pi-Hole -1. 进入Pi-Hole的配置界面 -2. 添加 `https://raw.githubusercontent.com/privacy-protection-tools/anti-AD/master/anti-ad-domains.txt`([jsDelivr加速](https://cdn.jsdelivr.net/gh/privacy-protection-tools/anti-AD@master/anti-ad-domains.txt)) 作为新的过滤器 -3. 保存后生效 - -## jsDelivr镜像加速 - -_感谢 [@rufengsuixing](https://github.com/rufengsuixing) 提出的优化建议_ -1. `adblock-for-dnsmasq.conf`: [https://cdn.jsdelivr.net/.../adblock-for-dnsmasq.conf](https://cdn.jsdelivr.net/gh/privacy-protection-tools/anti-AD@master/adblock-for-dnsmasq.conf) -2. `anti-ad-easylist.txt`: [https://cdn.jsdelivr.net/.../anti-ad-easylist.txt](https://cdn.jsdelivr.net/gh/privacy-protection-tools/anti-AD@master/anti-ad-easylist.txt) -3. `anti-ad-surge.txt`: [https://cdn.jsdelivr.net/.../anti-ad-surge.txt](https://cdn.jsdelivr.net/gh/privacy-protection-tools/anti-AD@master/anti-ad-surge.txt) - -## 欢迎提意见 - -对于本工具，大家伙儿有任何建议，或者存在误杀，bug，其他错误，各种意见 [请开issue](https://github.com/gentlyxu/anti-AD/issues/new) +## 欢迎提issue +对于anti-AD，大家伙儿有任何建议，或者存在误杀，bug，其他错误，各种意见 [请开issue](https://github.com/privacy-protection-tools/anti-AD/issues/new/choose) ## 特别感谢 +- [notracking/hosts-blocklists-scripts](https://github.com/notracking/hosts-blocklists-scripts) - 提供无效域名和无效hosts列表 - [Adblock Plus](https://adblockplus.org/) - 畅游清爽洁净的网络！ - [neoFelhz/neohosts](https://github.com/neoFelhz/neohosts) - 自由·负责·克制 去广告 Hosts 项目 - [vokins/yhosts](https://github.com/vokins/yhosts) - yhosts - [cjx82630/cjxlist](https://github.com/cjx82630/cjxlist) - Adblock Plus EasyList Lite与CJX's Annoyance List +- _[@rufengsuixing](https://github.com/rufengsuixing) 提出的jsDelivr加速过滤列表下载的建议_ +- _[@xlighting2017](https://github.com/xlighting2017) 提供的[surge格式建议](https://github.com/privacy-protection-tools/anti-AD/issues/29)_