Repolode
0xERR0R

0xERR0R/blocky

Um proxy DNS rápido e leve que bloqueia anúncios e rastreadores em toda a rede local, com regras por grupo de clientes.

Alternativa open source a:Pi-hole

Estrelas
7,053
Forks
316
Issues abertas
63
Último commit
anteontem

O que é?

Blocky é um proxy DNS e bloqueador de anúncios escrito em Go para redes locais. Ele filtra consultas DNS usando listas externas de bloqueio e permissão e permite definir listas e resolvedores upstream diferentes para cada grupo de clientes, como os dispositivos das crianças ou equipamentos de casa inteligente. O bloqueio pode ser aplicado ao domínio solicitado, aos registros CNAME na resposta ou aos endereços IP da resposta.

Além da filtragem, o Blocky também pode funcionar como um resolvedor DNS geral. Ele oferece suporte a mapeamentos DNS personalizados para domínios específicos, encaminhamento condicional para servidores externos, além de cache e prefetch para acelerar consultas repetidas. Aceita consultas por UDP, TCP, DoH, DoT, DoQ e DoH3 e pode validar DNSSEC nas respostas dos servidores upstream.

A configuração é feita com arquivos YAML, e o serviço não mantém estado nem exige banco de dados por padrão. Os logs de consultas podem ser gravados em CSV ou enviados para MySQL, MariaDB, PostgreSQL ou Timescale. O Blocky expõe métricas do Prometheus, endpoints da REST API e uma CLI, e é distribuído como um único binário e uma imagem Docker multi-arquitetura para dispositivos x86-64, ARM e MIPS.

Recursos principais

  • 01Bloqueio de anúncios e malware com listas externas de bloqueio e permissão, incluindo regras regex
  • 02Listas e resolvedores upstream por grupo de clientes
  • 03Resolução DNS personalizada e encaminhamento condicional
  • 04Cache de respostas e prefetch de consultas frequentes
  • 05Suporte a DNS por UDP, TCP, HTTPS, TLS, QUIC e HTTP/3
  • 06Métricas do Prometheus, dashboards do Grafana e logs de consultas em CSV ou bancos de dados SQL

Casos de uso

  • Bloquear anúncios e rastreadores em toda a rede doméstica sem instalar software em cada dispositivo
  • Aplicar uma filtragem mais rigorosa aos dispositivos das crianças usando um grupo de clientes separado
  • Executar um resolvedor DNS privado em um Raspberry Pi ou roteador OpenWrt
  • Monitorar padrões de consultas DNS com Prometheus e Grafana em um homelab

Início rápido

  1. 1

    Leia o capítulo de instalação da documentação completa

  2. 2

    Execute a imagem Docker indicada na documentação do README (guia de instalação)

Antes de usar

  • É necessário configurar um DNS hospedado por você na sua rede, o que exige algum esforço de configuração.
  • O suporte ao projeto é prestado principalmente por uma única pessoa mantenedora no tempo livre.

Em coleções

Tópicos

Perguntas frequentes

O que é blocky?
Um proxy DNS rápido e leve que bloqueia anúncios e rastreadores em toda a rede local, com regras por grupo de clientes. Blocky é um proxy DNS e bloqueador de anúncios escrito em Go para redes locais. Ele filtra consultas DNS usando listas externas de bloqueio e permissão e permite definir listas e resolvedores upstream diferentes para cada grupo de clientes, como os dispositivos das crianças ou equipamentos de casa inteligente. O bloqueio pode ser aplicado ao domínio solicitado, aos registros CNAME na resposta ou aos endereços IP da resposta.
blocky é gratuito? Qual é a licença?
blocky é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
blocky ainda é mantido?
Manutenção ativa. O último commit de blocky foi em 23 de out. de 2026.
Para que posso usar blocky?
Bloquear anúncios e rastreadores em toda a rede doméstica sem instalar software em cada dispositivo Aplicar uma filtragem mais rigorosa aos dispositivos das crianças usando um grupo de clientes separado Executar um resolvedor DNS privado em um Raspberry Pi ou roteador OpenWrt Monitorar padrões de consultas DNS com Prometheus e Grafana em um homelab
Como instalar blocky?
Leia o capítulo de instalação da documentação completa Execute a imagem Docker indicada na documentação do README (guia de instalação)
Onde consigo blocky?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/0xERR0R/blocky

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados