Nous allons ici utiliser docker run pour installer AdGuard Home sur un Rapsberry pi.

AdGuard Home? C'est quoi ?
AdGuard Home est un logiciel anti-pub et anti-traçage qui fonctionne au niveau du système. Une fois installé, il fonctionnera sur TOUS vos appareils, et vous n'aurez pas besoin d'installer de logiciel-client. L'essor de l'Internet des objets et l'affluence d'appareils connectés rend nécessaire le contrôle de votre réseau dans son intégralité.
Pré-requis :
Avoir un accès SSH au Raspberry
Avoir installer docker. voir tuto
Connaitre le PUID/GUID de l'utilisateur pi, voir tuto
Sommaire :
1/ Créer les dossiers nécessaires
2/ Création du sous-réseau ( macvlan )
3/ Création du conteneur
4/ Accès à l'interface de AdGuard Home
1/ Créer les dossiers nécessaires
Pour mon tuto, je vais placer mon installation dans /media, cela peut bien sur être changer, mais il faudra adapter vos changements dans notre compose.
Je me place donc dans /media :
cd /media
AdGuard Home a besoin d'un dossier, avec deux sous-dossier /workdir et /confdir, avec cette commande, on créer l'ensemble :
sudo mkdir -p adguard/{workdir,confdir}
Afin d'attribuer une IP dédié a AdGuard Home, nous allons créer un sous réseau "macvlan" en SSH. Cette commande sert a adapter suivant votre config, nous allons donc détailler la commande en dessous de celle-ci :
docker network create -d macvlan --subnet=192.168.0.0/24 --gateway=192.168.0.254 --ip-range=192.168.0.61/32 -o parent=eth0 adguard-network
--subnet=192.168.0.0/24
192.168.0.0/24 correspond à votre sous-réseau mon sous-réseau est en 192.168.0.X donc la commande est --subnet=192.168.0.0/24, si votre sous réseau est en 192.168.1.X alors la commande sera --subnet=192.168.1.0/24.
--gateway=192.168.0.254
192.168.0.254 correspond à l'ip du routeur, il peut être différent chez vous, les adresses classique sont : 192.168.0.254, 192.168.1.254, 192.168.1.1
--ip-range=192.168.0.61/32
Ici je choisi l'ip qui sera attribué a notre réseau, chez moi le raspberry à l'adresse IP 192.168.0.60, j'ai donc choisi 192.168.0.61 pour le sous-réseau
parent=eth0
Ici eth0 correspond a l'interface réseau, par défaut cela sera eth0 pour vérifier cela, il vous suffit de tapez la commande
ifconfig
en SSH puis de selectionner l'interface réseau qui contient l'adresse ip du raspberry.
3/ Création du conteneur
En SSH, nous allons exécuter cette commande afin de créer le conteneur :
docker run --name adguardhome --net adguard-network -v /media/adguard/workdir:/opt/adguardhome/work -v /media/adguard/confdir:/opt/adguardhome/conf --restart unless-stopped -d adguard/adguardhome
Dans le cas ou vous avez créer les dossiers dans en endroit différent, il vous faudra modifier le chemin d'accès vers les dossiers de configuration :
-v /media/adguard/workdir:/opt/adguardhome/work -v /media/adguard/confdir:/opt/adguardhome/conf
Une fois la commande executé, le conteneur est créé.
4/ Accès à l'interface de AdGuard Home
L'accès a l'interface de AdGuard, se fait simplement via notre navigateur, en tapant l'adresse ip que vous avez choisi dans votre sous ré-seau distiné à AdGuard Home ( dans mon tuto 192.168.0.61, soit http:192.168.0.61 )
Ensuite, il va vous être demandé de créer un compte, puis il vous sera présenté quelques astuces de configuration, afin apr exemple, de configurer le serveur DNS sur votre routeur.
2021-04-07 - Suppression de la déclaration des ports, inutile en macvlan ( -p 53:53/tcp -p 53:53/udp -p 67:67/udp -p 68:68/tcp -p 68:68/udp -p 80:80/tcp -p 443:443/tcp -p 853:853/tcp -p 3000:3000/tcp )
Raspberry : Docker + Portainer - Nextcloud - AdGuard Home - SmokePing
Debian 10 : Docker + Portainer - Nextcloud - Plex + Tautulli