🔐 Acceder a Home Assistant desde fuera de casa GRATIS (DuckDNS + NGINX)

¿Por qué usar DuckDNS y NGINX en lugar de solo DuckDNS?

Muchos tutoriales te enseñan a abrir el puerto 8123, pero eso puede dar problemas con algunas integraciones (como las de Google Home o Alexa). Al usar NGINX Home Assistant SSL Proxy, crearemos un túnel seguro que traduce el tráfico HTTPS al puerto interno, manteniendo tu sistema compatible con todo y mucho más seguro.

Paso 1: Abrir puertos en tu Router (Port Forwarding)

Para que el tráfico de internet llegue a tu servidor, necesitamos abrir el "camino":

1. Accede a la configuración de tu router (normalmente en 192.168.1.1).
2. Busca la sección de Port Forwarding o Reenvío de Puertos.
3. Abre el puerto 443 (protocolo TCP) y dirígelo hacia la IP de tu Home Assistant.

Paso 2: Configuración de DuckDNS

DuckDNS es el servicio que nos dará una dirección web (URL) gratuita que siempre apuntará a tu casa, aunque tu IP cambie.

1. Ve a duckdns.org y loguéate.
2. Crea un subdominio (ejemplo: mi-casa-domotica).
3. Copia el Token que te aparece arriba; lo necesitaremos ahora.
4. En Home Assistant, ve a Ajustes > Complementos > Tienda de complementos e instala DuckDNS.
5. En la pestaña Configuración del complemento, pega tu dominio y el token. Dale a "Guardar" e inicia el addon.

Paso 3: Instalar NGINX Home Assistant SSL Proxy

Este es el "traductor" de seguridad.

1. Busca e instala el addon NGINX Home Assistant SSL Proxy desde la tienda de complementos.
2. En su configuración, escribe tu dominio completo: tu-subdominio.duckdns.org.
3. ¡Dale a Iniciar!

Paso 4: Modificar el archivo configuration.yaml (¡MUY IMPORTANTE!)

Home Assistant, por seguridad, bloquea conexiones que vienen de un proxy si no le damos permiso. Debes añadir estas líneas a tu archivo configuration.yaml:

http:
  use_x_forwarded_for: true
  trusted_proxies:
    - 172.30.33.0/24

Nota: Este rango de IP es el estándar para los addons de Home Assistant.

Paso 5: Ajustes finales en la App móvil

Para que tu móvil sepa cuándo estás fuera y cuándo dentro:

1. En la App de Home Assistant, ve a Ajustes > Compañero móvil.
2. En URL externa, pon: https://tu-subdominio.duckdns.org.
3. En URL interna, pon tu IP local: http://192.168.1.XX:8123.
4. Añade el nombre de tu red WiFi para que la app cambie de una URL a otra automáticamente.

¿Tienes problemas con el certificado SSL?

Si al intentar entrar te sale un error de "Conexión no segura", revisa los logs del addon DuckDNS para asegurar que el certificado Let's Encrypt se ha generado correctamente. Recuerda que siempre debes entrar con HTTPS y no con HTTP.

Tutorial en Vídeo: Paso a Paso

Si prefieres ver cómo muevo cada pestaña y configuro el router en tiempo real, no te pierdas el vídeo completo en mi canal.