Ad blocking

RaspAP has introduced a new DNS based filter to stop ads, trackers, malware and other undesirable hosts in their tracks.

In the best of times, ads are usually just annoying. When access to online services served by our AP is hampered by ads, malware and trackers, the best tool in our arsenal is DNS blacklisting. RaspAP already uses 

dnsmasq

 to manage both DHCP and DNS, so we have the foundation for a highly effective ad blocking facility.

--- Quick installer ---

To install ad blocking with DNS blacklists, simply respond with Y or press Enter when prompted by the installer:



The installer will download the blocklists, configure RaspAP to use them and enable the Ad blocking management page.



Ad blocking is enabled and active for clients connected to your AP. You may update the blocklists or disable ad blocking with the management page. These actions are described below.

--- Manual installation ---

Ad blocking may also be installed manually. Refer to the detailed installation steps.

--- Blocklist sources ---

Blocklists are sourced from multiple, continuously updated open source projects. These are divided into two groups: hosts and domain blocklists. By default, RaspAP's ad block facility uses StevenBlack's hosts as the primary hosts blocklist. This repository is a hosts file aggregator that consolidates several reputable hosts files and merges them into a unified, optimized hosts file with duplicates removed.



Alternatively, users may choose from a number of host blocklist sources maintained by the badmojr/1Hosts GitHub project. These lists are compiled daily into Mini, Lite, Pro and Xtra versions depending on specific user needs. Refer to the GitHub project for an explanation of these different blocklists.

In addition to blocking hosts, domain blocking gives us the ability to use wildcards with 

dnsmasq

 to block an entire domain (for example, 

baddomain.org

) with a single rule. This includes all known and unknown subdomains, such as 

*.baddomain.org

. Domain blocklists are provided by the OISD project. Similar to hosts lists, these are continuously updated and curated into several lists: Small, Big and NSFW. Refer to the OISD project for an explanation of these lists.

--- Updating lists ---

Each of the hosts and domains blocklists 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.



Next to the update button, a gear icon will appear to indicate that the selected list is being downloaded. Thereafter, a timestamp after each list will indicate when it was last updated.

Note To apply the latest blocklists, be sure to Restart Ad Blocking.

---- Automatic updates ----

Alternatively, you may wish to automate the process of keeping the ad block source lists up-to-date. A method to achieve this is described in this FAQ.

--- Custom blocklist ---

In addition to the notracking blocklists, you may create your own host blocklist by adding entries on the Custom blocklist tab. Define custom hosts to be blocked by entering an IPv4 or IPv6 address followed by any whitespace (spaces or tabs) and the host name. An IPv4 example would take the form 

0.0.0.0 badhost.com

. Choose Save settings and Restart Ad Blocking.

Note

As the name suggests, this is effective at blocking individual hosts, but not entire domains (or subdomains).

--- Enabling logging ---

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.



--- Disabling ad block ---

To disable the ad blocking service, slide the Enable blocklists toggle to its off position, then choose Save settings. You may then restart your hotspot for the changes to take effect.

--- About blocklist policies ---

The blocklist sources chosen for RaspAP adhere to these policies:

• Should not break useful websites or apps
• Blocks tracking servers
• Blocks advertising servers
• Blocks analytics servers
• Blocks scam websites
• Blocks malware servers
• Blocks webminers
• Blocks phishing servers

Users may tailor RaspAP's ad blocking to suit their needs by selecting from multiple blocklist sources. Furthermore, domain blocklists enable full use of domain name based wildcard filtering (for example, 

*.baddomain.org

). This reduces the chance of missing any new subdomains and significantly reduces the size of the blocklists.