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.
## 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/


