anti-AD/README.md
2019-12-21 23:40:07 +08:00

58 lines
3.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# anti-AD v4
##### anti-AD是综合著名广告过滤列表的高效广告屏蔽、隐私保护工具。能主动探测域名支持国内外广告分开屏蔽现已支持AdGuardHomednsmasq SurgePi-Hole等优秀的网络组件。
#### v4.0 (2019.12.14)
- 开始支持主动探测无效域名进一步降低最终生成文件位于dist目录的体积提升命中率
- 开始支持dnsmasqeasylistsurge等多种格式
- 分离出国内域名的精简配置(`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/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/anti-ad-easylist.txt))
3. 点击确认后即生效
### 3. Pi-Hole
1. 进入Pi-Hole的配置界面
2. 添加 `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/anti-ad-easylist.txt)) 作为新的过滤器
3. 保存后生效
## jsDelivr镜像
感谢 [@rufengsuixing](https://github.com/rufengsuixing) 的建议
1. `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/gh/privacy-protection-tools/anti-AD@master/anti-ad-easylist.txt
3. `anti-ad-surge.txt`: https://cdn.jsdelivr.net/gh/privacy-protection-tools/anti-AD@master/anti-ad-surge.txt
## 个性化
运行start.sh,会去下载easylist,yhosts,neohosts,cjxlist等其他大神维护的屏蔽列表然后整理合并成一个文件。拿着这个文件放入到例如/etc/dnsmasq.d/的目录下然后重启dnsmasq进程就能加载。更新依赖于其他大神的内容更新了。
* `adblock-for-dnsmasq.conf` - 这个是最终生成的配置文件大约每月更新4次,所以如果你打算直接下载我维护的这个文件不需要太高的pull频率
* `make-addr.php` - 是php脚本的主文件,执行php make-addr.php将更新配置文件
* `lib/black_domain_list.php` - 是用来配置域名黑名单,这个威力巨大,谨慎使用
* `lib/white_domain_list.php` - 白名单,优先级低于黑名单,即一个域名同时出现在黑白名单中时,将采用黑名单规则
## 欢迎提意见
对于本工具大家伙儿有任何建议或者存在误杀bug其他错误各种意见 [请开issue](https://github.com/gentlyxu/anti-AD/issues/new)
## 特别感谢
- [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