{"id":15019092,"url":"https://github.com/0xerr0r/blocky","last_synced_at":"2026-02-27T17:50:04.180Z","repository":{"id":37426941,"uuid":"219954477","full_name":"0xERR0R/blocky","owner":"0xERR0R","description":"Fast and lightweight DNS proxy as ad-blocker for local network with many features","archived":false,"fork":false,"pushed_at":"2025-05-08T04:44:52.000Z","size":15129,"stargazers_count":5313,"open_issues_count":86,"forks_count":236,"subscribers_count":38,"default_branch":"main","last_synced_at":"2025-05-08T20:57:20.076Z","etag":null,"topics":["ad-blocker","adblock","adblocker","dns","dns-over-https","dns-server","golang","parental-control","pihole","self-hosted","selfhosted"],"latest_commit_sha":null,"homepage":"https://0xERR0R.github.io/blocky/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/0xERR0R.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"0xERR0R","ko_fi":"0xerr0r","custom":["paypal.me/spx01"]}},"created_at":"2019-11-06T09:03:31.000Z","updated_at":"2025-05-07T05:19:21.000Z","dependencies_parsed_at":"2023-10-02T08:02:05.308Z","dependency_job_id":"6d2536fc-2e2f-4c09-8255-b533dff7a221","html_url":"https://github.com/0xERR0R/blocky","commit_stats":{"total_commits":1363,"total_committers":63,"mean_commits":"21.634920634920636","dds":0.6793837123991195,"last_synced_commit":"0dff6f1adfb79c7dc150a70bf505cb0a6bb8c2fe"},"previous_names":[],"tags_count":27,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xERR0R%2Fblocky","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xERR0R%2Fblocky/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xERR0R%2Fblocky/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xERR0R%2Fblocky/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/0xERR0R","download_url":"https://codeload.github.com/0xERR0R/blocky/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253157418,"owners_count":21863119,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ad-blocker","adblock","adblocker","dns","dns-over-https","dns-server","golang","parental-control","pihole","self-hosted","selfhosted"],"created_at":"2024-09-24T19:52:58.409Z","updated_at":"2026-02-27T17:50:04.161Z","avatar_url":"https://github.com/0xERR0R.png","language":"Go","funding_links":["https://github.com/sponsors/0xERR0R","https://ko-fi.com/0xerr0r","paypal.me/spx01","https://ko-fi.com/G2G25XZQG"],"categories":[],"sub_categories":[],"readme":"[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/0xERR0R/blocky/makefile.yml \"Make\")](https://github.com/0xERR0R/blocky/actions/workflows/makefile.yml)\n[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/0xERR0R/blocky/release.yml \"Release\")](https://github.com/0xERR0R/blocky/actions/workflows/release.yml)\n[![GitHub latest version](https://img.shields.io/github/v/release/0xERR0R/blocky \"Latest version\")](https://github.com/0xERR0R/blocky/releases)\n[![GitHub Release Date](https://img.shields.io/github/release-date/0xERR0R/blocky \"Latest release date\")](https://github.com/0xERR0R/blocky/releases)\n[![GitHub go.mod Go version](https://img.shields.io/github/go-mod/go-version/0xERR0R/blocky \"Go version\")](#)\n[![Docker pulls](https://img.shields.io/docker/pulls/spx01/blocky \"Latest version\")](https://hub.docker.com/r/spx01/blocky)\n[![Docker Image Size (latest)](https://img.shields.io/docker/image-size/spx01/blocky/latest)](https://hub.docker.com/r/spx01/blocky)\n[![Codecov](https://img.shields.io/codecov/c/gh/0xERR0R/blocky \"Code coverage\")](https://codecov.io/gh/0xERR0R/blocky)\n[![Codacy grade](https://img.shields.io/codacy/grade/8fcd8f8420b8419c808c47af58ed9282 \"Codacy grade\")](#)\n[![Go Report Card](https://goreportcard.com/badge/github.com/0xERR0R/blocky)](https://goreportcard.com/report/github.com/0xERR0R/blocky)\n[![Donation](https://img.shields.io/badge/buy%20me%20a%20coffee-donate-blueviolet.svg)](https://ko-fi.com/0xerr0r)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg height=\"200\" src=\"https://github.com/0xERR0R/blocky/blob/main/docs/blocky.svg\"\u003e\n\u003c/p\u003e\n\n# Blocky\n\nBlocky is a DNS proxy and ad-blocker for the local network written in Go with following features:\n\n## Features\n\n- **Blocking** - Blocking of DNS queries with external lists (Ad-block, malware) and allowlisting\n\n  - Definition of allow/denylists per client group (Kids, Smart home devices, etc.)\n  - Periodical reload of external allow/denylists\n  - Regex support\n  - Blocking of request domain, response CNAME (deep CNAME inspection) and response IP addresses (against IP lists)\n\n- **Advanced DNS configuration** - not just an ad-blocker\n\n  - Custom DNS resolution for certain domain names\n  - Conditional forwarding to external DNS server\n  - Upstream resolvers can be defined per client group\n\n- **Performance** - Improves speed and performance in your network\n\n  - Customizable caching of DNS answers for queries -\u003e improves DNS resolution speed and reduces amount of external DNS\n    queries\n  - Prefetching and caching of often used queries\n  - Using multiple external resolver simultaneously\n  - Low memory footprint\n\n- **Various Protocols** - Supports modern DNS protocols\n\n  - DNS over UDP and TCP\n  - DNS over HTTPS (aka DoH)\n  - DNS over TLS (aka DoT)\n\n- **Security and Privacy** - Secure communication\n\n  - Supports modern DNS extensions: DNSSEC, eDNS, ...\n  - DNSSEC validation of upstream resolvers\n  - Free configurable blocking lists - no hidden filtering etc.\n  - Provides DoH Endpoint\n  - Uses random upstream resolvers from the configuration - increases your privacy through the distribution of your DNS\n    traffic over multiple provider\n  - Blocky does **NOT** collect any user data, telemetry, statistics etc.\n\n- **Integration** - various integration\n\n  - [Prometheus](https://prometheus.io/) metrics\n  - Prepared [Grafana](https://grafana.com/) dashboards (Prometheus and database)\n  - Logging of DNS queries per day / per client in CSV format or MySQL/MariaDB/PostgreSQL/Timescale database - easy to\n    analyze\n  - Various REST API endpoints\n  - CLI tool\n\n- **Simple configuration** - single or multiple configuration files in YAML format\n\n  - Simple to maintain\n  - Simple to backup\n\n- **Simple installation/configuration** - blocky was designed for simple installation\n\n  - Stateless (no database, no temporary files)\n  - Docker image with Multi-arch support\n  - Single binary\n  - Supports x86-64 and ARM architectures -\u003e runs fine on Raspberry PI\n  - Community supported Helm chart for k8s deployment\n\n## Quick start\n\nYou can jump to [Installation](https://0xerr0r.github.io/blocky/latest/installation/) chapter in the documentation.\n\n## Full documentation\n\nYou can find full documentation and configuration examples\nat: [https://0xERR0R.github.io/blocky/](https://0xERR0R.github.io/blocky/)\n\n## Contribution\n\nIssues, feature suggestions and pull requests are welcome!\n\n[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/G2G25XZQG)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xerr0r%2Fblocky","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F0xerr0r%2Fblocky","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xerr0r%2Fblocky/lists"}