Home Assistant peut fonctionner derrière un proxy inverse, mais le servir de manière fiable depuis un sous-chemin réécrit ne constitue généralement pas une configuration de déploiement prise en charge.
Une page à l’adresse example.com/homeassistant peut renvoyer du HTML, alors que les requêtes suivantes visent toujours des ressources à la racine, des routes d’authentification, des WebSockets ou des rappels d’intégration. Ne vous contentez pas de tester le premier écran : utilisez un navigateur vierge, connectez-vous, ouvrez un tableau de bord en direct, rechargez une route imbriquée et effectuez un rappel. Si une couche perd le préfixe, déplacez Home Assistant vers son propre nom d’hôte plutôt que d’ajouter d’autres réécritures.
Distinguer la prise en charge du proxy inverse de celle des sous-chemins
Un proxy inverse peut gérer la terminaison TLS et transmettre à Home Assistant une requête visant la racine d’un nom d’hôte. Un sous-chemin ajoute une exigence différente : chaque URL générée, ressource, appel API, WebSocket, redirection et rappel doit préserver de manière cohérente un préfixe compris par l’application. Une configuration réussie au niveau du proxy ne garantit pas le respect de ce contrat par l’application.
Les tests de la communauté Home Assistant aboutissent à une conclusion claire : l’application ne prend pas en charge le déploiement sous un préfixe d’URL. La réponse définitive à la question de placer Home Assistant dans un sous-chemin recommande un sous-domaine, quel que soit le choix du proxy.
La RÉUSSITE de la prise en charge du proxy inverse signifie que Home Assistant fonctionne à la racine d’un nom d’hôte dédié avec une redirection correcte. L’ÉCHEC du sous-chemin proposé signifie qu’une ou plusieurs routes de l’application perdent le préfixe. Ne confondez pas ces conclusions en affirmant que les proxys inverses eux-mêmes sont incompatibles.
Utiliser les ressources frontend comme premier test à faible risque
Ouvrez le sous-chemin proposé dans un profil de navigateur privé et inspectez les requêtes réseau avant de modifier Home Assistant. Si le document de base se charge, mais que JavaScript, les icônes, les manifestes ou les traductions demandent des chemins à la racine du nom d’hôte, la configuration a déjà échoué au premier test réversible permettant de trancher.
Une tentative documentée de réécriture de chemin a renvoyé la page principale, tandis que les ressources frontend demandaient des URL commençant par une barre oblique, sans le préfixe Home Assistant. Cet échec des ressources à chemin relatif à la racine est une incompatibilité de chemin d’application, et non un fichier manquant sur le proxy.
RÉUSSITE signifie que toutes les ressources frontend sont renvoyées correctement sous la route prévue. ÉCHEC signifie que des réponses 404 ou des requêtes vers la racine apparaissent. Arrêtez-vous là et testez un nom d’hôte dédié ; la substitution du corps des réponses est fragile, car les futures versions du frontend peuvent introduire de nouveaux chemins que la réécriture ne couvrira pas.
Tester les WebSockets, l’authentification et les routes imbriquées
Un shell de tableau de bord statique ne constitue pas une session complète. Connectez-vous depuis un profil vierge, observez les mises à jour des entités pendant plusieurs minutes, actualisez l’URL d’un tableau de bord imbriqué, déconnectez-vous, puis reconnectez-vous. Vérifiez ensuite si les mises à niveau HTTP, les jetons, les redirections et les rechargements de route conservent la même origine publique et le même chemin.
Home Assistant s’appuie fortement sur les WebSockets pour les communications en temps réel avec l’interface ; un proxy doit donc préserver le mécanisme de mise à niveau et les en-têtes. Le témoignage d’un opérateur sur la gestion des WebSockets par un proxy inverse montre pourquoi le simple chargement du HTML ne suffit pas à tester la compatibilité.
RÉUSSI signifie que l’authentification, les mises à jour en temps réel, la navigation et les rechargements directs fonctionnent sans erreurs de traduction de chemin. Un ÉCHEC limité aux sockets ou aux redirections suffit à rejeter la configuration avec sous-chemin. Corriger une directive du proxy ne prouve pas que les rappels et les futures routes prendront en charge le préfixe.
Choisissez un nom d’hôte dédié comme frontière stable
Publiez Home Assistant à la racine d’un nom d’hôte dédié, par exemple ha.example.com, puis acheminez ce nom d’hôte via le proxy inverse vers le service interne. Vous conservez ainsi une seule origine publique sans obliger l’application à gérer un préfixe de chemin. Un VPN privé ou un tunnel peut offrir la même séparation claire à la racine sans exposition publique.
Lorsqu’un accès à distance existant cesse de fonctionner après des changements réseau, vérifiez séparément le DNS, l’adresse publique, le NAT, le tunnel et le routage du proxy. Le diagnostic ZimaSpace sur l’accès à distance après un changement de routeur fournit une vérification connexe du chemin.
L’alternative est validée lorsqu’un navigateur vierge peut charger les ressources, établir une connexion WebSocket, s’authentifier, actualiser les routes imbriquées et accéder à Home Assistant après le redémarrage du proxy. Ne gardez l’ancienne route disponible que le temps de rétablir le DNS ou la configuration du proxy en cas de besoin ; ne maintenez pas indéfiniment deux URL publiques ambiguës.
Arrêtez-vous lorsque la session complète résiste à un redémarrage
Redémarrez le proxy et Home Assistant une fois, puis répétez le test complet depuis le réseau local et le réseau distant prévu. Vérifiez le nom du certificat, l’adresse du client transmise, la limite de confiance du proxy, la connexion, l’état en temps réel, la déconnexion et un rappel d’intégration. Il s’agit de la charge de travail initiale, et non d’un contrôle simplifié d’une page statique.
Ne déclarez la configuration avec nom d’hôte à la racine réussie que si elle passe toutes les étapes. Un sous-chemin qui ne fonctionne qu’après une réécriture personnalisée des réponses reste une dette technique non prise en charge, car une mise à jour peut modifier le comportement des ressources ou des rappels. Documentez le nom d’hôte validé, l’adresse du serveur en amont et la configuration de retour arrière.
Renforcez les mesures si la configuration avec nom d’hôte à la racine échoue encore, car la cause restante est probablement liée à la confiance accordée au proxy, au transfert WebSocket, au DNS, au certificat ou au routage, plutôt qu’à la prise en charge du chemin de base. N’exposez pas directement Home Assistant sur un port non protégé simplement pour conserver la forme d’URL souhaitée.
Assistance et conseils
À lire aussi

Comment cacher les vidéos pour adultes stockées sur votre NAS à votre famille
Gardez les vidéos pour adultes privées sur un NAS familial. Vérifiez les autorisations des dossiers, l’accès aux bibliothèques Plex et Jellyfin, les vignettes, l’historique...

Ce qu’il faut vérifier avant de charger un modèle communautaire dans Transformers
Utilisez la mise à jour du bac à sable Jinja de Transformers pour examiner la provenance des modèles, les modèles de conversation, le code...

Exécutez Mirage localement : OCR et détection d’objets à partir d’une seule image
Essayez le petit modèle de vision local de Cactus Compute, testez la reconnaissance optique de caractères et l’extraction d’objets à partir de données réelles,...



