Wiki Le BIK'LAB

Le Bik'Lab avec le réseau des FabLabs de la région académique Guadeloupe

Outils pour utilisateurs

Outils du site


projets:home-assistant:acces-externe

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 :

  1. Installer DuckDNS
  2. 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
  1. Lancer l’add-on
  2. Activer Start on boot et Watchdog

🔐 Étape 2 : Installation du NGINX Proxy Manager

  1. Installer NGINX Home Assistant SSL Proxy
  2. Configuration typique :
domain: monhome.duckdns.org
certfile: fullchain.pem
keyfile: privkey.pem
hsts: max-age=31536000; includeSubDomains
cloudflare: false
  1. 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

Port forwarding box orange Configuration du forward de port sur une box orange

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é