adblock-lean

adblock-lean is a super simple and lightweight adblocking solution that leverages the major rewrite of the DNS server and domain handling code associated with dnsmasq 2.86 that drastically improves performance and reduces memory foot-print, facilitating the use of very large blocklists for even older, low performance devices.

adblock-lean was originally designed primarily for use with the dnsmasq variants of the popular hagezi and oisd blocklists used by major adblockers and which are intended to block ads without interfering with normal use.

adblock-lean is written as a service and 'service adblock-lean start' will download and setup dnsmasq with a new blocklist file. Various checks are performed and, in dependence upon the outcome of those checks, the script will either: accept the new blocklist file; fallback to a previous blocklist file if available; or restart dnsmasq with no blocklist file.

adblock-lean includes, inter alia, the following features:

support for local blocklist and one or more blocklists to be downloaded from urls suport for local allowlist check individual blocklist file parts and total blocklist size do not exceeed configurable maximum file sizes generate blocklist file from local blocklist and allowlist and the one or more downloaded blocklist file part(s) check for rogue entries in blocklist file parts (e.g. check for redirection to specific IP) check good lines in blocklist file exceeds configurable minimum (default: 100,000) set up dnsmasq with new blocklist file and save any previous blocklist file as compressed file supports blocklist compression by leveraging the new conf-script functionality of dnsmasq perform checks on restarted dnsmasq with new blocklist file revert to previous blocklist file if checks fail if checks on previous blocklist file also fail then revert to not using any blocklist file user-configurable calls on success or failure automatically check for any updates and self update functionality