January 10, 2021
Man Page: man.txt
Unbound-adblock is a fast, flexible, easy to use DNS firewall utility. It allows you to block online advertisements network wide and thus block ads on devices that otherwise don't support traditional browser-based adblockers such as uBlock Origin, Adblock Plus etc. I have found unbound-adblock to boost web browsing speed and increase battery life on mobile devices.
A nice side effect of the network adblocking is that there is no added CPU utilization on the client-side device for filtering out the ads, as all the heavy lifting is done by the DNS server. For devices with limited resources, unbound-adblock can be a breath of fresh air.
Additionally, unbound-adblock blocks a large amount of online trackers, malware, fake sites, pop ups and other annoying garbage.
unbound-adblock works best when used in conjunction with pf-badhost
To receive notifications for new unbound-adblock releases, send an email to firstname.lastname@example.org with this subject line: "subscribe unbound-adblock"
If you believe my work has provided value to you, and if you have the means to, please consider donating. I'm fairly poor, so every little bit helps.
If you want to donate, but aren't able to use PayPal, please get in contact with me and we can figure out a more suitable method.
I would like to give thanks to the following people for their donations of time, resources and/or money to the project:
Thanks to Mischa Peters and OpenBSD Amsterdam for sponsoring the project! They were kind enough to offer the project free computing resources to help facilitate development and testing of unbound-adblock.
If you've written or created something related to unbound-adblock and would like to have your link listed here then please send me an email.
Q-1: How can I help the project?
A-1: You can find bugs, donate, or tell your friends about unbound-adblock.
Q-2: Will this run on Linux?
A-2: Yes, unbound-adblock should run fine on any SystemD based distro. We also support Alpine Linux. It should be fairly straightforward to add support for alternate Linux init-systems/distros. If you're trying to port unbound-adblock to another Linux distro, give me a shout, I'd be happy to lend a hand.
Q-3: How do I check unbound-adblock's status?
A-4: By default, unbound-adblock logs to '/var/log/messages' where you can see statistics from previous runs as well as any info/error messages that may have occured. A copy of the two most recently generated blocklists can be found in '/var/log/unbound-adblock'.
Additionally, most cron daemons are configured to mail the cron job results/output to the cron job owner. If you have your local mail system configured on your machine, you can configure the status reports to be forwarded to your preferred email account. Please check the documentation relevant to your system for more info, as this is beyond the scope of unbound-adblock's instuctions.
Q-4: Can't I just run this as root?
A-4: I'd tell you to stop being annoying, but you have a right to shoot yourself in the foot. You can use the '-D' option to disable UID checking.