> ## Documentation Index
> Fetch the complete documentation index at: https://blog.onetsolutions.net/llms.txt
> Use this file to discover all available pages before exploring further.

# AdGuard Home : bloquer pubs et traqueurs partout sur votre VPS

> AdGuard Home sur un VPS : un DNS privé chiffré (DNS-over-TLS) qui bloque pubs et traqueurs sur tous vos appareils. Installation Docker pas à pas, OnetSolutions.

![AdGuard Home : le tableau de bord, avec le nombre de requêtes DNS, les domaines bloqués et les clients les plus actifs](https://mintcdn.com/onetsolutions-blog/qDU15Upo4atDfpJO/images/2026/11/adguard-home.webp?fit=max\&auto=format\&n=qDU15Upo4atDfpJO\&q=85\&s=974e5a36e1100378b5facd2527a989cb)

*Publié le 22 novembre 2026*

Votre téléphone et votre portable contactent des dizaines de domaines publicitaires et de traqueurs chaque jour, chez vous comme en déplacement : AdGuard Home, installé sur un VPS, filtre ces requêtes DNS pour tous vos appareils, où qu'ils soient.

## Ce que AdGuard Home vous apporte

* **Bloquez** pubs, traqueurs, domaines de phishing et de malware au niveau DNS, sans logiciel à installer sur chaque appareil.
* **Chiffrez** vos requêtes DNS : AdGuard Home sert le DNS-over-HTTPS, le DNS-over-TLS et le DNS-over-QUIC sans logiciel supplémentaire.
* **Protégez** aussi les appareils qui n'acceptent aucun bloqueur : télévision connectée, enceinte, objets connectés.
* **Réglez** le filtrage appareil par appareil, avec vos propres listes et règles.
* **Suivez** l'activité de votre réseau depuis le tableau de bord et le journal des requêtes.

## En bref

| | |
| - | - |
| Licence | GPL-3.0 |
| Langage | Go (serveur), TypeScript (interface web) |
| Dernière version | v1.0.0, publiée le 19 novembre 2026 |
| Étoiles GitHub | 38 730 au 22 novembre 2026 |
| Ressources minimales | Non précisées par la documentation officielle |
| Dépôt | [github.com/AdguardTeam/AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) |

## Installer AdGuard Home sur votre VPS

Prérequis : un VPS Linux avec [Docker](https://help.onetsolutions.net/fr/tutorials/how-to-install-docker) et son plugin Compose, et un nom de domaine dont vous gérez la zone DNS.

Dans la zone de votre domaine, créez deux enregistrements `A` vers l'adresse IP du VPS : `dns.example.org` et `*.dns.example.org`. Le second sert aux identifiants de client (ClientID), présentés plus bas.

Créez le dossier du service. Les sous-dossiers `work` et `conf` gardent les données et la configuration entre deux mises à jour :

```bash theme={null}
# Dossier du service et volumes persistants
sudo mkdir -p /opt/adguardhome/work /opt/adguardhome/conf
cd /opt/adguardhome
```

La documentation officielle donne une commande `docker run`. Ce fichier `compose.yaml` la transpose fidèlement : même image, mêmes volumes, mêmes ports internes. Seuls les ports utiles sont publiés, et le DNS en clair comme l'interface d'administration restent limités au VPS lui-même :

```yaml theme={null}
# /opt/adguardhome/compose.yaml
services:
  adguardhome:
    image: adguard/adguardhome:v1.0.0
    container_name: adguardhome
    restart: unless-stopped
    volumes:
      - ./work:/opt/adguardhome/work
      - ./conf:/opt/adguardhome/conf
      # Certificats Let's Encrypt, en lecture seule
      - /etc/letsencrypt:/etc/letsencrypt:ro
    ports:
      # DNS en clair et assistant d'installation : VPS uniquement
      - "127.0.0.1:53:53/tcp"
      - "127.0.0.1:53:53/udp"
      - "127.0.0.1:3000:3000/tcp"
      # DNS-over-TLS (TCP) et DNS-over-QUIC (UDP), ouverts à Internet
      - "853:853/tcp"
      - "853:853/udp"
```

Démarrez le conteneur :

```bash theme={null}
sudo docker compose up -d
```

> [!NOTE]
>
> Sur Ubuntu, `systemd-resolved` occupe déjà le port 53. La [documentation Docker d'AdGuard Home](https://adguard-dns.io/kb/adguard-home/docker/) explique comment désactiver son `DNSStubListener` si le conteneur ne démarre pas.

## Premiers pas

1. **Lancez l'assistant.** Depuis votre poste, ouvrez un tunnel SSH vers le VPS, puis ouvrez `http://127.0.0.1:3000` dans votre navigateur :

   ```bash theme={null}
   ssh -L 3000:127.0.0.1:3000 utilisateur@ip-du-vps
   ```

   L'assistant vous fait choisir les interfaces d'écoute et créer le compte administrateur. Gardez le port `3000` pour l'interface web : c'est le seul que le tunnel atteint.

2. **Activez le chiffrement.** Obtenez un certificat Let's Encrypt avec [Certbot](https://certbot.eff.org) et le défi DNS recommandé par la documentation. Quand Certbot demande les noms, saisissez `dns.example.org *.dns.example.org` :

   ```bash theme={null}
   sudo certbot certonly --manual --preferred-challenges=dns --preferred-chain="ISRG Root X1"
   ```

   Dans **Paramètres → Paramètres de chiffrement**, renseignez le nom du serveur `dns.example.org`, puis les chemins `/etc/letsencrypt/live/dns.example.org/fullchain.pem` et `/etc/letsencrypt/live/dns.example.org/privkey.pem`. AdGuard Home recharge seul les fichiers donnés par chemin quand ils changent.

3. **Déclarez vos appareils.** Dans **Paramètres → Paramètres des clients**, ajoutez un client par appareil avec un ClientID, par exemple `telephone`. L'appareil utilise alors `tls://telephone.dns.example.org` en DNS-over-TLS. Sur Android, saisissez `telephone.dns.example.org` dans le champ « DNS privé ».

## Vérifier que tout fonctionne

Depuis le VPS, interrogez AdGuard Home sur un domaine publicitaire. La commande `host` est fournie par le paquet `bind9-host` :

```bash theme={null}
host doubleclick.net 127.0.0.1
```

Le domaine est bloqué par la liste de filtres activée par défaut. Avec le mode de blocage par défaut, la réponse est l'adresse nulle :

```text theme={null}
doubleclick.net has address 0.0.0.0
doubleclick.net has IPv6 address ::
```

Depuis votre téléphone, naviguez quelques minutes. Les requêtes doivent apparaître dans le **Journal des requêtes**, rattachées au client `telephone`.

## Sécuriser l'accès

Un résolveur DNS ouvert à tout Internet sert de relais aux attaques DDoS par amplification. Le fichier `compose.yaml` ci-dessus ne publie donc le port 53 que sur `127.0.0.1`. Seuls les protocoles chiffrés, sur le port 853, sont joignables de l'extérieur.

L'interface d'administration n'est jamais exposée : elle reste derrière le tunnel SSH. Le port HTTPS n'est pas publié non plus, car AdGuard Home sert l'interface web et le DNS-over-HTTPS sur le même port.

Limitez ensuite le service à vos appareils. Dans **Paramètres → Paramètres DNS → Paramètres d'accès**, inscrivez vos ClientID dans **Clients autorisés**, comme le recommande la documentation pour une instance publique. Tout autre client est refusé, y compris le test `host` lancé depuis le VPS.

Gardez la limite de requêtes par client activée : la documentation juge la valeur par défaut suffisante dans la plupart des cas.

> [!TIP]
>
> Le [pare-feu de la console](https://help.onetsolutions.net/fr/vps/firewall) ajoute une seconde barrière : n'autorisez en entrée que SSH et le port 853, en TCP et en UDP.

## Limites et alternatives

Un filtre DNS ne bloque pas une publicité servie par le même domaine que le contenu, comme celles de YouTube ou les publications sponsorisées des réseaux sociaux. Le DNS-over-HTTPS public demande en plus un reverse proxy qui ne relaie que `/dns-query`, avec le réglage `trusted_proxies` décrit dans la documentation sur le chiffrement.

| Alternative | Différence |
| - | - |
| [Pi-hole](https://pi-hole.net) | Même principe de filtrage DNS, mais le DNS-over-HTTPS et le DNS-over-TLS demandent des logiciels supplémentaires. |
| [Blocky](https://github.com/0xERR0R/blocky) | Proxy DNS bloqueur configuré par un fichier YAML, sans interface d'administration intégrée. |
| [Technitium DNS Server](https://technitium.com/dns/) | Serveur DNS complet, faisant aussi autorité sur vos zones, avec blocage par listes. |

## Pour aller plus loin

* [Documentation officielle d'AdGuard Home](https://adguard-dns.io/kb/adguard-home/getting-started/) : installation, [Docker](https://adguard-dns.io/kb/adguard-home/docker/), [chiffrement](https://adguard-dns.io/kb/adguard-home/encryption/) et [exploitation sécurisée](https://adguard-dns.io/kb/adguard-home/running-securely/)
* [Installer Docker](https://help.onetsolutions.net/fr/tutorials/how-to-install-docker) sur votre VPS
* [Règles de pare-feu](https://help.onetsolutions.net/fr/vps/firewall) : filtrer le trafic entrant depuis la console
* [Sécuriser un VPS Linux](https://blog.onetsolutions.net/fr/securite-renforcee-sur-un-vps-linux-conseils-et-outils-pour-proteger-vos-donnees-sensibles.md) : les autres réglages à faire dès l'installation

Pas encore de VPS chez OnetSolutions ? [Choisissez le vôtre](https://onetsolutions.net) et installez AdGuard Home en quelques minutes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.