https://github.com/0xERR0R/blocky
Fast and lightweight DNS proxy as ad-blocker for local network with many features
https://github.com/0xERR0R/blocky
ad-blocker adblock adblocker dns dns-over-https dns-server golang parental-control pihole self-hosted selfhosted
Last synced: about 2 months ago
JSON representation
Fast and lightweight DNS proxy as ad-blocker for local network with many features
- Host: GitHub
- URL: https://github.com/0xERR0R/blocky
- Owner: 0xERR0R
- License: apache-2.0
- Created: 2019-11-06T09:03:31.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2024-10-28T04:09:39.000Z (6 months ago)
- Last Synced: 2024-10-29T10:45:50.530Z (6 months ago)
- Topics: ad-blocker, adblock, adblocker, dns, dns-over-https, dns-server, golang, parental-control, pihole, self-hosted, selfhosted
- Language: Go
- Homepage: https://0xERR0R.github.io/blocky/
- Size: 13.8 MB
- Stars: 4,714
- Watchers: 36
- Forks: 208
- Open Issues: 79
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- my-awesome-github-stars - 0xERR0R/blocky - Fast and lightweight DNS proxy as ad-blocker for local network with many features (Go)
- awesome-rainmana - 0xERR0R/blocky - Fast and lightweight DNS proxy as ad-blocker for local network with many features (Go)
- my-awesome - 0xERR0R/blocky - blocker,adblock,adblocker,dns,dns-over-https,dns-server,golang,parental-control,pihole,self-hosted,selfhosted pushed_at:2025-04 star:5.2k fork:0.2k Fast and lightweight DNS proxy as ad-blocker for local network with many features (Go)
- go-awesome - blocky - Block ads as LAN DNS proxy (Open source library / The Internet)
- awesome-go-extra - blocky - blocker for local network with many features|1774|101|35|2019-11-06T09:03:31Z|2022-08-25T19:58:05Z| (Go Tools / Other Software)
- awesome-go - blocky - Fast and lightweight DNS proxy as ad-blocker for local network with many features. Stars:`5.2K`. (Software Packages / Other Software)
- awesome-hacking-lists - 0xERR0R/blocky - Fast and lightweight DNS proxy as ad-blocker for local network with many features (Go)
- awesome-homelab - blocky - blocker for local network with many features | (Apps / X)
- awesome-repositories - 0xERR0R/blocky - Fast and lightweight DNS proxy as ad-blocker for local network with many features (Go)
- definitive-opensource - Blocky - blocker for local network with many features | `SelfHost` | **5.3k** | (Table of Contents / AD Blocker)
README
[](https://github.com/0xERR0R/blocky/actions/workflows/makefile.yml)
[](https://github.com/0xERR0R/blocky/actions/workflows/release.yml)
[](https://github.com/0xERR0R/blocky/releases)
[](https://github.com/0xERR0R/blocky/releases)
[](#)
[](https://hub.docker.com/r/spx01/blocky)
[](https://hub.docker.com/r/spx01/blocky)
[](https://codecov.io/gh/0xERR0R/blocky)
[](#)
[](https://goreportcard.com/report/github.com/0xERR0R/blocky)
[](https://ko-fi.com/0xerr0r)
![]()
# Blocky
Blocky is a DNS proxy and ad-blocker for the local network written in Go with following features:
## Features
- **Blocking** - Blocking of DNS queries with external lists (Ad-block, malware) and allowlisting
- Definition of allow/denylists per client group (Kids, Smart home devices, etc.)
- Periodical reload of external allow/denylists
- Regex support
- Blocking of request domain, response CNAME (deep CNAME inspection) and response IP addresses (against IP lists)- **Advanced DNS configuration** - not just an ad-blocker
- Custom DNS resolution for certain domain names
- Conditional forwarding to external DNS server
- Upstream resolvers can be defined per client group- **Performance** - Improves speed and performance in your network
- Customizable caching of DNS answers for queries -> improves DNS resolution speed and reduces amount of external DNS
queries
- Prefetching and caching of often used queries
- Using multiple external resolver simultaneously
- Low memory footprint- **Various Protocols** - Supports modern DNS protocols
- DNS over UDP and TCP
- DNS over HTTPS (aka DoH)
- DNS over TLS (aka DoT)- **Security and Privacy** - Secure communication
- Supports modern DNS extensions: DNSSEC, eDNS, ...
- Free configurable blocking lists - no hidden filtering etc.
- Provides DoH Endpoint
- Uses random upstream resolvers from the configuration - increases your privacy through the distribution of your DNS
traffic over multiple provider
- Blocky does **NOT** collect any user data, telemetry, statistics etc.- **Integration** - various integration
- [Prometheus](https://prometheus.io/) metrics
- Prepared [Grafana](https://grafana.com/) dashboards (Prometheus and database)
- Logging of DNS queries per day / per client in CSV format or MySQL/MariaDB/PostgreSQL/Timescale database - easy to
analyze
- Various REST API endpoints
- CLI tool- **Simple configuration** - single or multiple configuration files in YAML format
- Simple to maintain
- Simple to backup- **Simple installation/configuration** - blocky was designed for simple installation
- Stateless (no database, no temporary files)
- Docker image with Multi-arch support
- Single binary
- Supports x86-64 and ARM architectures -> runs fine on Raspberry PI
- Community supported Helm chart for k8s deployment## Quick start
You can jump to [Installation](https://0xerr0r.github.io/blocky/latest/installation/) chapter in the documentation.
## Full documentation
You can find full documentation and configuration examples
at: [https://0xERR0R.github.io/blocky/](https://0xERR0R.github.io/blocky/)## Contribution
Issues, feature suggestions and pull requests are welcome!
[](https://ko-fi.com/G2G25XZQG)