0xERR0R / blocky

Fast and lightweight DNS proxy as ad-blocker for local network with many features

self-hosted selfhosted golang ad-blocker adblock adblocker dns dns-over-https dns-server parental-control pihole

blocky

Blocky is a fast and lightweight DNS proxy that acts as an ad-blocker for your entire local network. It uses DNS-over-HTTPS (DoH) to resolve DNS queries and to block ads and other unwanted content. Blocky is written in Go, making it easy to run on a variety of platforms.

Blocky has a number of features that make it a great choice for ad-blocking:

Fast: Blocky is designed to be as fast as possible, so you won't notice any slowdown when browsing the web.
Lightweight: Blocky is a lightweight program that won't use up much of your system's resources.
Easy to use: Blocky is easy to set up and use, even if you're not a technical expert.
Effective: Blocky uses a comprehensive list of ad blocking filters to block even the most stubborn ads.
Open source: Blocky is open source, so you can be sure that it's safe and secure.

In addition to ad-blocking, Blocky also offers a number of other features, such as:

Parental control: Blocky can be used to block access to certain websites, such as those that contain adult content or violence.
DNS filtering: Blocky can be used to filter out specific types of DNS queries, such as those that are used for tracking or phishing.
Customizable: Blocky can be customized to meet your specific needs. You can add your own ad blocking filters, or you can use one of the many publicly available lists.

Blocky is a great choice for anyone who wants to block ads and other unwanted content from their local network. It's fast, lightweight, and easy to use, and it offers a number of powerful features.

Getting Started

To get started with Blocky, follow these steps:

Download the latest version of Blocky from the releases page.
Install Blocky on your system.
Configure Blocky to use your desired DNS-over-HTTPS provider.
Start Blocky.

Once Blocky is running, it will start blocking ads and other unwanted content from your local network. You can customize Blocky's behavior by editing the configuration file.

Configuration

Blocky can be configured to meet your specific needs. The configuration file is located at /etc/blocky/config.yaml. You can edit this file to change the following settings:

DNS-over-HTTPS provider: Blocky supports a number of different DNS-over-HTTPS providers. You can choose the provider that you prefer from the list of available providers.
Ad blocking filters: Blocky uses a comprehensive list of ad blocking filters to block even the most stubborn ads. You can add your own ad blocking filters to this list, or you can use one of the many publicly available lists.
Parental control: Blocky can be used to block access to certain websites, such as those that contain adult content or violence. You can add the websites that you want to block to the parental control list.
DNS filtering: Blocky can be used to filter out specific types of DNS queries, such as those that are used for tracking or phishing. You can add the types of DNS queries that you want to filter to the DNS filtering list.

Contributing