La réponse courte
À la maison, AmazHA, une app Home Assistant pour montres Amazfit, n’a besoin que de votre adresse locale, comme http://192.168.1.50:8123, et rien ne doit être joignable depuis l’extérieur. Hors de chez vous, votre téléphone a besoin d’une adresse distante qu’il peut joindre : Home Assistant Cloud, un VPN comme Tailscale ou WireGuard, ou votre propre domaine en HTTPS. Saisissez les deux, et AmazHA choisit d’elle-même celle qui fonctionne.
À la maison, rien de plus n’est nécessaire
Sur votre réseau domestique, la seule adresse dont AmazHA a besoin est celle que vous utilisez déjà pour ouvrir Home Assistant dans un navigateur à la maison. C’est le champ URL locale (LAN) des réglages d’AmazHA, et il suffit à lui seul : pas d’abonnement, pas de VPN, pas de domaine, pas de port ouvert sur votre box ou votre routeur.
AmazHA a deux champs d’adresse dans ses réglages : URL locale (LAN) et URL distante. L’un ou l’autre peut rester vide. Si vous n’utilisez la montre qu’à la maison, remplissez le champ local, laissez le champ distant vide, et c’est terminé. Vous pourrez ajouter une adresse distante plus tard, le jour où vous voudrez que la montre fonctionne au bureau ou en vacances, sans toucher à rien d’autre.
Les champs se trouvent dans l’app Zepp, sous Profil › votre montre › Applications › AmazHA › Paramètres › Home Assistant. Ils apparaissent une fois la version complète débloquée (un déblocage unique, sans abonnement) : la version gratuite est une démo en direct sur des données d’exemple et ne se connecte à aucun serveur. Le tutoriel Connecter Home Assistant montre en vidéo l’étape de l’adresse locale.
Une adresse locale typique ressemble à l’une de celles-ci (des exemples, utilisez la vôtre) :
http://192.168.1.50:8123
http://homeassistant.local:8123
Si vous tapez une adresse sans http:// ni https:// dans URL locale (LAN), AmazHA ajoute http:// devant, parce que les serveurs locaux parlent en général le simple http.
Pourquoi c’est votre téléphone qui doit joindre Home Assistant
La montre ne parle jamais elle-même à Home Assistant. Elle parle à votre téléphone en Bluetooth, et la partie d’AmazHA qui tourne dans l’app Zepp du téléphone est la seule qui envoie des requêtes à votre serveur. La question « ma montre peut-elle joindre Home Assistant ? » revient donc à « mon téléphone peut-il joindre Home Assistant, maintenant, depuis là où il est ? »
Cela a quelques conséquences pratiques :
- La montre n’a pas besoin du Wi-Fi. Elle ne rejoint jamais de réseau pour AmazHA. Une montre uniquement Bluetooth fonctionne de la même façon.
- Le téléphone doit être à proximité, avec le Bluetooth activé et l’app Zepp lancée. Sinon, la montre affiche Hors ligne · Le téléphone ne répond pas, ce qui est un autre problème qu’une mauvaise adresse (voir le dépannage, étape 2).
- C’est le réseau du téléphone qui décide de l’adresse qui fonctionne. Sur votre Wi-Fi domestique, l’adresse locale fonctionne. Sur les données mobiles, chez un ami ou sur le Wi-Fi d’un hôtel, seule une adresse distante peut fonctionner, et seulement si le téléphone peut la joindre depuis là.
- Un VPN doit être connecté sur le téléphone, pas sur la montre. La montre n’en sait rien.
- Votre jeton reste sur le téléphone. Vous collez une seule fois un jeton d’accès longue durée, dans les réglages d’AmazHA. La montre ne reçoit que ce qu’elle affiche, par la liaison Bluetooth qu’elle a déjà avec le téléphone ; le jeton ne lui est jamais envoyé.
Cela explique une situation déroutante : les réglages indiquent Connecté et la montre affiche Hors ligne. Les réglages ne testent que le chemin du téléphone vers Home Assistant ; la montre a aussi besoin du chemin Bluetooth vers le téléphone.
Comment AmazHA choisit l’adresse
AmazHA choisit l’adresse d’elle-même, d’abord la locale, puis la distante. Il n’y a aucun interrupteur à basculer quand vous quittez la maison, et vous ne choisissez jamais à la main entre les deux champs.
Avec une seule adresse
Avec un seul champ rempli, AmazHA l’utilise, tout simplement. Rien n’est sondé, rien n’est basculé. Une configuration uniquement locale fonctionne à la maison et affiche la bannière Hors ligne à l’extérieur ; une configuration uniquement distante fonctionne partout où le téléphone peut joindre cette adresse.
Avec les deux adresses
Avec les deux champs remplis, le téléphone demande aux deux adresses en même temps si Home Assistant répond, avec un court délai de 1,5 seconde. Si l’adresse locale répond, AmazHA l’utilise. Si seule la distante répond, elle utilise celle-là. L’adresse gagnante est mémorisée : les requêtes suivantes y vont directement, sans redemander.
Le contrôle est plus strict que « quelque chose a répondu ». Une adresse ne compte que si elle répond en tant qu’API Home Assistant. Cela compte sur les réseaux des autres : sur le Wi-Fi d’un hôtel, 192.168.1.50 peut être une imprimante, la page d’un routeur ou un portail captif qui répond par une page web. AmazHA ne la confond pas avec votre serveur, et ne reste donc pas bloquée sur votre adresse locale alors que la bonne réponse est votre adresse distante.
Partir de chez soi et rentrer
L’adresse mémorisée est conservée jusqu’à ce qu’une requête vers elle échoue. Quand vous quittez la maison et que le téléphone perd votre Wi-Fi, la requête suivante vers l’adresse locale échoue, AmazHA l’oublie, et la tentative suivante interroge à nouveau les deux adresses et retombe sur la distante. Tant que l’app AmazHA est ouverte, la montre s’actualise toutes les 8 secondes : en pratique, la première actualisation après le basculement peut échouer et afficher brièvement la bannière Hors ligne, et la suivante rétablit la situation.
Le retour à la maison se passe dans l’autre sens, plus discrètement : si votre adresse distante fonctionne aussi depuis l’intérieur de votre réseau, AmazHA continue de l’utiliser jusqu’à ce qu’une requête échoue ou que vous touchiez à nouveau Connecter. Rien d’anormal dans ce cas ; l’adresse distante fonctionne simplement toujours.
Saisir les adresses
Quelques détails sont bons à savoir quand vous remplissez les champs :
- Rien après l’adresse du serveur.
http://192.168.1.50:8123, et nonhttp://192.168.1.50:8123/lovelace. Il en va de même pour l’adresse distante :https://xxxxx.ui.nabu.casa, et nonhttps://xxxxx.ui.nabu.casa/lovelace. Si un chemin reste à la fin, l’adresse répond, mais pas en tant qu’API Home Assistant. - Le schéma. Sans schéma saisi, URL locale (LAN) reçoit
http://et URL distante reçoithttps://. Tapezhttp://vous-même si une adresse distante est vraiment en simple http (une adresse VPN, par exemple). - Le port. Gardez le port si votre adresse en a besoin, comme dans
:8123. Sans port,https://signifie 443. - Un seul jeton pour les deux. Collez-le une fois dans Jeton d’accès longue durée ; il sert pour l’adresse locale et pour la distante. Les deux adresses doivent mener au même Home Assistant.
Le tutoriel Connecter Home Assistant couvre l’étape de l’adresse distante, et l’étape 8 le test qui suit.
Les options d’accès à distance comparées
N’importe quelle adresse distante fonctionne avec AmazHA, du moment que le téléphone peut l’ouvrir depuis là où il est et qu’elle répond en tant qu’API Home Assistant. Le choix relève de Home Assistant, pas d’AmazHA. Voici les options courantes côte à côte.
| Option | Ce qui va dans URL distante | Ports ouverts à la maison | HTTPS et certificat | Coût | Ce qu’il faut au téléphone |
|---|---|---|---|---|---|
| Home Assistant Cloud de Nabu Casa (qui deviendra Home Assistant Link le 2 décembre 2026) | L’adresse distante qu’il génère pour vous, https://xxxxx.ui.nabu.casa |
Aucun | Inclus | Abonnement | Rien de plus |
| VPN, comme Tailscale ou WireGuard | L’adresse de Home Assistant à l’intérieur du VPN | Aucun pour Tailscale ; un pour un serveur WireGuard auto-hébergé | Le tunnel est chiffré ; https seulement si vous le configurez | Il existe des options gratuites | Le VPN connecté |
| Votre propre domaine via un tunnel, comme Cloudflare Tunnel | https://ha.example.com |
Aucun | Fourni par le tunnel | En général, un domaine | Rien de plus |
| Votre propre domaine avec un reverse proxy | https://ha.example.com |
Un (en général le 443) | À configurer vous-même, par exemple Let’s Encrypt | Un domaine ou un nom DNS dynamique gratuit | Rien de plus |
| Redirection de port directement vers Home Assistant | https://yourname.duckdns.org:8123 |
Un | À configurer vous-même | Il existe des DNS dynamiques gratuits | Rien de plus |
Home Assistant Cloud (bientôt Home Assistant Link)
Home Assistant Cloud est le service par abonnement géré par Nabu Casa ; ses abonnements financent le développement à plein temps de Home Assistant. La documentation de Home Assistant le présente comme l’option la plus simple pour la plupart des gens : il ne demande aucun port ouvert sur le routeur, il chiffre le trafic et il génère pour vous une URL distante unique.
Pour AmazHA, cette URL distante est tout ce qu’il vous faut : copiez-la, telle que Home Assistant l’affiche, dans URL distante, sans rien après. Votre jeton d’accès longue durée fonctionne par elle exactement comme sur votre adresse locale, puisque les deux mènent au même serveur.
Le 2 octobre 2026, Nabu Casa a annoncé que Home Assistant Cloud serait renommé Home Assistant Link le 2 décembre 2026. L’annonce précise qu’il s’agit du même abonnement sous un nouveau nom et qu’aucune action n’est nécessaire. Elle ne mentionne aucun changement d’adresse : il n’y a donc rien à changer dans AmazHA aujourd’hui.
Un VPN : Tailscale, WireGuard et autres
Un VPN place votre téléphone sur votre réseau domestique, virtuellement, où qu’il soit. La documentation de Home Assistant cite des services VPN comme Tailscale et ZeroTier One comme un accès sûr, et en souligne la contrepartie : le VPN doit être connecté avant que quoi que ce soit puisse joindre Home Assistant depuis l’extérieur. Pour AmazHA, cela veut dire que le VPN doit être connecté sur le téléphone. S’il décroche, la montre affiche Hors ligne · Home Assistant injoignable jusqu’à son retour.
Ce qui va dans URL distante, c’est l’adresse qu’utilise votre téléphone pour Home Assistant quand le VPN est actif : l’adresse du serveur à l’intérieur du VPN, ou un nom que votre VPN résout pour lui. Deux détails :
- Si votre serveur y répond en simple http, tapez
http://devant l’adresse. Sans schéma, AmazHA ajoutehttps://à l’adresse distante, qui ne répondrait pas. - Avec certaines configurations VPN, votre adresse domestique elle-même,
192.168.1.50, devient joignable par le tunnel. L’adresse locale fonctionne alors partout où le VPN est actif, et le champ distant sert de solution de repli quand il ne l’est pas.
Le VPN est l’option la moins exposée : rien de votre serveur n’est ouvert sur internet. La contrepartie, c’est que chaque appareil qui a besoin de Home Assistant, téléphone compris, doit faire tourner le client VPN.
Votre propre domaine en HTTPS : un reverse proxy ou un tunnel
Avec votre propre domaine, https://ha.example.com mène à votre Home Assistant depuis n’importe où. Deux façons courantes d’y arriver :
- Un reverse proxy (Nginx, Caddy, Traefik ou équivalent) à la maison reçoit les requêtes sur le port 443, gère le certificat et transmet les requêtes à Home Assistant. Il faut une redirection de port sur votre routeur.
- Un tunnel, comme Cloudflare Tunnel, fait tourner un petit connecteur dans votre réseau qui garde une connexion sortante ouverte vers le fournisseur : rien n’est ouvert sur votre routeur. Le fournisseur sert votre domaine avec un certificat valide.
Dans les deux cas, quelque chose se place devant Home Assistant et lui transmet les requêtes, et il faut dire à Home Assistant de lui faire confiance. La documentation de Home Assistant est explicite : les requêtes d’un reverse proxy sont bloquées tant que vous n’activez pas Trust X-Forwarded-For (faire confiance à X-Forwarded-For) et n’ajoutez pas le proxy à Trusted proxies (proxys de confiance). Si vous sautez cette étape, chaque requête passant par le proxy reçoit 400 Bad Request (on y revient plus bas).
La redirection de port seule
Rediriger un port du routeur directement vers Home Assistant est le moyen le plus direct, et celui pour lequel la documentation de Home Assistant sur l’accès à distance se montre la plus prudente : ouvrir simplement un port n’est pas sûr, le trafic doit être chiffré, et vous devriez parcourir sa liste de contrôle de sécurité avant d’exposer quoi que ce soit. Elle signale aussi deux pièges pratiques : beaucoup de fournisseurs d’accès attribuent une adresse IP dynamique, d’où sa suggestion d’un nom DNS dynamique comme DuckDNS, et certains placent leurs abonnés derrière du CG-NAT, où les connexions entrantes ne peuvent pas du tout les joindre.
Si vous choisissez cette voie, l’adresse distante est votre nom DNS dynamique en https avec le port que vous avez redirigé, par exemple https://yourname.duckdns.org:8123. Mettez exactement cela dans URL distante.
HTTPS et certificats hors de chez vous
Hors de chez vous, la règle du tutoriel En cas de problème est courte : l’adresse doit être en https avec un certificat valide. Il y a deux raisons à cela.
La première est la sécurité. Votre jeton d’accès longue durée accompagne chaque requête qu’envoie le téléphone. En simple http sur l’internet ouvert, n’importe qui sur le trajet peut le lire, et avec lui commander votre maison.
La seconde est que les téléphones refusent les certificats auxquels ils ne font pas confiance. Un certificat autosigné, créé sur votre propre serveur, n’est pas signé par une autorité à laquelle le téléphone fait confiance d’origine : la connexion est donc refusée avant même d’atteindre Home Assistant. Sur la montre, cela ressemble à n’importe quel autre serveur injoignable. La solution simple est un certificat auquel le téléphone fait déjà confiance :
- Home Assistant Cloud et les tunnels comme Cloudflare Tunnel vous en fournissent un.
- Avec votre propre domaine ou un nom DNS dynamique, les certificats Let’s Encrypt sont gratuits et reconnus par les téléphones.
Deux écueils guettent ceux qui configurent le HTTPS sur Home Assistant lui-même, plutôt que sur un proxy placé devant :
- L’adresse locale change aussi. Dès que Home Assistant sert du HTTPS sur son port, le simple
http://192.168.1.50:8123ne répond plus sur ce port. - Une adresse IP ne correspond pas au certificat. Un certificat pour
ha.example.comn’est pas valide pourhttps://192.168.1.50:8123: cette adresse locale échoue donc à la vérification du certificat. Un reverse proxy ou un tunnel côté distant, avec Home Assistant lui-même laissé en simple http à la maison, évite les deux.
Le simple http est normal et convient pour l’adresse locale à la maison. À l’intérieur d’un VPN, dont le tunnel est déjà chiffré, le http peut aussi être acceptable ; sur l’internet ouvert, utilisez le https.
Les erreurs courantes et ce qu’affiche la montre
Quand quelque chose ne va pas, la montre dit quelle liaison a échoué. Le tableau reprend les messages liés aux adresses, et celui qui leur ressemble sans l’être.
| Sur la montre | Ce que cela signifie | Solution |
|---|---|---|
| Hors ligne · Home Assistant injoignable · Réessai dans 8 s | Le téléphone n’a pu joindre Home Assistant à aucune des adresses saisies | Ouvrez l’adresse dans le navigateur du téléphone, depuis là où il se trouve ; hors de chez vous, https avec un certificat valide |
| Adresse incorrecte · Elle répond, mais ce n’est pas l’API Home Assistant | Quelque chose a répondu, mais pas l’API Home Assistant : en général un chemin comme /lovelace après l’adresse |
Ne gardez que l’adresse du serveur, sans rien après |
| Hors ligne · Le téléphone ne répond pas | La montre n’a pas pu joindre le téléphone ; l’adresse n’y est pour rien | Téléphone à proximité, Bluetooth activé, app Zepp lancée |
| Jeton admin requis | L’adresse fonctionne, mais le jeton appartient à un utilisateur sans droits d’administrateur | Créez un jeton longue durée en tant qu’administrateur |
Hors ligne · Home Assistant injoignable
La bannière affiche Hors ligne, puis Home Assistant injoignable · Réessai dans 8 s, et en dessous un court code qui indique précisément à l’assistance ce qui a échoué. Les causes habituelles : vous êtes dehors avec seulement une adresse locale ; le VPN n’est pas connecté sur le téléphone ; l’adresse distante fonctionne à la maison mais pas depuis l’extérieur ; le téléphone ne fait pas confiance au certificat ; ou Home Assistant lui-même est arrêté ou en train de redémarrer. La solution commence toujours de la même façon : ouvrez l’adresse dans le navigateur du téléphone, comme décrit plus bas. Le tutoriel En cas de problème, étape 3, montre ce message en vidéo.
Adresse incorrecte
Adresse incorrecte signifie que l’adresse a répondu, mais par une page web au lieu de l’API Home Assistant. Presque toujours, l’adresse comporte un chemin, en général copié depuis la barre du navigateur : https://ha.example.com/lovelace/0 au lieu de https://ha.example.com. Retirez tout ce qui suit l’adresse du serveur (et son port). Dans les réglages d’AmazHA, le test de connexion dit la même chose à sa façon : l’adresse répond, mais pas avec l’API Home Assistant, et il donne l’exemple d’une adresse Home Assistant Cloud avec et sans /lovelace. Voir le dépannage, étape 4. Plus rarement, l’adresse mène à tout autre chose, comme la page d’administration d’un routeur.
400 Bad Request derrière un reverse proxy
Si votre adresse distante passe par un reverse proxy ou un tunnel et que chaque requête revient avec 400 Bad Request, c’est que Home Assistant refuse le proxy. Son intégration HTTP rejette toute requête qui porte un en-tête forwarded-for quand on ne lui a pas dit de faire confiance aux reverse proxies, ou quand l’adresse du proxy n’est pas sur sa liste de confiance, et la réponse est 400 dans les deux cas. Le journal de Home Assistant indique l’adresse d’où venait la requête ; pour le second cas, il affiche « Received X-Forwarded-For header from an untrusted proxy », suivi de cette adresse.
Dans AmazHA, Connecter affiche Erreur 400 avec une seule adresse, ou un point rouge à côté de Distant avec les deux.
La solution se trouve du côté de Home Assistant. Dans les versions actuelles, les réglages du serveur HTTP sont dans l’interface : Paramètres › Système › Réseau, activez Trust X-Forwarded-For et ajoutez l’adresse ou le réseau du proxy sous Trusted proxies. Les versions plus anciennes utilisent du YAML dans configuration.yaml (l’adresse ci-dessous est un exemple ; utilisez celle de votre proxy) :
http:
use_x_forwarded_for: true
trusted_proxies:
- 192.168.1.10
La documentation de l’intégration HTTP de Home Assistant donne les détails pour chaque version. Redémarrez Home Assistant si votre version l’exige, puis touchez à nouveau Connecter.
Hors ligne · Le téléphone ne répond pas
Celui-ci ne concerne pas du tout les adresses. La montre n’a pas pu joindre le téléphone en Bluetooth, et le téléphone n’a donc même pas eu l’occasion d’essayer Home Assistant. Gardez le téléphone à proximité, avec le Bluetooth activé et l’app Zepp lancée (le dépannage, étape 2). Changer d’adresse n’y changera rien.
Le réglage d’URL externe de Home Assistant
Home Assistant a ses propres réglages URL de Home Assistant, avec un champ Internet et un champ Réseau local, sous Paramètres › Système › Réseau. Ils indiquent à Home Assistant et à ses propres apps où il se trouve. AmazHA ne les lit pas : elle n’utilise que les deux adresses saisies dans ses propres réglages. Si vous avez changé votre URL externe dans Home Assistant et que la montre n’a pas suivi, voilà pourquoi. Copiez la nouvelle adresse dans URL distante.
Testez d’abord dans le navigateur du téléphone
Avant de changer quoi que ce soit dans AmazHA, ouvrez l’adresse dans le navigateur du même téléphone, depuis le même endroit. C’est le test le plus rapide qui soit, parce qu’il emprunte le même chemin qu’AmazHA : le téléphone, son réseau du moment, votre adresse.
- Coupez le Wi-Fi du téléphone si vous testez l’adresse distante depuis la maison, pour qu’il sorte vraiment par les données mobiles. Activez le VPN si l’adresse distante en a besoin.
- Tapez l’adresse exacte que vous avez saisie dans AmazHA, par exemple
https://ha.example.com. - Lisez le résultat.
| Le navigateur affiche | Ce que cela vous apprend |
|---|---|
| La page de connexion de Home Assistant | L’adresse et le certificat sont bons : le problème est ailleurs (chemin, jeton, Bluetooth) |
| Un avertissement de certificat | Le téléphone ne fait pas confiance au certificat ; AmazHA ne peut pas utiliser cette adresse en l’état |
| Rien, ou « impossible d’accéder à cette page » | Le téléphone ne peut pas joindre l’adresse depuis ce réseau |
| 400 Bad Request | Un reverse proxy auquel Home Assistant ne fait pas encore confiance |
| Une autre page (routeur, fournisseur, page par défaut du proxy) | L’adresse mène ailleurs |
Pour l’adresse locale, faites de même avec le Wi-Fi activé, à la maison. Si le navigateur atteint la page de connexion et qu’AmazHA échoue quand même, vérifiez que le champ contient l’adresse du serveur seule, sans rien après, et le même schéma que celui utilisé par le navigateur.
Vous pouvez aussi ajouter /api/ à l’adresse dans le navigateur. Home Assistant y répond par une erreur d’authentification, puisque le navigateur n’envoie pas de jeton : cela prouve que l’adresse mène bien à l’API Home Assistant et pas à une autre page. Dans AmazHA, saisissez l’adresse sans /api/.
Le test de connexion d’AmazHA : lire LAN et Distant
Connecter, dans les réglages d’AmazHA, teste les adresses depuis le téléphone et vous dit ce qu’il a trouvé. Après le toucher, le résultat apparaît en quelques secondes :
- Avec une seule adresse : Connecté ✓ quand Home Assistant répond, Injoignable quand rien ne répond, Erreur suivi d’un nombre quand quelque chose a répondu par une erreur HTTP (par exemple Erreur 400 ou Erreur 401), et Répond, mais ce n’est pas Home Assistant quand l’adresse répond par autre chose que l’API.
- Avec les deux adresses : un résultat par adresse, LAN et Distant, chacun avec un point de couleur : vert quand Home Assistant y répond, orange quand quelque chose répond sans être Home Assistant, rouge quand cela échoue.
Lisez-le en tenant compte de l’endroit où se trouve le téléphone. À la maison, un Distant rouge peut être normal (un domaine qui ne reboucle pas à l’intérieur de votre réseau, un VPN coupé) ou un vrai problème : testez donc à nouveau Wi-Fi coupé. Hors de chez vous, un LAN rouge est attendu ; seul Distant compte alors. Les deux en vert, testés une fois à la maison et une fois sur les données mobiles : c’est la configuration qui vous suit partout. L’étape 8 du tutoriel Connecter Home Assistant montre l’écran.
Quand l’adresse fonctionne mais que le jeton vient d’un utilisateur sans droits d’administrateur, Connecter le signale sous le résultat. C’est un problème de jeton, pas d’adresse : le test d’adresse réussit, mais la montre ne peut pas charger vos pièces tant que le jeton ne vient pas d’un administrateur.
Quatre configurations, pas à pas
Les deux mêmes champs couvrent des maisons très différentes. Quatre exemples, avec des adresses d’exemple :
Un appartement, usage à la maison uniquement. URL locale (LAN) : http://192.168.1.50:8123. URL distante : vide. La montre fonctionne sur le Wi-Fi de la maison ; dehors, elle affiche Hors ligne · Home Assistant injoignable, ce qui est attendu. Connecter indique Connecté ✓ à la maison.
Home Assistant Cloud. URL locale (LAN) : http://192.168.1.50:8123. URL distante : https://xxxxx.ui.nabu.casa. À la maison, AmazHA utilise l’adresse locale ; sur les données mobiles, elle passe d’elle-même à l’adresse Home Assistant Cloud. Connecter affiche LAN et Distant, tous deux en vert à la maison, parce que l’adresse cloud fonctionne aussi depuis l’intérieur.
Un VPN sur le téléphone. URL locale (LAN) : http://192.168.1.50:8123. URL distante : l’adresse du serveur à l’intérieur du VPN, avec http:// tapé devant si le serveur y répond en simple http. À la maison, l’adresse locale l’emporte. Dehors, VPN connecté, c’est la distante ; VPN coupé, la montre affiche la bannière Hors ligne jusqu’à ce qu’il soit rétabli.
Votre propre domaine derrière un reverse proxy. URL locale (LAN) : http://192.168.1.50:8123. URL distante : https://ha.example.com. Avant que cela fonctionne, Home Assistant doit faire confiance au proxy (Trust X-Forwarded-For, Trusted proxies), sinon chaque requête distante reçoit un 400. Testez l’adresse distante Wi-Fi coupé : certains routeurs ne renvoient pas votre propre domaine vers l’intérieur, si bien qu’un Distant rouge à la maison ne veut pas toujours dire qu’il échoue dehors.
Une liste de contrôle avant de quitter la maison
Cinq minutes à la maison vous épargnent plus tard un regard perplexe sur la montre :
- URL locale (LAN) contient l’adresse du serveur seule, celle qu’utilise votre navigateur à la maison.
- URL distante contient l’adresse distante seule : pas de
/lovelace, le port s’il en faut un,https://par internet. - Le navigateur du téléphone ouvre l’adresse distante Wi-Fi coupé et affiche la page de connexion de Home Assistant, sans avertissement de certificat.
- Si c’est un VPN : le VPN est réglé pour rester connecté sur le téléphone.
- Si c’est un reverse proxy ou un tunnel : Home Assistant lui fait confiance, donc pas de 400.
- Connecter affiche LAN et Distant en vert, ou Connecté ✓ avec une seule adresse.
- Le jeton vient d’un administrateur, et c’est le même pour les deux adresses.
Une fois cela fait, la montre utilise votre adresse locale à la maison et la distante partout ailleurs, sans que vous ayez rien à faire. Et si un jour elle affiche Hors ligne, la seconde ligne vous dit de quel côté chercher : Le téléphone ne répond pas, c’est le Bluetooth ; Home Assistant injoignable, c’est l’adresse.