Home Assistant può essere eseguito dietro un proxy inverso, ma servirlo in modo affidabile da un sottopercorso riscritto generalmente non è un confine di distribuzione supportato.
Una pagina all’indirizzo example.com/homeassistant può restituire HTML, mentre le richieste successive possono comunque puntare a risorse con percorso relativo alla radice, route di autenticazione, WebSocket o callback delle integrazioni. Prova più della schermata iniziale: usa un browser nuovo, accedi, apri una dashboard in tempo reale, ricarica una route annidata e completa una callback. Se un qualsiasi livello perde il prefisso, sposta Home Assistant su un hostname dedicato invece di aggiungere altre riscritture.
Distingui il supporto dei proxy inversi da quello dei sottopercorsi
Un proxy inverso può terminare TLS e inoltrare a Home Assistant una richiesta alla radice dell’hostname. Un sottopercorso introduce un requisito diverso: ogni URL generato, risorsa, chiamata API, WebSocket, reindirizzamento e callback deve mantenere coerentemente un prefisso riconosciuto dall’applicazione. Il successo a livello di proxy non dimostra che questo contratto applicativo sia rispettato.
I test della community di Home Assistant portano a una conclusione netta: l’applicazione non supporta la distribuzione sotto un prefisso URL. La risposta definitiva a come inserire Home Assistant in un sottopercorso consiglia un sottodominio, indipendentemente dal proxy scelto.
PASS per il supporto dei proxy inversi significa che Home Assistant funziona alla radice di un hostname dedicato con l’inoltro corretto. FAIL per il sottopercorso proposto significa che una o più route dell’applicazione perdono il prefisso. Non confondere i due risultati sostenendo che i proxy inversi siano di per sé incompatibili.
Usa le risorse del frontend come primo test a basso rischio
Apri il sottopercorso proposto in un profilo browser privato e controlla le richieste di rete prima di modificare Home Assistant. Se il documento di base viene caricato, ma JavaScript, icone, manifest o traduzioni richiedono percorsi dalla radice dell’hostname, la topologia ha già fallito la prima prova discriminante reversibile.
Un tentativo documentato di riscrittura del percorso ha restituito la pagina principale, mentre le risorse del frontend richiedevano URL con barra iniziale, senza il prefisso di Home Assistant. Questo errore delle risorse con percorso relativo alla radice è un’incompatibilità del percorso dell’applicazione, non un file mancante sul proxy.
PASS significa che tutte le risorse del frontend vengono caricate correttamente sulla route prevista. FAIL significa che compaiono risposte 404 o richieste al percorso radice. Fermati e prova un hostname dedicato: la sostituzione del corpo della risposta è fragile, perché le future build del frontend potrebbero introdurre nuovi percorsi non coperti dalla riscrittura.
Testa WebSocket, autenticazione e route annidate
Una shell statica della dashboard non è una sessione completa. Accedi da un profilo pulito, osserva gli aggiornamenti delle entità per diversi minuti, aggiorna l’URL di una dashboard annidata, esci e accedi di nuovo. Poi verifica se gli upgrade HTTP, i token, i reindirizzamenti e i ricaricamenti delle route mantengono la stessa origine pubblica e lo stesso percorso.
Home Assistant fa ampio affidamento sui WebSocket per la comunicazione in tempo reale del frontend, quindi un proxy deve preservare il percorso di upgrade e le intestazioni. Il resoconto di un operatore sulla gestione dei WebSocket tramite reverse proxy mostra perché il solo caricamento dell’HTML non è un test di compatibilità sufficiente.
PASS significa che autenticazione, aggiornamenti in tempo reale, navigazione e ricaricamenti diretti funzionano senza errori di traduzione dei percorsi. Un FAIL limitato ai socket o ai reindirizzamenti continua a escludere il design con sottopercorso. Correggere una direttiva del proxy non dimostra che le callback e i percorsi futuri riconosceranno il prefisso.
Scegli un hostname dedicato come confine stabile
Pubblica Home Assistant alla radice di un hostname dedicato, come ha.example.com, poi instrada quell’hostname tramite il reverse proxy verso il servizio interno. In questo modo si mantiene un’unica origine pubblica senza richiedere che l’applicazione comprenda un prefisso di percorso. Una VPN privata o un tunnel può offrire lo stesso confine pulito alla radice, senza esposizione pubblica.
Quando un percorso remoto esistente smette di funzionare dopo modifiche alla rete, verifica separatamente DNS, indirizzo pubblico, NAT, tunnel e routing del proxy. La diagnostica di ZimaSpace per l’accesso remoto dopo una modifica al router fornisce una verifica complementare del percorso.
L’alternativa è valida quando un browser pulito riesce a caricare gli asset, stabilire una connessione WebSocket, autenticarsi, aggiornare i percorsi annidati e raggiungere Home Assistant dopo il riavvio del proxy. Mantieni disponibile il vecchio percorso solo per il tempo necessario a ripristinare le modifiche al DNS o al proxy; non mantenere indefinitamente due URL pubblici ambigui.
Fermati quando l’intera sessione supera un riavvio
Riavvia il proxy e Home Assistant una volta, poi ripeti il test completo dalla LAN e dalla rete remota prevista. Verifica il nome del certificato, l’indirizzo client inoltrato, il perimetro dei proxy fidati, l’accesso, lo stato in tempo reale, la disconnessione e una callback di integrazione. Si tratta del carico di lavoro originale, non di un test ridotto a una pagina statica.
Dichiara il successo solo per il design con hostname alla radice che supera ogni passaggio. Un sottopercorso che funziona solo dopo una riscrittura personalizzata delle risposte resta un debito operativo non supportato, perché un aggiornamento può modificare il comportamento di asset o callback. Documenta l’hostname funzionante, l’indirizzo upstream e la configurazione di rollback.
Procedi all’escalation se il design con hostname alla radice continua a non funzionare, perché la causa rimanente è probabilmente la fiducia nel proxy, l’inoltro WebSocket, il DNS, il certificato o il routing, non il supporto ai percorsi di base. Non esporre Home Assistant direttamente su una porta non protetta solo per mantenere la forma URL desiderata.
Assistenza e consigli
Altre letture

Come tenere nascosti i video per adulti sul tuo NAS ai tuoi familiari
Tieni privati i video per adulti su un NAS familiare. Controlla le autorizzazioni delle cartelle, l’accesso alle librerie di Plex e Jellyfin, le miniature,...

Cosa controllare prima di caricare un modello della community in Transformers
Usa l’aggiornamento della sandbox Jinja di Transformers per esaminare la provenienza dei modelli, i template di chat, il codice remoto, i pesi serializzati e...

Esegui Mirage in locale: OCR e rilevamento degli oggetti da una sola immagine
Prova il piccolo modello di visione locale di Cactus Compute, verifica l’OCR e l’estrazione degli oggetti con input reali e comprendi i limiti di...



