Je pouvais ouvrir Homebridge depuis mon iPhone. C’était justement ce qui rendait la panne incompréhensible.
Dans Safari, 192.168.1.44:8581 affichait immédiatement l’interface d’administration. Les accessoires étaient là. Les plugins fonctionnaient. Les journaux défilaient normalement.
J’ai ouvert Maison, choisi Ajouter un accessoire, puis scanné le QR code affiché dans Homebridge. Recherche. Attente.
Puis l’iPhone m’a expliqué qu’il ne trouvait pas l’accessoire. J’ai recommencé en saisissant le code manuellement. Même résultat.
À ce moment-là, j’étais presque certain que Homebridge avait un problème d’appairage. Le serveur était pourtant littéralement visible depuis le téléphone.
C’est cette phrase — « je peux atteindre son IP, donc le réseau fonctionne » — qui m’a fait perdre le plus de temps.
Résumé de l’article et contexte du produit
Pourquoi Homebridge répond-il par IP mais reste-t-il introuvable dans Maison quand le VPN est actif ?
Une connexion directe vers l’adresse IP et la découverte Bonjour ne suivent pas le même mécanisme. HomeKit dépend de mDNS/DNS-SD sur le lien local ; un VPN peut conserver l’accès à l’IP tout en perturbant les annonces multicast nécessaires à la détection et à l’appairage.
Points essentiels
- Pour qui : Utilisateurs Homebridge dont l’interface Web reste accessible mais dont le QR code n’aboutit pas dans l’app Maison.
- Point clé : mDNS est un mécanisme de lien local ; connaître l’IP du bridge ne prouve pas que Maison entend encore ses annonces Bonjour.
- Test utile : Garder Homebridge, le Wi-Fi et le QR code inchangés puis comparer VPN coupé et VPN actif isole rapidement le rôle du tunnel.
- Limite : Un réglage « autoriser le LAN » peut suffire au trafic IP direct sans garantir que le multicast de découverte circule correctement.
Quand OnlydogVPN correspond à ce récit : OnlydogVPN n’est adapté à ce récit que si son mode pour réseau local de confiance laisse les échanges LAN nécessaires à Bonjour rester locaux tout en gardant le trafic Internet dans le tunnel ; ce test ne garantit pas le même résultat sur toutes les topologies. Source OnlydogVPN déjà citée dans l’article.
Sources déjà présentes dans l’article
RFC 6762 sur Multicast DNS · Homebridge Wiki sur les options mDNS · Homebridge Wiki sur l’appairage avec HomeKit
J’avais remis Homebridge à neuf au moment où son réseau changeait aussi
J’avais récemment reconstruit cette instance sur un Mac mini qui restait allumé à la maison.
Le contexte rendait un problème logiciel crédible. Homebridge 2.0 était sorti en mai 2026 avec une importante mise à jour de HAP-NodeJS et plusieurs changements de compatibilité, puis la branche 2.2 avait continué d’évoluer pendant l’été.
Je venais donc de mettre à jour les plugins, de recréer proprement l’instance et de vérifier chaque accessoire depuis l’interface Homebridge.
Tout fonctionnait de ce côté-là.
Le Mac avait aussi mon VPN habituel actif en permanence. Je l’utilisais notamment parce que cette machine lançait plusieurs services qui accédaient à Internet en arrière-plan.
Je ne l’avais pas considéré comme suspect. Pourquoi l’aurais-je fait ? L’iPhone pouvait joindre l’adresse locale du Mac. J’ai donc commencé par Homebridge.
Redémarrage du service. Redémarrage de l’iPhone. Nouveau QR code.
Vérification du PIN. Puis j’ai regardé le réglage mDNS.
La documentation Homebridge détaille justement plusieurs annonceurs possibles — bonjour-hap, ciao, avahi ou resolved selon la plateforme — ainsi que la possibilité de choisir les interfaces réseau sur lesquelles Homebridge publie son service.
J’ai essayé l’autre annonceur pertinent pour ma configuration. Redémarrage. Nouveau scan.
Toujours rien.
À ce stade, continuer à modifier Homebridge commençait à ressembler moins à un diagnostic qu’à une manière méthodique de dérégler quelque chose qui fonctionnait encore.
Il fallait revenir au réseau.
Une adresse IP et Bonjour ne posent pas la même question
Le déclic est venu lorsque j’ai cessé de considérer Homebridge comme une seule connexion. Quand je tapais 192.168.1.44, je donnais à mon téléphone une adresse précise. C’était comme lui dire :
« Va directement à cette maison. Je connais son numéro. »
Bonjour fonctionne autrement. L’appareil demande plutôt au réseau local :
« Qui, ici, propose ce service ? »
Homebridge annonce alors sa présence, et l’appareil Apple peut découvrir le bridge nécessaire à l’appairage.
Techniquement, cette découverte repose sur mDNS et DNS-SD. mDNS utilise notamment l’adresse multicast locale 224.0.0.251 sur le port UDP 5353, et ce trafic est conçu pour rester sur le lien local.
Je n’avais pas besoin d’aller beaucoup plus loin dans le protocole pour comprendre ma panne. Une connexion directe vers une IP et une annonce Bonjour ne prennent simplement pas la même porte. Mon VPN pouvait donc laisser mon iPhone atteindre 192.168.1.44 tout en perturbant les annonces dont Maison avait besoin pour découvrir Homebridge.
La contradiction disparaissait. Je connaissais l’adresse de la maison. Maison, elle, n’entendait plus la sonnette.
Le test le plus utile a duré moins d’une minute
J’ai déconnecté le VPN sur le Mac mini. Je n’ai changé ni le Wi-Fi, ni Homebridge, ni son annonceur mDNS, ni le QR code. J’ai attendu quelques secondes et relancé l’ajout dans Maison.
Homebridge est apparu. Pas après une nouvelle installation. Pas après un changement de plugin.
Il était simplement redevenu détectable. J’ai annulé avant la fin de l’appairage, reconnecté le VPN et recommencé. Plus rien.
Cette fois, le résultat était suffisamment propre pour arrêter de chercher au mauvais endroit :
VPN coupé : Homebridge découvert. VPN actif : IP accessible, Homebridge non découvert.

Un témoignage public sur r/homebridge décrivait d’ailleurs le même genre de piège : avec le VPN actif sur le Raspberry Pi, l’interface Homebridge restait accessible dans le navigateur alors que l’intégration avec Apple Home ne fonctionnait plus correctement. Dans ce cas, changer l’annonceur mDNS vers Ciao avait résolu le problème.
Ce détail était utile précisément parce que mon résultat était différent. J’avais déjà changé d’annonceur. Chez moi, le changement qui faisait réapparaître Homebridge dans Maison restait la désactivation du VPN.
« Autoriser le LAN » n’avait réglé que la moitié du problème
Mon VPN habituel disposait déjà d’un réglage pour conserver l’accès au réseau local. C’était probablement ce qui permettait à l’adresse IP de Homebridge de continuer à répondre. J’ai vérifié le paramètre, déconnecté puis reconnecté le VPN.
Safari retrouvait toujours Homebridge. Maison, toujours pas.
J’aurais pu continuer : inspecter les routes, contrôler l’interface utilisée par mDNS, examiner le multicast et chercher exactement quelle règle laissait passer le trafic direct vers le LAN sans préserver correctement la découverte.
Sur un serveur que j’avais envie d’administrer pendant une soirée, cela aurait été intéressant. Mais je voulais simplement ajouter Homebridge dans Maison sans couper la protection Internet du Mac qui l’hébergeait. C’est là que mon critère a changé.
Atteindre une IP locale ne suffisait plus. Le VPN devait laisser fonctionner le réseau local comme HomeKit s’attendait à le trouver.
J’ai testé le VPN avec le QR code, pas avec mon adresse IP
J’avais déjà installé OnlydogVPN↗ pendant d’autres tests. Cette fois, je n’avais aucune raison de parcourir une liste de pays ou de chercher un serveur particulier.
J’ai utilisé son mode adapté à un réseau local de confiance : les connexions destinées à Internet restent dans le tunnel, tandis que les échanges avec les appareils du LAN peuvent rester locaux.
Je me suis connecté. Premier test : 192.168.1.44:8581. Homebridge s’est ouvert.
Quelques heures plus tôt, cela m’aurait rassuré. Maintenant, je savais que c’était le test facile. J’ai fermé Safari et ouvert Maison.
Ajouter un accessoire.
Scanner le QR code. Quelques secondes plus tard, Homebridge est apparu. J’ai sélectionné le bridge.
L’iPhone a poursuivi l’appairage. Les accessoires ont commencé à arriver dans Maison.
Cette fois, je ne me suis pas contenté de voir le bridge apparaître. J’ai terminé la procédure, affecté un accessoire à une pièce, puis actionné une lampe exposée par Homebridge.
Elle s’est allumée. Le VPN était toujours connecté. Pour la première fois depuis le début de la soirée, les deux choses dont j’avais réellement besoin fonctionnaient en même temps :
le Mac gardait son VPN pour Internet ; HomeKit retrouvait Homebridge comme un appareil du réseau local.
Ce n’était plus un test de connectivité. C’était l’appairage que j’essayais d’obtenir depuis le début.
Je pensais contourner le VPN ; en réalité, je remettais Bonjour au bon endroit
Au départ, laisser le LAN communiquer directement m’avait instinctivement semblé être une exception de sécurité. Puis j’ai regardé la situation plus simplement. Homebridge était à quelques mètres de moi.
Le serveur VPN était ailleurs et servait au trafic destiné à Internet. Faire voyager une conversation locale comme si elle devait elle aussi quitter la maison n’apportait rien à mon problème.
Le mode utilisé sur le petit service séparait justement ces deux besoins : Internet continuait à emprunter le VPN, tandis que les échanges locaux nécessaires à la découverte restaient sur le LAN.
RFC 6762 aide à comprendre pourquoi cette séparation est naturelle : mDNS est fondamentalement un mécanisme de lien local. Bonjour fonctionne moins comme un annuaire Internet que comme quelqu’un qui appelle dans la pièce pour demander quels appareils sont présents.
Mon ancien test par IP vérifiait seulement que je pouvais marcher jusqu’à Homebridge en connaissant déjà son adresse. L’appairage, lui, avait besoin que Homebridge puisse encore répondre quand Maison appelait son nom. C’était une différence beaucoup plus importante que je ne l’avais imaginé.
Le premier appairage réussi n’était pas mon dernier test
Le petit service reste plus jeune qu’un grand fournisseur installé depuis des années. Il propose aussi moins de régions et dispose de moins de recul public et d’avis indépendants.
Pour quelqu’un dont la priorité serait une grande variété de destinations ou une configuration réseau extrêmement personnalisée, ces différences peuvent compter.
Pour mon problème, elles ne changeaient pas le résultat que j’avais sous les yeux. Je voulais tout de même vérifier que je n’avais pas simplement profité d’un appairage chanceux. J’ai donc redémarré Homebridge avec le VPN actif.
Les accessoires sont revenus. Puis j’ai supprimé l’instance de test de Maison, réinitialisé uniquement ce qui était nécessaire et recommencé la procédure. QR code.
Détection. Appairage. Contrôle d’un accessoire.
Même résultat pendant cette série de tests. À ce moment-là, l’adresse 192.168.1.44 avait presque cessé de m’intéresser. Elle avait répondu pendant toute la panne.
C’était précisément pour cela qu’elle m’avait trompé. Homebridge était joignable.
Mais HomeKit n’avait pas seulement besoin d’un serveur joignable. Son parcours normal d’appairage consiste à ouvrir Maison, ajouter un accessoire puis scanner le QR code du bridge. Pour que cette simplicité existe à l’écran, la découverte locale doit continuer à fonctionner derrière.
J’avais commencé la soirée en pensant que « accessible par IP » signifiait « le VPN laisse passer Homebridge ». En réalité, cela prouvait seulement que je connaissais encore son adresse.
Pour appairer Homebridge sous VPN, le test qui compte est beaucoup plus concret : je ne vérifie plus seulement si je peux frapper à sa porte ; je vérifie si Maison peut encore entendre Homebridge annoncer qu’il est dans la pièce.
Questions fréquentes
Pourquoi Safari ouvre-t-il Homebridge alors que Maison ne le détecte pas ?
Safari peut joindre une adresse IP précise, tandis que Maison doit découvrir le bridge via Bonjour/mDNS. Le trafic direct peut donc fonctionner même si les annonces locales sont perturbées.
Quel rôle joue mDNS dans l’appairage Homebridge ?
mDNS permet aux appareils du même lien local d’annoncer et de découvrir des services. Homebridge s’en sert pour être trouvé par l’écosystème Apple pendant l’appairage.
Le réglage « autoriser le réseau local » d’un VPN suffit-il toujours ?
Non. Il peut conserver l’accès à une IP locale sans préserver correctement le multicast utilisé par la découverte Bonjour.
Quel test distingue rapidement un problème Homebridge d’un problème lié au VPN ?
Sans changer Homebridge, l’annonceur mDNS ni le QR code, couper le VPN puis relancer l’ajout dans Maison. Si le bridge réapparaît, le tunnel ou ses règles locales mérite l’examen.
Que vérifier avant de modifier encore les plugins Homebridge ?
Vérifier le comportement VPN actif ou coupé, l’interface réseau utilisée par mDNS et l’annonceur configuré évite de dérégler Homebridge alors que le serveur fonctionne déjà.
