J’étais à une conférence, téléphone en main, et j’avais besoin de ma forge Git, celle qui tourne à la maison et n’est joignable que depuis le réseau local. C’est exactement pour ça que j’ai un tunnel WireGuard sur le téléphone : je l’active, je suis « à la maison », et je tape https://forge.example.net. Ce jour-là, le navigateur m’a répondu que le site était introuvable. Le tunnel était pourtant connecté, l’icône de clé bien présente en haut de l’écran.

L’histoire vaut d’être racontée parce qu’il y avait trois causes, chacune cachée derrière la précédente, et qu’aucune n’était là où je l’attendais. Deux viennent du téléphone : un réglage d’Android que j’avais oublié, et un profil WireGuard sans serveur DNS. La troisième est un pare-feu, sur mon propre serveur, qui faisait exactement ce que je lui avais demandé des mois plus tôt.

Trois barrages sur le chemin d'une requête DNS du téléphone : le DNS privé d'Android (AdGuard) qui sort du tunnel, un profil WireGuard sans DNS qui laisse le DNS de l'opérateur, puis le pare-feu du Pi-hole qui jette les requêtes venues du tunnel ; après correction, le nom interne se résout et la forge s'ouvre
Chaque barrage cachait le suivant : aucune requête ne pouvait atteindre le pare-feu du Pi-hole tant que le téléphone demandait ailleurs.

Un nom qui n’existe qu’à la maison

Il faut d’abord comprendre ce que le téléphone demande. forge.example.net n’a aucun enregistrement dans le DNS public. C’est voulu : le service n’est accessible que de l’intérieur, et publier son nom, même pointé vers une adresse privée, révélerait à qui le cherche qu’il existe. Le nom n’existe que dans le Pi-hole de la maison, qui sert de DNS au réseau local et répond 192.168.10.17, l’adresse du serveur qui héberge la forge.

C’est ce qu’on appelle un DNS à horizon partagé, version minimale : dedans, le nom a une réponse ; dehors, il n’en a pas. Ça marche très bien tant que la question arrive au bon serveur. Tout le problème de cette journée est là : la question n’arrivait jamais au Pi-hole.

Séparer le tunnel du DNS

Face à « le site est introuvable avec le VPN », il y a deux suspects, et il faut les séparer avant de toucher à quoi que ce soit. Soit le tunnel ne passe pas, et rien n’atteint la maison. Soit le tunnel passe, mais le nom ne se résout pas. Le test qui tranche est bête : ouvrir, par le tunnel, une adresse IP de la maison, sans aucun nom. Si elle répond, le tunnel va bien et tout se joue dans le DNS.

Sur le Wi-Fi de la conférence, même l’adresse IP ne répondait pas. Sur les données mobiles, elle s’est affichée tout de suite. Le Wi-Fi d’un événement bloque très souvent le trafic UDP sortant vers des ports inhabituels, et WireGuard ne parle qu’en UDP ; je n’ai pas pu le vérifier sur ce réseau-là, mais le comportement colle. J’avais déjà un plan B pour ce genre d’endroit, un tunnel SSH qui passe par HTTPS sur le port 443, mais il ne sert qu’à SSH, pas à naviguer sur une forge. Restait donc le DNS, sur données mobiles.

Je ne voulais pas me fier à mon téléphone, alors j’ai cherché la preuve côté serveur. Le journal du serveur web de la maison montre bien les requêtes du téléphone, avec son adresse dans le tunnel :

# on the home server: did anything from the phone's tunnel address ever arrive?
grep -h '^10\.99\.0\.' /var/log/nginx/*.log | tail
10.99.0.10 - - [17/Nov/2026:12:42:56 +0100] "GET / HTTP/1.1" 301 166 "-" "Mozilla/5.0 (Android 16; Mobile ...)"
10.99.0.10 - - [17/Nov/2026:12:43:07 +0100] "GET /api/v2/receivers HTTP/2.0" 200 37 "https://192.168.10.17/" ...

Le tunnel est donc hors de cause. Et en cherchant plus loin dans le temps, aucune requête venue de 10.99.0.x n’était jamais arrivée sur la forge, ni sur aucun autre site de la maison, avant ce test par adresse IP. Le téléphone n’avait jamais réussi à trouver l’adresse de la forge.

Premier barrage : le « DNS privé » d’Android

Depuis la version 9, Android propose un réglage « DNS privé ». Il chiffre les requêtes DNS en DNS-over-TLS vers un fournisseur choisi. J’y avais mis AdGuard il y a longtemps, pour filtrer la publicité partout, et je l’avais oublié. Ce réglage a trois positions. Désactivé, le téléphone utilise le DNS annoncé par le réseau. En automatique, il essaie d’abord de parler en TLS à ce DNS annoncé, et retombe sur le DNS classique s’il ne sait pas. Avec un nom de fournisseur, il envoie toutes ses requêtes à ce fournisseur, et seulement à lui.

C’est ce dernier mode qui pose problème : il a priorité sur le DNS annoncé par le VPN. Le profil WireGuard peut bien indiquer le Pi-hole de la maison, Android l’ignore et continue de demander à AdGuard. Et AdGuard, qui ne connaît que le DNS public, répond honnêtement que forge.example.net n’existe pas. Le navigateur n’essaie même pas de se connecter.

La preuve, encore une fois, est côté serveur. Pi-hole garde toutes les requêtes dans une base SQLite. Debian ne fournit pas le client sqlite3 sur cette machine, mais FTL, le moteur DNS de Pi-hole, en embarque un :

# on the Pi-hole (Debian ships no sqlite3: FTL embeds one)
pihole-FTL sqlite3 /etc/pihole/pihole-FTL.db \
  "SELECT client, COUNT(*) FROM queries
   WHERE client LIKE '10.99.0.%' AND timestamp > strftime('%s','now','-30 days')
   GROUP BY client;"
# -> nothing at all

En trente jours, pas une seule requête venue du tunnel du téléphone. Les seuls clients à avoir demandé le nom de la forge étaient mon PC et le serveur de la maison lui-même. J’ai donc passé le DNS privé sur « désactivé » et réessayé. Le nom ne se résolvait toujours pas, et le journal du Pi-hole restait vide.

Deuxième barrage, sur le serveur : le pare-feu du Pi-hole

Un journal vide se lit de deux façons : soit la question ne part pas vers la maison, soit elle y arrive et quelque chose l’arrête avant le serveur DNS. Une requête qui arrive à FTL, même refusée, laisse une trace dans son journal. Plutôt que de deviner côté téléphone, j’ai relu le chemin côté serveur, et c’est là que j’ai trouvé un barrage que personne n’avait encore heurté.

Pi-hole filtre ses clients à deux endroits, et il faut que les deux soient d’accord. Le premier, c’est FTL lui-même, avec son réglage dns.listeningMode. Par défaut, en LOCAL, il ne répond qu’aux machines des sous-réseaux directement branchés sur ses interfaces, et ignore tout ce qui arrive routé, comme un client VPN. Chez moi, il était déjà sur ALL :

pihole-FTL --config dns.listeningMode
ALL

Le second, c’est le pare-feu de la machine. Le Pi-hole tourne sur une Debian, protégée par ufw, et le port 53 n’y est ouvert qu’à une liste de sources. Cette liste contenait le réseau local et le tunnel de mes serveurs, mais pas le tunnel du téléphone :

ufw status | grep '^53/'
53/tcp                     ALLOW       192.168.10.0/24
53/udp                     ALLOW       192.168.10.0/24
53/tcp                     ALLOW       10.98.0.0/24
53/udp                     ALLOW       10.98.0.0/24

Un paquet venu de 10.99.0.10 aurait donc été jeté par le noyau avant d’atteindre FTL, sans que FTL n’en sache jamais rien. C’est la pire forme de panne réseau : aucune erreur, aucun journal, juste un délai d’attente côté client. Le plus vexant, c’est que j’étais déjà tombée dans exactement le même piège trois mois plus tôt, avec le tunnel des serveurs. J’avais même laissé un commentaire dans la configuration pour avertir que les deux filtres doivent autoriser une source. Le téléphone, lui, n’avait jamais été ajouté.

La correction, dans Ansible et pas à la main

La liste des sources autorisées est une variable du rôle Ansible du Pi-hole, et la tâche qui ouvre le pare-feu boucle dessus, pour TCP et pour UDP. Corriger, c’est ajouter une ligne :

# roles/pihole/defaults/main.yml
pihole_dns_allowed_sources:
  - "192.168.10.0/24"
  - "10.98.0.0/24"      # servers' tunnel
  - "10.99.0.0/24"      # phone's tunnel   <- the missing line

# roles/pihole/tasks/firewall.yml
- name: Allow DNS from the allowed sources
  community.general.ufw:
    rule: allow
    port: "53"
    proto: "{{ item.1 }}"
    src: "{{ item.0 }}"
  loop: "{{ pihole_dns_allowed_sources | product(['tcp', 'udp']) | list }}"

Avant d’appliquer, je fais toujours un essai à blanc limité à cette partie du rôle. Il doit montrer que seules les deux nouvelles règles changent, et que les autres sont déjà en place. Une règle ajoutée à la main sur la machine aurait marché tout de suite, mais aurait disparu ou divergé au prochain passage d’Ansible ; c’est la configuration qui doit porter la correction, pas la machine.

ansible-playbook -i hosts.ini playbooks/pihole.yml --tags pihole-firewall --check --diff
# ok:      10.98.0.0/24/tcp, 10.98.0.0/24/udp
# changed: 10.99.0.0/24/tcp, 10.99.0.0/24/udp      <- only these two
ansible-playbook -i hosts.ini playbooks/pihole.yml --tags pihole-firewall

Il existait un contournement sans toucher au serveur : donner au téléphone le routeur comme DNS, au lieu du Pi-hole. Le routeur répond au DNS sur son adresse du tunnel, et transmet la question au Pi-hole depuis sa propre adresse sur le réseau local, que le pare-feu accepte. C’est utile pour se débloquer en cinq minutes depuis une salle de conférence, mais ça ne fait que cacher le problème.

Une autre solution est tentante et je l’ai écartée : publier le nom de la forge dans le DNS public, pointé vers son adresse privée. Ça aurait marché même avec AdGuard. Mais ça annonce au monde le nom d’un service interne, pour contourner un réglage de téléphone.

Troisième barrage : le profil WireGuard n’avait pas de DNS

Le pare-feu corrigé, la forge ne s’ouvrait toujours pas, et le compteur de la nouvelle règle restait à zéro paquet : rien n’arrivait jusqu’à elle. La question ne partait donc toujours pas vers la maison. En ouvrant le profil WireGuard du téléphone, la réponse était là : le champ « serveurs DNS » de l’interface était vide. Sans lui, l’application ne pousse aucun DNS à Android, qui garde celui du réseau, ici celui de l’opérateur mobile. Lequel, comme AdGuard, ne connaît pas mon nom interne.

C’est le piège le plus simple des trois, et celui qu’AdGuard masquait le mieux : tant que le DNS privé envoyait tout ailleurs, le contenu de ce champ ne changeait rien. Il faut ensuite couper et rallumer le tunnel, parce que le DNS n’est appliqué qu’à la connexion.

Vérification

Avec 192.168.10.19 dans le profil et le tunnel relancé, la forge s’est ouverte sur le téléphone. Les deux journaux le confirment, à douze secondes d’écart : le Pi-hole a répondu à la question venue du tunnel, puis la forge a servi le tableau de bord à la même adresse.

# Pi-hole, 12:56:19: the phone's query, answered from the home DNS
query[A] forge.example.net from 10.99.0.10
config forge.example.net is <CNAME>
/etc/pihole/hosts/custom.list homeserver.example.lan is 192.168.10.17
# the ufw rule added at 12:50, counter on the UDP line
counter packets 79 ... accept
# the home server, 12:56:31: the forge serves the phone's dashboard
10.99.0.10 - - [17/Nov/2026:12:56:31 +0100] "GET /repo/search?sort=updated&order=desc&uid=1 ... HTTP/2.0" 200 ...

Le compteur de la règle ajoutée dans ufw à 12:50 avait déjà laissé passer 79 paquets. Sans cette correction, ces requêtes auraient été jetées en silence et le troisième barrage enlevé n’aurait rien changé : les trois corrections étaient nécessaires, et aucune ne suffisait seule. J’ai ensuite fait la contre-épreuve : DNS privé réactivé sur AdGuard, DNS du Pi-hole toujours dans le profil WireGuard. La forge redevient introuvable. Le réglage d’Android l’emporte bien sur le DNS du VPN, même quand le profil en indique un.

Ce que j’en retiens

Quand quelque chose ne marche pas « par le VPN », la première question n’est pas « le VPN est-il connecté ? », mais « qu’est-ce qui passe réellement dedans ? ». Ouvrir une adresse IP par le tunnel sépare le transport du DNS en dix secondes, et les journaux du serveur disent la vérité quand le téléphone ne dit rien.

Un résolveur DNS chiffré réglé sur le téléphone passe avant le DNS du VPN : avec un nom de fournisseur dans « DNS privé », les noms internes ne marcheront jamais par le tunnel. Et un profil VPN sans serveur DNS laisse le téléphone sur le DNS de l’opérateur. Et sur le serveur, l’absence de trace dans le journal de Pi-hole est un indice en soi : elle veut dire que le paquet n’est pas arrivé, donc qu’un pare-feu l’a arrêté avant. Chaque nouveau sous-réseau de VPN doit être ajouté à la liste des sources DNS autorisées, dans les deux filtres. Cette fois, j’ai écrit la procédure, pour ne pas tomber une troisième fois dans le même trou.