January 10, 2021
Man Page: man.txt
Beta Snapshots: beta
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.
Thanks to Sean Davies for his numerous code and manpage improvements. Thanks for the all the diffs!
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 on pretty much any Unix-like OS that has Unbound available.
Q-4: How do I check unbound-adblock's status?
A-4: By default, unbound-adblock sends all log messages to syslog and also prints them to stderr. A copy of the two most recently generated blocklists are stored within '/var/log/unbound-adblock'. These behaviors can be modified using commandline options.
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 main 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.