adguardteam/adguardhomeServeur DNS de blocage des publicités et des traceurs à l'échelle du réseau.
Serveur DNS gratuit et open source, puissant, bloquant les publicités et les trackers à l'échelle du réseau.
AdGuard.com |
Wiki |
Reddit |
Twitter |
Telegram
AdGuard Home est un logiciel réseau qui bloque les publicités et le pistage. Après l'avoir configuré, il couvre TOUS vos appareils domestiques, et vous n'avez besoin d'aucun logiciel côté client pour cela.
Il fonctionne comme un serveur DNS qui redirige les domaines de pistage vers un « trou noir », empêchant ainsi vos appareils de se connecter à ces serveurs. Il est basé sur le logiciel que nous utilisons pour nos serveurs publics AdGuard DNS, et les deux partagent beaucoup de code.
Pour installer avec curl, exécutez la commande suivante :```sh
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 :```sh
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 :```sh
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 Home ;
- `-u` pour désinstaller AdGuard Home ;
- `-v` pour une sortie détaillée.
Notez que les options `-r` et `-u` sont mutuellement exclusives.
### <a href="#alternative-methods" id="alternative-methods" name="alternative-methods">Méthodes alternatives</a>
#### <a href="#manual-installation" id="manual-installation" name="manual-installation">Installation manuelle</a>
Veuillez lire l'article **[Premiers pas][wiki-start]** de notre Wiki pour apprendre à installer AdGuard Home manuellement et à configurer vos appareils pour l'utiliser.
#### <a href="#docker" id="docker" name="docker">Docker</a>
Vous pouvez utiliser notre image Docker officielle sur [Docker Hub].
#### <a href="#snap-store" id="snap-store" name="snap-store">Snap Store</a>
Si vous utilisez **Linux,** il existe un moyen simple et sûr d'installer AdGuard Home : obtenez-le depuis le [Snap Store].
[Docker Hub]: https://hub.docker.com/r/adguard/adguardhome
[Snap Store]: https://snapcraft.io/adguard-home
[wiki-start]: https://adguard-dns.io/kb/adguard-home/getting-started/
### <a href="#guides" id="guides" name="guides">Guides</a>
Consultez notre [Wiki][wiki].
[wiki]: https://github.com/AdguardTeam/AdGuardHome/wiki
### <a href="#api" id="api" name="api">API</a>
Si vous souhaitez intégrer AdGuard Home, vous pouvez utiliser notre [API REST][openapi]. Vous pouvez également utiliser ce [client python][pyclient], qui peut être utilisé pour créer l'[intégration AdGuard Home Assistant][assistant-integration].
[assistant-integration]: https://www.home-assistant.io/integrations/adguard/
[openapi]: https://github.com/AdguardTeam/AdGuardHome/tree/master/openapi
[pyclient]: https://pypi.org/project/adguardhome/
## <a href="#comparison" id="comparison" name="comparison">Comparaison d'AdGuard Home avec d'autres solutions</a>
### <a href="#comparison-adguard-dns" id="comparison-adguard-dns" name="comparison-adguard-dns">En quoi cela diffère-t-il des serveurs DNS publics AdGuard ?</a>
Exécuter votre propre serveur AdGuard Home vous permet d'en faire bien plus que d'utiliser un serveur DNS public. C'est un tout autre niveau. Voyez par vous-même :
- Choisissez exactement ce que le serveur bloque et autorise.
- Surveillez l'activité de votre réseau.
- Ajoutez vos propres règles de filtrage personnalisées.
- **Plus important encore, c'est votre propre serveur, et vous êtes le seul à avoir le contrôle.**
### <a href="#comparison-pi-hole" id="comparison-pi-hole" name="comparison-pi-hole">Comment AdGuard Home se compare-t-il à Pi-Hole</a>
À ce stade, AdGuard Home a beaucoup en commun avec Pi-Hole. Les deux bloquent les publicités et les traqueurs en utilisant la méthode dite du « DNS sinkholing » et les deux permettent de personnaliser ce qui est bloqué.
> [!NOTE]
> Nous n'allons pas nous arrêter là. Le DNS sinkholing n'est pas un mauvais point de départ, mais ce n'est que le début.
AdGuard Home offre de nombreuses fonctionnalités prêtes à l'emploi, sans qu'il soit nécessaire d'installer et de configurer des logiciels supplémentaires. Nous voulons que ce soit simple au point que même les utilisateurs occasionnels puissent le configurer avec un minimum d'effort.
> [!NOTE]
> Certaines des fonctionnalités listées peuvent être ajoutées à Pi-Hole en installant des logiciels supplémentaires ou en utilisant manuellement le terminal SSH et en reconfigurant l'un des utilitaires qui composent Pi-Hole. Cependant, à notre avis, cela ne peut pas être légitimement considéré comme une fonctionnalité de Pi-Hole.
| Fonctionnalité | AdGuard Home | Pi-Hole |
|-------------------------------------------------------------------------|-------------------|-----------------------------------------------------------|
| Blocage des publicités et des traqueurs | ✅ | ✅ |
| 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 DNS amont chiffrés (DNS-over-HTTPS, DNS-over-TLS, DNSCrypt) | ✅ | ❌ (nécessite un logiciel supplémentaire) |
| Multiplateforme | ✅ | ❌ (pas nativement, uniquement via Docker) |
| Fonctionnement en tant que serveur DNS-over-HTTPS ou DNS-over-TLS | ✅ | ❌ (nécessite un logiciel supplémentaire) |
| Blocage des domaines de phishing et de logiciels malveillants | ✅ | ❌ (nécessite des listes de blocage non standard) |
| Contrôle parental (blocage des domaines pour adultes) | ✅ | ❌ (nécessite des listes de blocage non standard) |
| Forcer la recherche sécurisée sur les moteurs de recherche | ✅ | ❌ |
| Configuration par client (appareil) | ✅ | ✅ |
| Paramètres d'accès (choisir qui peut utiliser le DNS AGH) | ✅ | ❌ |
| Fonctionnement [sans privilèges root][wiki-noroot] | ✅ | ❌ |
[wiki-noroot]: https://adguard-dns.io/kb/adguard-home/getting-started/
### <a href="#comparison-adblock" id="comparison-adblock" name="comparison-adblock">Comment AdGuard Home se compare aux bloqueurs de publicités traditionnels</a>
Cela dépend.
Le DNS sinkholing est capable de bloquer un grand pourcentage de publicités, mais il lui manque la flexibilité et la puissance des bloqueurs de publicités traditionnels. Vous pouvez vous faire une bonne idée de la différence entre ces méthodes en lisant [cet article][blog-adaway], qui compare AdGuard pour Android (un bloqueur de publicités traditionnel) aux bloqueurs au niveau du fichier hosts (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 le DNS peut aider à bloquer les publicités, le suivi et les requêtes d'analyse sur d'autres types d'appareils, tels que les SmartTV, les enceintes connectées ou d'autres types d'appareils IoT (sur lesquels vous ne pouvez pas installer de bloqueurs de publicités traditionnels).
### <a href="#comparison-limitations" id="comparison-limitations" name="comparison-limitations">Limitations connues</a>
Voici quelques exemples de ce qui ne peut pas être bloqué par un bloqueur au niveau DNS :
- les publicités YouTube, Twitch ;
- les publications sponsorisées Facebook, Twitter, Instagram.
Essentiellement, toute publicité qui partage un domaine avec du contenu ne peut pas être bloquée par un bloqueur au niveau DNS.
Y a-t-il une chance de gérer cela à l'avenir ? Le DNS ne suffira jamais pour cela. Notre seule option est d'utiliser un proxy de blocage de contenu comme nous le faisons dans les applications AdGuard autonomes. Nous allons [apporter][issue-1228] le support de cette fonctionnalité à AdGuard Home à l'avenir. Malheureusement, même dans ce cas, il y aura encore des cas où cela ne suffira pas ou nécessitera une configuration assez compliquée.
[blog-adaway]: https://adguard.com/blog/adguard-vs-adaway-dns66.html
[issue-1228]: https://github.com/AdguardTeam/AdGuardHome/issues/1228
## <a href="#how-to-build" id="how-to-build" name="how-to-build">Comment compiler à partir des sources</a>
### <a href="#prerequisites" id="prerequisites" name="prerequisites">Prérequis</a>
Exécutez `make init` pour préparer l'environnement de développement.
Vous aurez besoin de ceci pour compiler AdGuard Home :
- [Go](https://golang.org/dl/) v1.25 ou une version ultérieure ;
- [Node.js](https://nodejs.org/en/download/) v24.10.0 ou une version ultérieure ;
- [npm](https://www.npmjs.com/) v10.8 ou une version ultérieure ;
### <a href="#building" id="building" name="building">Compilation</a>
Ouvrez votre terminal et exécutez ces commandes :```sh
git clone https://github.com/AdguardTeam/AdGuardHome
cd AdGuardHome
make
[!WARNING] L'option non standard
-jn'est actuellement pas prise en charge, donc compiler avecmake -j 4ou définir vosMAKEFLAGSpour inclure, par exemple,-j 4, risque de casser la compilation. Si vosMAKEFLAGSsont définis ainsi et que vous ne souhaitez pas les modifier, vous pouvez les remplacer en exécutantmake -j 1.
Consultez le Makefile pour en savoir plus sur les autres commandes.
Vous pouvez compiler AdGuard Home pour n'importe quel OS/ARCH pris en charge par Go. Pour ce faire, spécifiez les variables d'environnement GOOS et GOARCH comme macros lors de l'exécution de make.
Par exemple :```sh env GOOS='linux' GOARCH='arm64' make
ou:```sh
make GOOS='linux' GOARCH='arm64'
Vous aurez besoin de snapcraft pour préparer un build de version. Une fois installé, exécutez la commande suivante :```sh
make build-release CHANNEL='...' VERSION='...'
Voir la [documentation de la cible `build-release`][targ-release].
#### <a href="#docker-image" id="docker-image" name="docker-image">Image Docker</a>
Exécutez `make build-docker` pour construire l'image Docker localement (celle que nous publions sur DockerHub). Veuillez noter que nous utilisons [Docker Buildx][buildx] pour construire notre image officielle.
Vous devrez peut-être préparer ces éléments avant d'utiliser ces builds :
- (Linux uniquement) Installer Qemu : ```sh
docker run --rm --privileged multiarch/qemu-user-static --reset -p yes --credential yes
Voir la documentation de la cible build-docker.
Lorsque vous avez besoin de déboguer le frontend sans recompiler la version de production à chaque fois, par exemple pour vérifier à quoi ressembleraient vos étiquettes sur un formulaire, vous pouvez exécuter le build du frontend dans un environnement de développement.
Dans un terminal séparé, exécutez : ```sh ( cd ./client/ && env NODE_ENV='development' npm run watch )
Lancez votre binaire AdGuardHome avec le flag --local-frontend, ce qui indique à AdGuard Home d'ignorer les fichiers frontend intégrés et d'utiliser ceux du répertoire ./build/.
Désormais, toutes les modifications que vous apportez dans le répertoire ./client/ devraient être recompilées et disponibles sur l'interface web. Assurez-vous de désactiver le cache du navigateur pour être certain d'obtenir réellement la version recompilée.
AdGuard Home utilise Playwright pour les tests E2E. Les tests se trouvent dans tests/e2e.
Exécution des tests :
npm run test:e2e – exécute tous les tests (headless).npm run test:e2e:interactive – exécute les tests en mode interactif.npm run test:e2e:debug – exécute les tests en mode débogage.npm run test:e2e:codegen – génère un nouveau code de test.Configuration :
npm install pour installer les dépendances.npx playwright install pour installer les navigateurs requis.Avertissement : Playwright téléchargera et installera ses propres binaires de navigateur pour les tests, qui peuvent différer des navigateurs installés sur votre système.
Vous êtes invités à forker ce dépôt, à apporter vos modifications et à soumettre une pull request. Veuillez toutefois vous assurer de suivre nos règles de code.
Veuillez noter que nous n'attendons pas de personnes contribuant à la fois aux parties UI et backend du programme. 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 partie UI peut être implémentée plus tard dans une autre pull request par une autre personne.
Deux canaux de mise à jour sont à votre disposition :
beta : les versions bêta d'AdGuard Home. Des versions plus ou moins stables, généralement publiées toutes les deux semaines ou plus souvent.
edge : la toute dernière version d'AdGuard Home issue de la branche de développement. De nouvelles mises à jour sont poussées quotidiennement sur ce canal.
Il existe trois options pour installer une version instable :
[Snap Store] : recherchez les canaux beta et edge.
[Docker Hub] : recherchez les balises beta et edge.
Versions autonomes. Utilisez le script d'installation automatisé ou recherchez les versions disponibles [sur le Wiki][wiki-platf].
Script pour installer une version bêta : ```sh curl -s -S -L https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -c beta
Script pour installer une version edge: ```sh curl -s -S -L https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -c edge
[wiki-platf]: https://github.com/AdguardTeam/AdGuardHome/wiki/Platforms
### <a href="#reporting-issues" id="reporting-issues" name="reporting-issues">Signaler des problèmes</a>
Si vous rencontrez un problème ou avez une suggestion, rendez-vous sur [cette page][iss] et cliquez sur le bouton “New issue”. Veuillez suivre attentivement les instructions du formulaire d'issue et n'oubliez pas de commencer par rechercher les doublons.
[iss]: https://github.com/AdguardTeam/AdGuardHome/issues
### <a href="#translate" id="translate" name="translate">Aider à la traduction</a>
Si vous souhaitez aider à la traduction d'AdGuard Home, veuillez en apprendre davantage sur la traduction des produits AdGuard [dans notre base de connaissances][kb-trans]. Vous pouvez contribuer au [projet AdGuardHome sur CrowdIn][crowdin].
[crowdin]: https://crowdin.com/project/adguard-applications/en#/adguard-home
[kb-trans]: https://kb.adguard.com/en/general/adguard-translations
### <a href="#help-other" id="help-other" name="help-other">Autre</a>
Une autre façon de contribuer consiste à [chercher les issues][iss-help] marqués comme `help wanted`, à demander si l'issue est disponible, puis à envoyer une PR corrigeant le bug ou implémentant la fonctionnalité.
[iss-help]: https://github.com/AdguardTeam/AdGuardHome/issues?q=is:issue+is:open+label:%22help+wanted%22
## <a href="#uses" id="uses" name="uses">Projets qui utilisent AdGuard Home</a>
Veuillez noter que ces projets ne sont pas affiliés à AdGuard, mais sont réalisés par des développeurs et des fans tiers.
- [AdGuard Home Remote](https://apps.apple.com/app/apple-store/id1543143740) : application iOS par [Joost](https://rocketscience-it.nl/).
- [Python library](https://github.com/frenck/python-adguardhome) par [@frenck](https://github.com/frenck).
- [Home Assistant add-on](https://github.com/hassio-addons/addon-adguard-home) par [@frenck](https://github.com/frenck).
- [OpenWrt LUCI app](https://github.com/kongfl888/luci-app-adguardhome) par [@kongfl888](https://github.com/kongfl888) (à l'origine par [@rufengsuixing](https://github.com/rufengsuixing)).
- [AdGuardHome sync](https://github.com/bakito/adguardhome-sync) par [@bakito](https://github.com/bakito).
- [Surveillance du trafic et statistiques en temps réel dans un terminal pour votre instance AdGuard Home](https://github.com/Lissy93/AdGuardian-Term) par [@Lissy93](https://github.com/Lissy93)
- [AdGuard Home sur les routeurs GLInet](https://forum.gl-inet.com/t/adguardhome-on-gl-routers/10664) par [Gl-Inet](https://gl-inet.com/).
- [Cloudron app](https://git.cloudron.io/cloudron/adguard-home-app) par [@gramakri](https://github.com/gramakri).
- [Asuswrt-Merlin-AdGuardHome-Installer](https://github.com/jumpsmm7/Asuswrt-Merlin-AdGuardHome-Installer) par [@jumpsmm7](https://github.com/jumpsmm7) alias [@SomeWhereOverTheRainBow](https://www.snbforums.com/members/somewhereovertherainbow.64179/).
- [Node.js library](https://github.com/Andrea055/AdguardHomeAPI) par [@Andrea055](https://github.com/Andrea055/).
- [Extension de navigateur](https://github.com/satheshshiva/Adguard-Home-Browser-Ext) par [@satheshshiva](https://github.com/satheshshiva/).
- [Modèle Zabbix pour AdGuard Home](https://github.com/diasdmhub/AdGuard_Home_Zabbix_Template) par [@diasdmhub](https://github.com/diasdmhub).
- [Paquet Chocolatey](https://community.chocolatey.org/packages/adguardhome/) par [niks255](https://community.chocolatey.org/profiles/niks255).
- [Fiche ZimaOS App Store](https://www.zimaspace.com/zimaos/app-store/app/org.icewhale.adguardhome) par [CasaOS Team](https://casaos.zimaspace.com/).
## <a href="#acknowledgments" id="acknowledgments" name="acknowledgments">Remerciements</a>
Ce logiciel n'aurait pas été possible sans :
- [Go](https://golang.org/dl/) et ses bibliothèques :
- [gcache](https://github.com/bluele/gcache)
- [dns de miekg](https://github.com/miekg/dns)
- [go-yaml](https://github.com/go-yaml/yaml)
- [service](https://godoc.org/github.com/kardianos/service)
- [dnsproxy](https://github.com/AdguardTeam/dnsproxy)
- [urlfilter](https://github.com/AdguardTeam/urlfilter)
- [Node.js](https://nodejs.org/) et ses bibliothèques :
- [React.js](https://reactjs.org)
- [Tabler](https://github.com/tabler/tabler)
- Et bien d'autres paquets Node.js.
- [données de whotracks.me](https://github.com/cliqz-oss/whotracks.me)
Vous avez peut-être vu que [CoreDNS] était mentionné ici auparavant, mais nous avons arrêté de l'utiliser dans AdGuard Home.
Pour la liste complète de tous les paquets Node.js utilisés, veuillez consulter le fichier [`client/package.json`][src-packagejson].
[CoreDNS]: https://coredns.io
[src-packagejson]: https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/client/package.json
## <a href="#privacy" id="privacy" name="privacy">Confidentialité</a>
Notre idée principale est que c'est vous qui devez contrôler vos données. Il est donc tout naturel qu'AdGuard Home ne collecte aucune statistique d'utilisation et n'utilise aucun service web, sauf si vous le configurez pour cela. Consultez également la [politique de confidentialité complète][privacy] où chaque donnée qui *pourrait en théorie être envoyée* par AdGuard Home est disponible.
[privacy]: https://adguard.com/en/privacy/home.html