projets:home-assistant:acces-externe
Table des matières
Configurer un accès externe et sécurisé à Home Assistant
Ce guide explique comment accéder à Home Assistant depuis l’extérieur de façon sécurisée, en utilisant un nom de domaine DuckDNS, des certificats SSL Let's Encrypt, et un proxy HTTPS avec NGINX.
🛠️ Étape 1 : Configuration de DuckDNS
- Aller sur https://www.duckdns.org et se connecter (via GitHub, Google, etc.)
- Créer un sous-domaine (ex: `monhome.duckdns.org`)
- Copier le token fourni
Dans Home Assistant :
- Aller dans : Paramètres > Modules complémentaires > Boutique des modules complémentaires
- Installer DuckDNS
- Configurer l’add-on avec le contenu suivant :
lets_encrypt: accept_terms: true certfile: fullchain.pem keyfile: privkey.pem token: VOTRE_TOKEN_DUCKDNS domains: - monhome.duckdns.org aliases: [] seconds: 300
- Lancer l’add-on
- Activer Start on boot et Watchdog
🔐 Étape 2 : Installation du NGINX Proxy Manager
- Installer NGINX Home Assistant SSL Proxy
- Configuration typique :
domain: monhome.duckdns.org certfile: fullchain.pem keyfile: privkey.pem hsts: max-age=31536000; includeSubDomains cloudflare: false
- Démarrer l’add-on et activer Start on boot
🔄 Étape 3 : Redirection de ports sur le routeur
Accéder à l’interface de votre routeur, et :
- Rediriger le port externe 80 vers port 80 interne de Home Assistant
- Rediriger le port externe 443 vers port 443 interne
Cela permet à Let's Encrypt de valider votre domaine et à NGINX de sécuriser le trafic.
⚙️ Étape 4 : Modifier configuration.yaml
Pour modifier les fichiers de Home Assistant directement depuis l’interface web, vous pouvez utiliser ladd-on “File Editor”.
Pour parcourir l’arborescence, il faut cliquer sur l’icône dossier en haut à gauche de l’interface du module.
Dans le fichier `configuration.yaml`, ajouter :
http: use_x_forwarded_for: true trusted_proxies: - 172.30.33.0/24
- Sauvegarder et redémarrer Home Assistant
- Vérifier la config via Paramètres > Contrôle du serveur > Vérifier la configuration
🌐 Étape 5 : Accéder à Home Assistant depuis l’extérieur
Une fois tout en place, accédez à Home Assistant via :
⚠️ Vérifiez que votre navigateur reconnaît bien le certificat SSL (pas d’erreur de sécurité).
🔒 Conseils de sécurité
- Changez le mot de passe de l’utilisateur Home Assistant
- Activez l’authentification à deux facteurs
- Évitez d’ouvrir le port 8123 directement sur Internet
🧩 Ressources complémentaires
projets/home-assistant/acces-externe.txt · Dernière modification : 22/05/2025 11:39 de Oliver Watté