Blocky DNS Proxy

Blocky DNS Proxy

A high-performance DNS proxy and ad-blocker supporting custom blocking rules, client grouping, deep CNAME inspection, DNS over HTTPS/TLS, and Prometheus monitoring, ideal for home networks and small business environments.

โญ6,649GitHub
Description

## Blocky - DNS Proxy and Ad-Blocker **Official Website:** https://0xERR0R.github.io/blocky/ **Repository:** https://github.com/lazycatapps/blocky.git Blocky is a DNS proxy and ad-blocker written in Go, designed for local network use with comprehensive filtering and DNS management capabilities. ## Main Features - ๐Ÿ›ก๏ธ **DNS Query Blocking**: Filter using external lists (ad-block, malware) with allowlist support - ๐Ÿ‘จโ€๐Ÿ‘ฉโ€๐Ÿ‘งโ€๐Ÿ‘ฆ **Client Groups**: Group-based filtering (e.g., Kids, Smart home devices) - ๐Ÿ” **Deep Inspection**: Block request domain, response CNAME (deep CNAME inspection) and response IP addresses - ๐ŸŽฏ **Custom Resolution**: Custom DNS resolution for specific domains - โšก **Performance**: Customizable DNS answer caching to reduce external queries - ๐Ÿ”„ **Conditional Forwarding**: Forward to external DNS servers conditionally - ๐Ÿ” **Secure Protocols**: Support for DNS over UDP/TCP, DNS over HTTPS (DoH), DNS over TLS (DoT) - ๐Ÿ”’ **DNSSEC**: DNSSEC and eDNS support - ๐Ÿ“Š **Monitoring**: Prometheus metrics and Grafana dashboards - ๐Ÿ’พ **Database Logging**: Support for MySQL, PostgreSQL, TimescaleDB - ๐Ÿš€ **Lightweight**: Stateless architecture (no database required), low memory footprint ## Usage Instructions 1. After starting the application, Blocky will automatically start and listen on UDP port 53 2. **Important:** You need to use the LAN Port Forwarder tool to map TCP & UDP port 53 from your LazyCat LAN IP to this application in order to use it as a DNS server via the LazyCat IP 3. Set your device or router's DNS server to the IP address of the host running Blocky 4. Customize blocking rules and upstream DNS servers by editing `/data/appvar/cloud.lazycat.app.liu.blocky/config/config.yml` on your LazyCat 5. Restart the application to apply configuration changes 6. Access the management interface (if configured) to view statistics and manage rules ## Configuration The configuration file is located at `/data/appvar/cloud.lazycat.app.liu.blocky/config/config.yml` on your LazyCat. You can configure: - Upstream DNS servers - Blocking lists (ads, malware, etc.) - Allowlist domains - Client group rules - Cache settings - Log level For detailed configuration instructions, please refer to: https://0xERR0R.github.io/blocky/configuration/

Screenshots
Screenshot 1
Screenshot 2
Screenshot 3
App Information
Version
0.27.0
Package Size
850.53 KB
Image Size
13.07 MB
Updated
November 5, 2025
Source Code
0xERR0R
Platform Support
PC
Keywords
blockydnsad-blockerdns-proxyadblock
Blocky DNS Proxy | SelfHost