[Tuto] installation de AdGuard Home en Docker sur Raspberry Pi

[Tuto] installation de AdGuard Home en Docker sur Raspberry Pi#94519

par EVOTk Grand Maître Jedi 07 sept. 2020 13:05

- 07 sept. 2020 13:05 #94519

Bonjour,
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 :

Code : Tout sélectionner

cd /media

AdGuard Home a besoin d'un dossier, avec deux sous-dossier /workdir et /confdir, avec cette commande, on créer l'ensemble :

Code : Tout sélectionner

sudo mkdir -p adguard/{workdir,confdir}

2/ Création du sous-réseau ( macvlan )

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 :

Code : Tout sélectionner

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

A adapter suivant votre cas :

Code : Tout sélectionner

--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.

Code : Tout sélectionner

--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

Code : Tout sélectionner

--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

Code : Tout sélectionner

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

Code : Tout sélectionner

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 :

Code : Tout sélectionner

docker run --name adguardhome --net adguard-network -v /media/adguard/workdir:/opt/adguardhome/work -v /media/adguard/confdir:/opt/adguardhome/conf -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 --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 :

Code : Tout sélectionner

-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.