AdGuardHome
v0.107.54
Grátis e de código aberto, poderosos anúncios e rastreadores em toda a rede bloqueando o servidor DNS.
Adguard.com | Wiki | Reddit | Twitter | Telegrama
O Adguard Home é um software em toda a rede para bloquear anúncios e rastreamento. Depois de configurá-lo, ele cobrirá todos os seus dispositivos domésticos e você não precisa de nenhum software do lado do cliente para isso.
Ele opera como um servidor DNS que redireciona os domínios de rastreamento para um "buraco negro", impedindo que seus dispositivos se conectem a esses servidores. É baseado no software que usamos para nossos servidores Public Adguard DNS e ambos compartilham muito código.
Começando
Instalação automatizada (Linux/Unix/MacOS/FreeBSD/OpenBSD)
Métodos alternativos
Guias
API
Comparando o Adguard Home com outras soluções
Como isso é diferente dos servidores públicos do Adguard DNS?
Como o Adguard Home se compara ao Pi-Hole
Como o Adguard Home se compara aos bloqueadores tradicionais de anúncios
Limitações conhecidas
Como construir a partir da fonte
Pré -requisitos
Prédio
Contribuindo
Teste versões instáveis
Relatando problemas
Ajuda com traduções
Outro
Projetos que usam o Adguard Home
Agradecimentos
Privacidade
Para instalar com curl execute o seguinte comando:
Curl -s -s -l https://raw.githubusercontent.com/adguardteam/adguardhome/master/scripts/install.sh | sh -s --v
Para instalar com wget execute o seguinte comando:
wget ---no-verbose -o -https://raw.githubusercontent.com/adguardteam/adguardhome/master/scripts/install.sh | sh -s --v
Para instalar com fetch execute o seguinte comando:
Fetch -o - https://raw.githubusercontent.com/adguardteam/adguardhome/master/scripts/install.sh | sh -s --v
O script também aceita algumas opções:
-c <channel> para usar o canal especificado;
-r para reinstalar o home adguard;
-u para desinstalar a casa do Adguard;
-v para saída detalhada.
Observe que as opções -r e -u são mutuamente exclusivas.
Leia o artigo de início do nosso wiki para aprender a instalar o Adguard Home manualmente e como configurar seus dispositivos para usá -lo.
Você pode usar nossa imagem oficial do Docker no Docker Hub.
Se você estiver executando o Linux, há uma maneira segura e fácil de instalar o Adguard Home: obtenha -o na loja Snap.
Veja nosso wiki.
Se você deseja se integrar ao Adguard Home, pode usar nossa API REST. Como alternativa, você pode usar este cliente Python, que é usado para criar o complemento do Adguard Home Hass.io.
Executar seu próprio servidor doméstico Adguard permite que você faça muito mais do que usar um servidor DNS público. É um nível completamente diferente. Veja por si mesmo:
Escolha o que exatamente o servidor bloqueia e permite.
Monitore sua atividade de rede.
Adicione suas próprias regras de filtragem personalizadas.
Mais importante, é o seu próprio servidor e você é o único que está no controle.
Neste ponto, o Adguard Home tem muito em comum com o buraco Pi. Os anúncios em bloco e os rastreadores usando o chamado método "DNS Sinkholing" e ambos permitem personalizar o que está bloqueado.
Observação
Não vamos parar por aqui. O DNS Sinkholing não é um ponto de partida ruim, mas este é apenas o começo.
A Adguard Home fornece muitos recursos prontos para a caixa, sem necessidade de instalar e configurar software adicional. Queremos que seja simples até o ponto, quando até usuários casuais podem configurá -lo com um esforço mínimo.
Observação
Alguns dos recursos listados podem ser adicionados ao Pi-Hole, instalando software adicional ou manualmente usando o terminal SSH e reconfigurando um dos utilidades que o buraco Pi consiste. No entanto, em nossa opinião, isso não pode ser legitimamente contado como o recurso de um buraco de Pi.
| Recurso | Adguard Home | Pi-burro |
|---|---|---|
| Bloqueando anúncios e rastreadores | ✅ | ✅ |
| Personalizando listas de bloqueios | ✅ | ✅ |
| Servidor DHCP integrado | ✅ | ✅ |
| HTTPS para a interface administrativa | ✅ | Mais ou menos, mas você precisará configurar manualmente o LightTPD |
| Servidores DNS upstream criptografados (DNS-Over-HTTPS, DNS-Over-tls, DNScrypt) | ✅ | (requer software adicional) |
| Plataforma cruzada | ✅ | (não nativamente, apenas via Docker) |
| Correndo como um servidor DNS-Over-HTTPS ou DNS-Over-TLS | ✅ | (requer software adicional) |
| Bloqueando domínios de phishing e malware | ✅ | (requer listas de bloqueio não-defensor) |
| Controle dos pais (bloqueando domínios adultos) | ✅ | (requer listas de bloqueio não-defensor) |
| Força a pesquisa segura nos mecanismos de pesquisa | ✅ | |
| Configuração por cliente (dispositivo) | ✅ | ✅ |
| Configurações de acesso (escolha quem pode usar o AGH DNS) | ✅ | |
| Correndo sem privilégios de raiz | ✅ |
Depende.
O DNS Sinkholing é capaz de bloquear uma grande porcentagem de anúncios, mas falta a flexibilidade e o poder dos bloqueadores tradicionais de anúncios. Você pode ter uma boa impressão sobre a diferença entre esses métodos lendo este artigo, que compara o Adguard para o Android (um bloqueador tradicional de anúncios) aos bloqueadores de anúncios no nível dos hosts (que são quase idênticos aos bloqueadores baseados em DNS em suas capacidades). Esse nível de proteção é suficiente para alguns usuários.
Além disso, o uso de um bloqueador baseado em DNS pode ajudar a bloquear anúncios, solicitações de rastreamento e análise em outros tipos de dispositivos, como SmartTVs, alto-falantes inteligentes ou outros tipos de dispositivos de IoT (nos quais você não pode instalar bloqueadores de anúncios tradicionais).
Aqui estão alguns exemplos do que não pode ser bloqueado por um bloqueador de nível DNS:
YouTube, anúncios Twitch;
Facebook, Twitter, postagens patrocinadas pelo Instagram.
Essencialmente, qualquer publicidade que compartilha um domínio com conteúdo não pode ser bloqueada por um bloqueador de nível DNS.
Existe uma chance de lidar com isso no futuro? O DNS nunca será suficiente para fazer isso. Nossa única opção é usar um proxy de bloqueio de conteúdo, como o que fazemos nos aplicativos independentes do Adguard. Vamos trazer esse suporte ao Adguard para casa no futuro. Infelizmente, mesmo neste caso, ainda haverá casos quando isso não será suficiente ou exigiria uma configuração bastante complicada.
Run make init para preparar o ambiente de desenvolvimento.
Você precisará disso para construir o Adguard Home:
Vá v1.23 ou mais tarde;
Node.js v18.18 ou posterior;
NPM V8 ou mais tarde;
Abra seu terminal e execute estes comandos:
clone git https://github.com/adguardteam/adguardhomecd adguardhome fazer
Aviso
Atualmente, o sinalizador não padrão -j não é suportado; portanto, a construção do make -j 4 ou a configuração de suas MAKEFLAGS para incluir, por exemplo, -j 4 provavelmente quebrará a construção. Se você tiver seus MAKEFLAGS definidos para isso e não deseja alterá -lo, pode substituí -lo executando make -j 1 .
Verifique o Makefile para aprender sobre outros comandos.
Você pode construir o Adguard Home para qualquer sistema operacional/arco que vai suportar. Para fazer isso, especifique as variáveis do ambiente GOOS e GOARCH como macros quando a make .
Por exemplo:
Env Goos = 'Linux' Goarch = 'Arm64' Make
ou:
Make Goos = 'Linux' Goarch = 'ARM64'
Você precisará snapcraft para preparar uma compilação de lançamento. Depois de instalado, execute o seguinte comando:
Faça o canal de liberação de construção = '...' versão = '...'
Consulte a documentação de destino build-release .
Run make build-docker para construir a imagem do Docker localmente (a que publicamos no DockerHub). Observe que estamos usando o Docker Buildx para construir nossa imagem oficial.
Você pode precisar se preparar antes de usar estas construções:
(Somente Linux) Instale Qemu:
Docker Run-RM-Multiário/Qemu-User-estático-RM-RESET -P Sim-Credencial Sim
Prepare o construtor:
Docker Buildx Create --Name Buildx-Builder-Driver Docker-container-Uuse
Consulte a documentação do alvo build-docker .
Quando você precisa depurar o front -end sem recompilar a versão de produção sempre, por exemplo, para verificar como seus rótulos ficariam em um formulário, você pode executar o ambiente de desenvolvimento do front -end.
Em um terminal separado, execute:
(CD ./client/ && Env Node_env = 'Development' NPM Run Watch)
Execute seu binário AdGuardHome com o sinalizador --local-frontend , que instrui o Adguard Home a ignorar os arquivos de front-end embutido e usá-los do diretório ./build/ .
Agora, quaisquer alterações que você faça no diretório ./client/ deve ser recompilado e estar disponível na interface do usuário da web. Certifique -se de desativar o cache do navegador para garantir que você realmente obtenha a versão recompilada.
Você é bem -vindo a bifurcar este repositório, fazer suas alterações e enviar uma solicitação de tração. Por favor, certifique -se de seguir nossas diretrizes de código.
Observe que não esperamos que as pessoas contribuam para as partes da interface do usuário e do back -end do programa simultaneamente. Idealmente, a parte do back -end é implementada primeiro, ou seja, configuração, API e a própria funcionalidade. A parte da interface do usuário pode ser implementada posteriormente em uma solicitação de tração diferente por uma pessoa diferente.
Existem dois canais de atualização que você pode usar:
beta : versões beta do Adguard Home. Versões mais ou menos estáveis, geralmente lançadas a cada duas semanas ou mais frequentemente.
edge : A versão mais recente do Adguard Home do Development Branch. Novas atualizações são empurradas para esse canal diariamente.
Existem três opções de como você pode instalar uma versão instável:
Snap Store: Procure os canais beta e edge .
Docker Hub: Procure as tags beta e edge .
Construções independentes. Use o script de instalação automatizado ou procure as compilações disponíveis no wiki.
Script para instalar uma versão beta:
Curl -s -s -l https://raw.githubusercontent.com/adguardteam/adguardhome/master/scripts/install.sh | sh -s --c beta
Script para instalar uma versão de borda:
Curl -s -s -l https://raw.githubusercontent.com/adguardteam/adguardhome/master/scripts/install.sh | sh -s --C Edge
Se você tiver algum problema ou tiver uma sugestão, vá para esta página e clique no botão "Novo problema". Siga as instruções da questão com cuidado e não se esqueça de começar pesquisando duplicatas.
Se você quiser ajudar com traduções domésticas do Adguard, saiba mais sobre como traduzir produtos de adguard em nossa base de conhecimento. Você pode contribuir para o projeto Adguardhome em Crowdin.
Outra maneira de contribuir é procurar problemas marcados como help wanted , perguntando se o problema está em disputa e enviando um PR consertando o bug ou implementando o recurso.
Observe que esses projetos não são afiliados ao Adguard, mas são feitos por desenvolvedores e fãs de terceiros.
Adguard Home Remote: IOS App de Joost.
Biblioteca Python por @frenck.
Adicionamento Assistente de casa por @Frenck.
OpenWrt Luci App por @Kongfl888 (originalmente por @rufengsuixing).
Adguardhome Sync por @bakito.
Monitoramento de tráfego e estatísticas em tempo real baseado em terminais para sua instância de adguard por @lissy93
Adguard Home em roteadores Glinet da GL-Innet.
App Cloudron por @gramakri.
ASUSWRT-MERLIN-ADGUARDHOME-INSTALLER POR @JUMPSMMM7, também conhecido como @somewarovertherainbow.
Biblioteca Node.js por @Andrea055.
Extensão do navegador por @satheshshiva.
Modelo Zabbix para Adguard Home por @diasdmhub.
Pacote de chocolate por NIKS255.
Este software não teria sido possível sem:
Vá e suas bibliotecas:
gcache
DNS de Miekg
go-yaml
serviço
dnsproxy
urlfilter
Node.js e suas bibliotecas:
React.js
Tabler
E muitos outros pacotes Node.js.
Dados WhoTracks.me
Você pode ter visto que o COREDNS foi mencionado aqui antes, mas paramos de usá -lo em Adguard Home.
Para obter a lista completa de todos os pacotes Node.js em uso, consulte o arquivo client/package.json .
Nossa idéia principal é que você seja o único, que deve estar no controle de seus dados. Portanto, é natural que o Adguard Home não coleta nenhuma estatística de uso e não use nenhum serviço da Web, a menos que você o configure para fazê -lo. Veja também a política de privacidade completa com tudo o que, em teoria, pode ser enviado pela Adguard Home.
