AdGuardHome
v0.107.54
GRATUITEMENT ET Open Source, puissantes publicités et trackers à l'échelle du réseau bloquant le serveur DNS.
Adguard.com | Wiki | Reddit | Twitter | Télégramme
Adguard Home est un logiciel à l'échelle du réseau pour bloquer les publicités et le suivi. Après l'avoir configuré, il couvrira tous vos appareils domestiques et vous n'avez pas besoin de logiciel côté client pour cela.
Il fonctionne comme un serveur DNS qui recouvre les domaines de suivi à un «trou noir», empêchant ainsi vos appareils de se connecter à ces serveurs. Il est basé sur des logiciels que nous utilisons pour nos serveurs publics Adguard DNS, et tous deux partagent beaucoup de code.
Commencer
Installation automatisée (Linux / Unix / MacOS / FreeBSD / OpenBSD)
Méthodes alternatives
Guides
API
Comparer Adguard à la maison à d'autres solutions
En quoi est-ce différent des serveurs DNS Adguard publics?
Comment Adguard Home se compare-t-il à Pi-Hole
Comment Adguard Home se compare-t-il aux bloqueurs d'annonces traditionnels
Limitations connues
Comment construire à partir de la source
Condition préalable
Bâtiment
Contributif
Tester des versions instables
Problèmes de rapport
Aide aux traductions
Autre
Projets qui utilisent Adguard Home
Remerciements
Confidentialité
Pour installer avec curl Exécutez la commande suivante:
curl -s -s -l https://raw.githubusercontent.com/adguardteam/adguardhome/master/scripts/install.sh | sh -s - -v
Pour installer avec wget exécutez la commande suivante:
wget --no-verbose -o - https://raw.githubusercontent.com/adguardteam/adguardhome/master/scripts/install.sh | sh -s - -v
Pour installer avec fetch exécutez la commande suivante:
Fetch -o - https://raw.githubusercontent.com/adguardteam/adguardhome/master/scripts/install.sh | sh -s - -v
Le script accepte également certaines options:
-c <channel> Pour utiliser le canal spécifié;
-r pour réinstaller Adguard à la maison;
-u à désinstaller la maison Adguard;
-v pour la sortie verbeuse.
Notez que les options -r et -u s'excluent mutuellement.
Veuillez lire l'article de démarrage sur notre wiki pour apprendre à installer Adguard Home manuellement et à configurer vos appareils pour l'utiliser.
Vous pouvez utiliser notre image Docker officielle sur Docker Hub.
Si vous exécutez Linux, il existe un moyen sécurisé et facile d'installer Adguard Home: Obtenez-le de la boutique Snap.
Voir notre wiki.
Si vous souhaitez vous intégrer à Adguard Home, vous pouvez utiliser notre API REST. Alternativement, vous pouvez utiliser ce client Python, qui est utilisé pour construire le module complémentaire Adguard Home Hass.io.
L'exécution de votre propre serveur domestique Adguard vous permet de faire bien plus que d'utiliser un serveur DNS public. C'est un niveau complètement différent. Voyez par vous-même:
Choisissez ce que le serveur bloque et permet.
Surveillez votre activité réseau.
Ajoutez vos propres règles de filtrage personnalisées.
Plus important encore, c'est votre propre serveur, et vous êtes le seul à contrôler.
À ce stade, Adguard Home a beaucoup en commun avec Pi-Hole. Bloquer les annonces et les trackers à l'aide de la méthode dite «DNS Sinkholing» et les deux permettent de personnaliser ce qui est bloqué.
Note
Nous n'allons pas nous arrêter ici. L'échou DNS n'est pas un mauvais point de départ, mais ce n'est que le début.
Adguard Home fournit de nombreuses fonctionnalités prêtes à l'emploi sans avoir besoin d'installer et de configurer des logiciels supplémentaires. Nous voulons que ce soit simple au point où même les utilisateurs occasionnels peuvent le configurer avec un minimum d'effort.
Note
Certaines des fonctionnalités répertoriées peuvent être ajoutées au Pi-Hole en installant un logiciel supplémentaire ou en utilisant manuellement le terminal SSH et en reconfigurant l'un des utilitaires Pi-Hole de. Cependant, à notre avis, cela ne peut pas être légitimement compté comme une fonctionnalité d'un trou pi.
| Fonctionnalité | Adguard Home | Pi-trous |
|---|---|---|
| Bloquer des publicités et des trackers | ✅ | ✅ |
| Personnalisation des listes de blocage | ✅ | ✅ |
| Serveur DHCP intégré | ✅ | ✅ |
| HTTPS pour l'interface d'administration | ✅ | En quelque sorte, mais vous devrez configurer manuellement LightTPD |
| Serveurs en amont DNS chiffrés (DNS-Over-HTTPS, DNS-Over-TLS, DNSCrypt) | ✅ | (nécessite un logiciel supplémentaire) |
| Multiplateforme | ✅ | (pas nativement, seulement via Docker) |
| Exécution en tant que serveur DNS-Over-HTTPS ou DNS-sur-TLS | ✅ | (nécessite un logiciel supplémentaire) |
| Bloquer des domaines de phishing et de logiciels malveillants | ✅ | (nécessite des listes de blocs non défaut) |
| Contrôle parental (blocage des domaines adultes) | ✅ | (nécessite des listes de blocs non défaut) |
| Force la recherche sûre sur les moteurs de recherche | ✅ | |
| Configuration par client (appareil) | ✅ | ✅ |
| Paramètres d'accès (Choisissez qui peut utiliser AGH DNS) | ✅ | |
| Courir sans privilèges racine | ✅ |
Ça dépend.
L'évannage DNS est capable de bloquer un grand pourcentage d'annonces, mais il n'a pas la flexibilité et la puissance des bloqueurs de publicité traditionnels. Vous pouvez avoir une bonne impression de la différence entre ces méthodes en lisant cet article, qui compare Adguard pour Android (un bloqueur d'annonces traditionnel) aux bloqueurs d'annonces au niveau des hôtes (qui sont presque identiques aux bloqueurs basés sur DNS dans leurs capacités). Ce niveau de protection est suffisant pour certains utilisateurs.
De plus, l'utilisation d'un bloqueur basé sur DNS peut aider à bloquer les annonces, le suivi et les demandes d'analyse sur d'autres types d'appareils, tels que SmartTV, des haut-parleurs intelligents ou d'autres types d'appareils IoT (sur lesquels vous ne pouvez pas installer des bloqueurs d'annonces traditionnels).
Voici quelques exemples de ce qui ne peut pas être bloqué par un bloqueur de niveau DNS:
YouTube, Twitch Ads;
Facebook, Twitter, Possons parrainés par Instagram.
Essentiellement, toute publicité qui partage un domaine avec du contenu ne peut pas être bloquée par un bloqueur de niveau DNS.
Y a-t-il une chance de gérer cela à l'avenir? Le DNS ne sera jamais suffisant pour le faire. Notre seule option est d'utiliser un proxy de blocage de contenu comme ce que nous faisons dans les applications Adguard autonomes. Nous allons apporter ce support de fonctionnalité à Adguard à la maison à l'avenir. Malheureusement, même dans ce cas, il y aura toujours des cas où cela ne sera pas suffisant ou nécessiterait une configuration assez compliquée.
Run make init pour préparer l'environnement de développement.
Vous aurez besoin de cela pour construire Adguard à la maison:
GO V1.23 ou version ultérieure;
Node.js v18.18 ou version ultérieure;
NPM V8 ou version ultérieure;
Ouvrez votre terminal et exécutez ces commandes:
git clone https://github.com/adguardteam/adguardhomecd adguardhome faire
Avertissement
L'indicateur -j non standard n'est actuellement pas pris en charge, donc construire avec make -j 4 ou définir vos MAKEFLAGS pour inclure, par exemple, -j 4 c'est probablement briser la construction. Si vous avez vos MAKEFLAGS définis à cela et que vous ne voulez pas le changer, vous pouvez le remplacer en exécutant make -j 1 .
Vérifiez le Makefile pour en savoir plus sur les autres commandes.
Vous pouvez construire Adguard Home pour n'importe quel système d'exploitation / arc qui prend en charge. Pour ce faire, spécifiez les variables GOOS et d'environnement GOARCH sous forme de macros lors de l' make .
Par exemple:
Env goos = 'Linux' goarch = 'arm64' faire
ou:
faire goos = 'Linux' goarch = 'arm64'
Vous aurez besoin snapcraft pour préparer une version de version. Une fois installé, exécutez la commande suivante:
Faire un canal de construction de build = '...' version = '...'
Voir la documentation cible build-release .
Exécutez make build-docker pour construire l'image Docker localement (celle que nous publions sur DockerHub). Veuillez noter que nous utilisons Docker BuildX pour construire notre image officielle.
Vous devrez peut-être vous préparer avant d'utiliser ces versions:
(Linux uniquement) Installer Qemu:
Docker Run --RM - Multiarch / Qemu-User-static --reset -p Oui - Crédité oui
Préparez le constructeur:
docker buildx create --name buildx-builder - Driver docker-container --User
Voir la documentation cible build-docker .
Lorsque vous devez déboguer le frontend sans recompiller la version de production à chaque fois, par exemple pour vérifier à quoi ressemblerait vos étiquettes sur un formulaire, vous pouvez exécuter le frontend construire un environnement de développement.
Dans un terminal séparé, exécutez:
(cd ./client/ && env node_env = 'Development' NPM Run Watch)
Exécutez votre binaire AdGuardHome avec le drapeau --local-frontend , qui demande à Adguard d'ignorer les fichiers frontaux intégrés et d'utiliser ceux du répertoire ./build/ .
Maintenant, toutes les modifications que vous apportez dans le répertoire ./client/ doivent être recompilées et devenir disponibles sur l'interface utilisateur Web. Assurez-vous de désactiver le cache du navigateur pour vous assurer que vous obtenez réellement la version recompilée.
Vous êtes les bienvenus pour alimenter ce référentiel, apporter vos modifications et soumettre une demande de traction. Veuillez cependant vous assurer de suivre nos directives de code.
Veuillez noter que nous ne nous attendons pas à ce que les gens contribuent à la fois à l'interface utilisateur et à des parties backend du programme simultanément. Idéalement, la partie backend est implémentée en premier, c'est-à-dire la configuration, l'API et la fonctionnalité elle-même. La pièce d'interface utilisateur peut être mise en œuvre plus tard dans une autre demande de traction par une personne différente.
Il y a deux canaux de mise à jour que vous pouvez utiliser:
beta : Versions bêta d'Adguard Home. Des versions plus ou moins stables, généralement libérées toutes les deux semaines ou plus souvent.
edge : la nouvelle version d'Adguard Home de la branche de développement. De nouvelles mises à jour sont poussées quotidiennement sur cette chaîne.
Il existe trois options sur la façon d'installer une version instable:
SNAP STORE: Recherchez les canaux beta et edge .
Docker Hub: Recherchez les balises beta et edge .
Construction autonome. Utilisez le script d'installation automatisé ou recherchez les versions disponibles sur le wiki.
Script pour installer une version bêta:
curl -s -s -l https://raw.githubusercontent.com/adguardteam/adguardhome/master/scripts/install.sh | sh -s - -c bêta
Script pour installer une version de bord:
curl -s -s -l https://raw.githubusercontent.com/adguardteam/adguardhome/master/scripts/install.sh | SH -S - -c Edge
Si vous rencontrez un problème ou avez une suggestion, rendez-vous sur cette page et cliquez sur le bouton «Nouveau problème». Veuillez suivre attentivement les instructions du formulaire de problème et n'oubliez pas de commencer par rechercher des doublons.
Si vous souhaitez aider avec Adguard Home Tralations, veuillez en savoir plus sur la traduction des produits Adguard dans notre base de connaissances. Vous pouvez contribuer au projet Adguardhome sur Crowdin.
Une autre façon de contribuer est de rechercher des problèmes marqués comme help wanted , de demander si le problème est à gagner et d'envoyer un RP corriger le bogue ou d'implémenter la fonctionnalité.
Veuillez noter que ces projets ne sont pas affiliés à Adguard, mais sont fabriqués par des développeurs et des fans tiers.
Adguard Home Remote: application iOS de Joost.
Python Library par @frenck.
Complément adjoint de l'assistant à domicile par @frenck.
Application OpenWrt Luci par @ kongfl888 (à l'origine par @rufengsuixing).
Adguardhome Sync par @bakito.
Surveillance du trafic en temps réel basée sur les terminaux et statistiques pour votre instance à domicile Adguard par @ Lissy93
Adguard Home on Ginet Routeurs par GL-INET.
Application Cloudron par @gramakri.
Asuswrt-Merlin-AdguardHome-Installer par @ Jumpsmm7 aka @somewhereOvertherainBow.
Bibliothèque Node.js par @ andrea055.
Extension du navigateur par @satheshshiva.
Modèle zabbix pour Adguard Home par @DiasdmHub.
Ensemble chocolaté par NIKS255.
Ce logiciel n'aurait pas été possible sans:
Allez et ses bibliothèques:
gcache
DNS de Miekg
go-yaml
service
dnsproxy
urlfilter
Node.js et ses bibliothèques:
React.js
Tableur
Et beaucoup plus de packages Node.js.
whotracks.me données
Vous avez peut-être vu que les coredns ont été mentionnés ici auparavant, mais nous avons cessé de l'utiliser à Adguard Home.
Pour la liste complète de tous les packages Node.js utilisés, veuillez consulter le fichier client/package.json .
Notre principale idée est que vous êtes celui qui devrait contrôler vos données. Il est donc naturel, qu'Adguard Home ne collecte aucune statistique d'utilisation et n'utilise aucun service Web à moins que vous ne le configuriez pour le faire. Voir également la politique de confidentialité complète avec chaque bit qui pourrait en théorie être envoyée par Adguard Home est disponible.
