Puerto de Home Assistant (8123): cómo cambiarlo y abrirlo con seguridad

Puerto de Home Assistant (8123): cómo cambiarlo y abrirlo con seguridad

Volver al Blog

Home Assistant escucha por defecto en el puerto 8123 (TCP). En tu red local lo abres con http://IP-DEL-EQUIPO:8123 o, en la mayoría de instalaciones, con http://homeassistant.local:8123.

Cómo cambiar el puerto

El puerto se define en configuration.yaml, dentro del bloque http:

http:
  server_port: 8123

Cambia el número por el que quieras, guarda el fichero y reinicia Home Assistant (Ajustes > Sistema > Reiniciar). Después tendrás que abrirlo con el puerto nuevo en la URL. Si usas la app móvil, actualiza también la dirección del servidor en sus ajustes.

Acceder desde fuera de casa

Hay dos caminos y no son igual de seguros:

  1. Sin abrir puertos: un túnel (por ejemplo, Cloudflare Tunnel) o una VPN. Es la opción más segura porque nada de tu red queda escuchando en internet. Lo explicamos en Home Assistant acceso remoto sin abrir puertos.
  2. Abriendo puertos en el router: redirigir el puerto 443 de tu IP pública al 8123 del equipo, con un dominio y un certificado SSL. Tienes la guía completa en acceso remoto a Home Assistant con HTTPS y IP dinámica.

Por qué no conviene exponer el 8123 tal cual

  • Sin HTTPS, tu contraseña viaja sin cifrar.
  • Los puertos habituales se escanean constantemente: cualquier servicio abierto recibirá intentos de acceso.
  • Es mejor publicar un puerto estándar (443) con certificado válido y mantener Home Assistant al día.

Si pones un proxy inverso delante, Home Assistant necesita saberlo. Añade en configuration.yaml:

http:
  use_x_forwarded_for: true
  trusted_proxies:
    - 192.168.1.10

Sustituye la dirección por la IP del proxy en tu red. Sin esto, Home Assistant rechazará las peticiones que llegan por el proxy.

Y si tu IP cambia

Con una IP pública dinámica, tu dominio tiene que seguir a la IP para que el acceso remoto no se rompa. Puedes hacerlo con un DDNS gratuito; mira la guía de acceso remoto con DuckDNS o usa tu propio dominio en Cloudflare con SyncMyIP.

Si no consigues conectar