Home Assistant puede ejecutarse detrás de un proxy inverso, pero servirlo de forma fiable desde una subruta reescrita no suele ser una configuración de despliegue admitida.
Una página en example.com/homeassistant puede devolver HTML, mientras que las solicitudes posteriores pueden seguir dirigiéndose a recursos con rutas relativas a la raíz, rutas de autenticación, WebSockets o devoluciones de llamada de integraciones. Prueba algo más que la primera pantalla: usa un navegador nuevo, inicia sesión, abre un panel en tiempo real, vuelve a cargar una ruta anidada y completa una devolución de llamada. Si alguna capa elimina el prefijo, traslada Home Assistant a su propio nombre de host en vez de añadir más reglas de reescritura.
Distingue la compatibilidad con proxies inversos de la compatibilidad con subrutas
Un proxy inverso puede terminar TLS y reenviar a Home Assistant una solicitud dirigida a la raíz de un nombre de host. Una subruta añade otro requisito: todas las URL generadas, los recursos, las llamadas a la API, los WebSockets, las redirecciones y las devoluciones de llamada deben conservar de forma coherente un prefijo que la aplicación entienda. Que funcione en la capa del proxy no demuestra que se cumpla ese requisito de la aplicación.
Las pruebas de la comunidad de Home Assistant concluyen directamente que la aplicación no admite el despliegue bajo un prefijo de URL. La respuesta definitiva a poner Home Assistant en una subruta recomienda un subdominio, independientemente del proxy que se elija.
APROBADO para la compatibilidad con proxies inversos significa que Home Assistant funciona en la raíz de un nombre de host dedicado con el reenvío correcto. SUSPENSO para la subruta propuesta significa que una o varias rutas de la aplicación pierden el prefijo. No combines ambos veredictos para afirmar que los proxies inversos son incompatibles.
Usa los recursos del frontend como primera prueba de bajo riesgo
Abre la subruta propuesta en un perfil privado del navegador e inspecciona las solicitudes de red antes de cambiar Home Assistant. Si el documento base se carga, pero JavaScript, los iconos, los manifiestos o las traducciones solicitan rutas desde la raíz del nombre de host, la topología ya ha fallado la primera prueba reversible para distinguir entre opciones.
Un intento documentado de reescritura de rutas devolvió la página principal, mientras que los recursos del frontend solicitaron URL que empezaban por una barra, sin el prefijo de Home Assistant. Ese fallo de recursos con rutas relativas a la raíz es una incompatibilidad de rutas de la aplicación, no un archivo que falte en el proxy.
APROBADO significa que todos los recursos del frontend se cargan correctamente en la ruta prevista. SUSPENSO significa que aparecen respuestas 404 o solicitudes a la ruta raíz. Detente ahí y prueba con un nombre de host dedicado; sustituir el cuerpo de la respuesta es una solución frágil, porque las futuras versiones del frontend pueden incorporar rutas que la regla de reescritura no cubra.
Probar WebSockets, autenticación y rutas anidadas
Un panel estático no constituye una sesión completa. Inicia sesión desde un perfil limpio, observa las actualizaciones de entidades durante varios minutos, actualiza una URL de panel anidada, cierra sesión y vuelve a iniciarla. Después, comprueba si las actualizaciones HTTP, los tokens, las redirecciones y las recargas de rutas mantienen el mismo origen público y la misma ruta.
Home Assistant depende en gran medida de WebSockets para la comunicación en tiempo real del frontend, por lo que el proxy debe preservar la ruta de actualización y los encabezados. El relato de un operador sobre el manejo de WebSocket en proxies inversos muestra por qué cargar solo el HTML no es una prueba de compatibilidad suficiente.
APROBADO significa que la autenticación, las actualizaciones en tiempo real, la navegación y las recargas directas funcionan sin errores de traducción de rutas. Si el FALLO se limita a sockets o redirecciones, el diseño con subruta sigue sin ser válido. Corregir una directiva del proxy no demuestra que las devoluciones de llamada y las rutas futuras sean compatibles con el prefijo.
Elige un hostname dedicado como límite estable
Publica Home Assistant en la raíz de un hostname dedicado, como ha.example.com, y luego enruta ese hostname a través del proxy inverso hacia el servicio interno. Así se conserva un único origen público sin que la aplicación tenga que entender un prefijo de ruta. Una VPN privada o un túnel pueden ofrecer el mismo límite raíz limpio sin exposición pública.
Cuando una ruta remota existente deja de funcionar después de cambios en la red, verifica por separado el DNS, la dirección pública, NAT, el túnel y el enrutamiento del proxy. El diagnóstico de ZimaSpace para el acceso remoto después de un cambio de router ofrece esa comprobación complementaria de la ruta.
La alternativa funciona cuando un navegador limpio puede cargar los recursos, establecer un WebSocket, autenticarse, actualizar rutas anidadas y acceder a Home Assistant después de reiniciar el proxy. Mantén la ruta anterior disponible solo el tiempo necesario para revertir los cambios de DNS o del proxy; no mantengas indefinidamente dos URL públicas ambiguas.
Detente cuando la sesión completa sobreviva a un reinicio
Reinicia el proxy y Home Assistant una vez y, después, repite la prueba completa desde la LAN y la red remota prevista. Confirma el nombre del certificado, la dirección reenviada del cliente, los límites de confianza del proxy, el inicio de sesión, el estado en tiempo real, el cierre de sesión y una devolución de llamada de integración. Esta es la carga de trabajo original, no una comprobación reducida de una página estática.
Declara que el diseño con hostname raíz funciona solo si supera todos los pasos. Una subruta que solo funciona tras reescribir respuestas de forma personalizada sigue siendo una deuda técnica no compatible, ya que una actualización puede cambiar el comportamiento de los recursos o las devoluciones de llamada. Documenta el hostname que funciona, la dirección del servidor de origen y la configuración para revertir los cambios.
Escala el problema si el diseño con hostname raíz sigue fallando, porque la causa restante probablemente sea la confianza del proxy, el reenvío de WebSocket, el DNS, el certificado o el enrutamiento, y no la compatibilidad con rutas base. No expongas Home Assistant directamente en un puerto sin protección solo para conservar la estructura de URL deseada.
Soporte y consejos
Más para leer

Cómo mantener ocultos de tu familia los vídeos para adultos en tu NAS
Mantén privados los vídeos para adultos en un NAS familiar. Comprueba los permisos de las carpetas, el acceso a las bibliotecas de Plex y...

Qué comprobar antes de cargar un modelo de la comunidad en Transformers
Usa la actualización del entorno aislado de Jinja para Transformers para revisar la procedencia del modelo, las plantillas de chat, el código remoto, los...

Ejecuta Mirage localmente: OCR y detección de objetos a partir de una sola imagen
Prueba el pequeño modelo de visión local de Cactus Compute, valida el OCR y la extracción de objetos con datos reales y comprende las...



