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 :
AdGuard Home a besoin d'un dossier, avec deux sous-dossier /workdir et /confdir, avec cette commande, on créer l'ensemble :
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 :
A adapter suivant votre cas :
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.
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
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
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
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 :
/!\ Attention : 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, cela ce passe dans cette partie de la commande :
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 destiné à AdGuard Home et le port 3000
Exemple :
=> dans mon tuto 192.168.0.61, donc l'acces ce fait par http://192.168.0.61:3000
Apres cette 1ere configuration, l'acces se fera simplement par 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.
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:
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:
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:
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:
--subnet=192.168.0.0/24
Code:
--gateway=192.168.0.254
Code:
--ip-range=192.168.0.61/32
Code:
parent=eth0
Code:
ifconfig
3/ Création du conteneur
En SSH, nous allons exécuter cette commande afin de créer le conteneur :
Code:
docker run -d --name adguardhome --net adguard-network -v /media/adguard/workdir:/opt/adguardhome/work -v /media/adguard/confdir:/opt/adguardhome/conf --restart unless-stopped adguard/adguardhome
/!\ Attention : 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, cela ce passe dans cette partie de la commande :
Code:
-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 destiné à AdGuard Home et le port 3000
Exemple :
=> dans mon tuto 192.168.0.61, donc l'acces ce fait par http://192.168.0.61:3000
Apres cette 1ere configuration, l'acces se fera simplement par 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-05-21 - Rajout de précision pour la 1ere connexion à l'interface d'administration.
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 )