frodovdr/raspap-webgui
1
0
Fork 0
mirror of https://github.com/billz/raspap-webgui.git synced 2023-10-10 13:37:24 +02:00
Code Issues Releases Wiki Activity

Updated Ad blocking (Beta) (markdown)

Bill Zimmerman 2020-04-03 20:01:52 +02:00
parent 8b608a4975
commit 18e4e5a147
1 changed files with 3 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
Ad-blocking-(Beta).md

@ -1,6 +1,6 @@
RaspAP is introducing a new feature to block DNS requests for ads, trackers and other undesirable hosts. This was mainly done [in response to users on lockdown](https://github.com/billz/raspap-webgui/issues/542) due to the Covid-19 pandemic who were struggling with slow internet.
In the best of times, ads are usually just annoying. When communication and access to online services is hampered by ads, the best tool in our arsenal is DNS blacklisting. RaspAP already uses `dnsmasq` to manage both DHCP and DNS, so it was fairly straightforward to use this to implement ad blocking.
In the best of times, ads are usually just annoying. When access to online services is hampered by requests for ads, the best tool in our arsenal is DNS blacklisting. RaspAP already uses `dnsmasq` to manage both DHCP and DNS, so implementing ad blocking was fairly straightforward.
## Participating in the public beta
As a beta feature, we invite testing and encourage feedback from users of RaspAP. To enable ad blocking, simply use the [installer](https://github.com/billz/raspap-webgui/wiki/Quick-Installer-usage) to (re)install RaspAP using the `--adblock` option:
@ -16,7 +16,7 @@ Answer 'Y' by pressing [Enter] to the **Configure ad blocking (Beta)** prompt. T
Manual installation steps will be forthcoming.
## Blocklist source
For the public beta release, blocklists are sourced from the [notracking project](https://github.com/notracking/hosts-blocklists) on GitHub. These lists are gathered from multiple, actively maintained sources and automatically updated, cleaned, optimized and moderated on a daily basis. A complete list of sources is available [here](https://github.com/notracking/hosts-blocklists/blob/master/SOURCES.md).
For the public beta release, blocklists are sourced from the [notracking project](https://github.com/notracking/hosts-blocklists) on GitHub. This "list of lists" is gathered from multiple, actively maintained sources and automatically updated, cleaned, optimized and moderated on a daily basis. A complete list of sources is available [here](https://github.com/notracking/hosts-blocklists/blob/master/SOURCES.md).
## Updating lists
The notracking project maintains two blocklists; hostnames and domains. These are updated daily, so it's a good practice to refresh them periodically. You can do this from the **Ad Blocking** management page in RaspAP. Simply select the list from the dropdown and choose 'Update now'.
@ -26,7 +26,7 @@ The notracking project maintains two blocklists; hostnames and domains. These ar
**Note:** to apply the latest blocklists, be sure to **Restart Ad Blocking**.
## Enabling logging
By default, DNS logging is disabled. Enable it on the **DHCP Server > Logging** tab by selecting the **Log DNS queries** toggle. **Save settings** and **Restart Ad Blocking**. The **Logging** tab on the **Ad Blocking** page will display blacklisted DNS queries with host addresses of `0.0.0.0`. A sample of blocked ad/tracker requests is below.
By default, DNS logging is disabled. If you'd like to see which hosts are being blocked, enable it on the **DHCP Server > Logging** tab by selecting the **Log DNS queries** toggle. **Save settings** and **Restart Ad Blocking**. The **Logging** tab on the **Ad Blocking** page will display blacklisted DNS queries with host addresses of `0.0.0.0`. A sample of blocked ad/tracker requests is below.
```
dnsmasq[9633]: config static.ads-twitter.com is 0.0.0.0