Blog

Home Assistant fuori casa sul tuo orologio: URL locale, URL remoto, Home Assistant Cloud e VPN

A casa, AmazHA funziona con il tuo indirizzo locale e nient’altro; fuori casa, il telefono ha bisogno di un secondo indirizzo che possa raggiungere. Come si combinano i due, le opzioni per l’accesso da remoto a confronto e cosa significa ogni errore sull’orologio.

Pubblicato 20 min di lettura

In questo articolo
  1. La risposta breve
  2. A casa non ti serve nient’altro
  3. Perché è il telefono a dover raggiungere Home Assistant
  4. Come AmazHA sceglie l’indirizzo
    1. Con un solo indirizzo
    2. Con entrambi gli indirizzi
    3. Uscire di casa e tornare
    4. Scrivere gli indirizzi
  5. Le opzioni per l’accesso da remoto a confronto
    1. Home Assistant Cloud (presto Home Assistant Link)
    2. Una VPN: Tailscale, WireGuard e altre
    3. Un tuo dominio con HTTPS: un reverse proxy o un tunnel
    4. Il port forwarding da solo
  6. HTTPS e certificati fuori casa
  7. Errori comuni e cosa dice l’orologio
    1. Offline · Home Assistant non raggiungibile
    2. Indirizzo sbagliato
    3. 400 Bad Request dietro un reverse proxy
    4. Offline · Il telefono non risponde
    5. L’impostazione dell’URL esterno di Home Assistant
  8. Prova prima dal browser del telefono
  9. Il test di connessione in AmazHA: leggere LAN e Remoto
  10. Quattro configurazioni, passo per passo
  11. Una checklist prima di uscire di casa
  12. Domande frequenti

La risposta breve

A casa, AmazHA, un’app per Amazfit dedicata a Home Assistant, ha bisogno solo del tuo indirizzo locale, come http://192.168.1.50:8123, e nulla deve essere raggiungibile da fuori. Fuori casa, il telefono ha bisogno di un indirizzo remoto che possa raggiungere: Home Assistant Cloud, una VPN come Tailscale o WireGuard, o un tuo dominio con HTTPS. Inseriscili entrambi, e AmazHA sceglie da sola quello che funziona.

A casa non ti serve nient’altro

Sulla rete di casa, l’unico indirizzo di cui AmazHA ha bisogno è quello che usi già per aprire Home Assistant nel browser a casa. È il campo URL locale (LAN) nelle impostazioni di AmazHA, e da solo basta: niente abbonamento, niente VPN, niente dominio, nessuna porta aperta sul router.

AmazHA ha due campi per l’indirizzo nelle sue impostazioni: URL locale (LAN) e URL remoto. Entrambi possono restare vuoti. Se usi l’orologio solo a casa, compila quello locale, lascia vuoto quello remoto, e hai finito. Puoi aggiungere un indirizzo remoto più avanti, il giorno in cui vorrai l’orologio funzionante in ufficio o in vacanza, senza toccare nient’altro.

I campi sono nell’app Zepp, in Profilo › il tuo orologio › App › AmazHA › Impostazioni › Home Assistant. Compaiono dopo lo sblocco della versione completa (uno sblocco una tantum, senza abbonamento): la versione gratuita è una demo dal vivo su dati di esempio e non si collega a nessun server. Il tutorial Collega Home Assistant mostra in video il passo dell’indirizzo locale.

Un tipico indirizzo locale assomiglia a uno di questi (esempi, usa il tuo):

http://192.168.1.50:8123
http://homeassistant.local:8123

Se scrivi un indirizzo senza http:// o https:// in URL locale (LAN), AmazHA ci mette davanti http://, perché i server locali di solito parlano http semplice.

Perché è il telefono a dover raggiungere Home Assistant

L’orologio non parla mai direttamente con Home Assistant. Parla con il telefono via Bluetooth, e la parte di AmazHA che gira dentro l’app Zepp sul telefono è l’unica che invia richieste al tuo server. Quindi la domanda “il mio orologio riesce a raggiungere Home Assistant?” è in realtà “il mio telefono riesce a raggiungere Home Assistant, adesso, da dove si trova?”

Questo ha alcune conseguenze pratiche:

  • L’orologio non ha bisogno del Wi-Fi. Non si collega mai a una rete per AmazHA. Un orologio con il solo Bluetooth funziona allo stesso modo.
  • Il telefono deve essere vicino, con il Bluetooth attivo e l’app Zepp in esecuzione. Altrimenti l’orologio dice Offline · Il telefono non risponde, che è un problema diverso da un indirizzo sbagliato (vedi risoluzione dei problemi, passo 2).
  • È la rete su cui si trova il telefono a decidere quale indirizzo funziona. Sul Wi-Fi di casa funziona l’indirizzo locale. Con i dati mobili, a casa di un amico o sul Wi-Fi di un hotel, può funzionare solo un indirizzo remoto, e solo se il telefono riesce a raggiungerlo da lì.
  • Una VPN deve essere connessa sul telefono, non sull’orologio. L’orologio non ne sa nulla.
  • Il tuo token resta sul telefono. Incolli un token di accesso a lunga scadenza una volta, nelle impostazioni di AmazHA. L’orologio riceve solo ciò che mostra, tramite il collegamento Bluetooth che ha già con il telefono; il token non gli viene mai inviato.

Questo spiega una situazione che confonde: le impostazioni dicono Connesso e l’orologio dice Offline. Le impostazioni provano solo il percorso dal telefono a Home Assistant; l’orologio ha bisogno anche del percorso Bluetooth verso il telefono.

Come AmazHA sceglie l’indirizzo

AmazHA sceglie l’indirizzo da sola, prima il locale, poi il remoto. Non c’è nessun interruttore da azionare quando esci di casa, e non scegli mai a mano tra i due campi.

Con un solo indirizzo

Con un solo campo compilato, AmazHA usa semplicemente quello. Non viene sondato nulla e non si cambia nulla. Una configurazione solo locale funziona a casa e mostra il banner Offline fuori casa; una configurazione solo remota funziona ovunque il telefono riesca a raggiungere quell’indirizzo.

Con entrambi gli indirizzi

Con entrambi i campi compilati, il telefono chiede contemporaneamente a tutti e due gli indirizzi se Home Assistant risponde, con un breve limite di tempo di 1,5 secondi. Se risponde l’indirizzo locale, AmazHA usa quello. Se risponde solo quello remoto, usa quest’ultimo. Il vincitore viene ricordato, così le richieste successive vanno direttamente lì senza chiedere di nuovo.

Il controllo è più severo di “qualcosa ha risposto”. Un indirizzo conta solo quando risponde come l’API di Home Assistant. Questo conta sulle reti degli altri: sul Wi-Fi di un hotel, 192.168.1.50 potrebbe essere una stampante, la pagina di un router o un captive portal che risponde con una pagina web. AmazHA non lo scambia per il tuo server, quindi non resta bloccata sul tuo indirizzo locale mentre la risposta vera è quella remota.

Uscire di casa e tornare

L’indirizzo ricordato resta finché una richiesta verso di esso non fallisce. Quando esci di casa e il telefono si scollega dal tuo Wi-Fi, la richiesta successiva all’indirizzo locale fallisce, AmazHA lo dimentica, e il tentativo seguente chiede di nuovo a entrambi gli indirizzi e approda su quello remoto. Mentre l’app AmazHA è aperta, l’orologio si aggiorna ogni 8 secondi, quindi in pratica il primo aggiornamento dopo il cambio può fallire e mostrare brevemente il banner Offline, e quello dopo si riprende.

Il ritorno a casa funziona al contrario, più in silenzio: se il tuo indirizzo remoto funziona anche dall’interno della rete, AmazHA continua a usarlo finché una richiesta non fallisce o finché non tocchi di nuovo Connetti. Quando succede non c’è nulla di sbagliato; l’indirizzo remoto semplicemente funziona ancora.

Scrivere gli indirizzi

Qualche dettaglio da sapere quando compili i campi:

  • Nulla dopo l’indirizzo del server. http://192.168.1.50:8123, non http://192.168.1.50:8123/lovelace. Lo stesso vale per quello remoto: https://xxxxx.ui.nabu.casa, non https://xxxxx.ui.nabu.casa/lovelace. Se resta un percorso, l’indirizzo risponde, ma non come l’API di Home Assistant.
  • Lo schema. Se non scrivi uno schema, URL locale (LAN) riceve http:// e URL remoto riceve https://. Scrivi tu http:// se un indirizzo remoto è davvero http semplice (un indirizzo VPN, per esempio).
  • La porta. Tieni la porta se il tuo indirizzo ne ha bisogno, come in :8123. Senza porta, https:// significa 443.
  • Un token per entrambi. Incollalo una volta in Token di accesso a lunga scadenza; vale per l’indirizzo locale e per quello remoto. Entrambi gli indirizzi devono portare allo stesso Home Assistant.

Il tutorial Collega Home Assistant copre il passo dell’indirizzo remoto, e il passo 8 la prova che segue.

Le opzioni per l’accesso da remoto a confronto

Con AmazHA funziona qualsiasi indirizzo remoto, purché il telefono riesca ad aprirlo da dove si trova e risponda come l’API di Home Assistant. Quale usare è una decisione che riguarda Home Assistant, non AmazHA. Ecco le più comuni, una accanto all’altra.

Opzione Cosa va in URL remoto Porte aperte a casa HTTPS e certificato Costo Al telefono serve
Home Assistant Cloud di Nabu Casa (diventerà Home Assistant Link il 2 dicembre 2026) L’indirizzo remoto che genera per te, https://xxxxx.ui.nabu.casa Nessuna Incluso Abbonamento Niente di più
VPN, come Tailscale o WireGuard L’indirizzo di Home Assistant dentro la VPN Nessuna con Tailscale; una per un server WireGuard gestito da te Il tunnel è cifrato; https solo se lo configuri Esistono opzioni gratuite La VPN connessa
Un tuo dominio tramite un tunnel, come Cloudflare Tunnel https://ha.example.com Nessuna Fornito dal tunnel Di solito un dominio Niente di più
Un tuo dominio con un reverse proxy https://ha.example.com Una (di solito la 443) Da configurare tu, per esempio Let’s Encrypt Un dominio o un nome DNS dinamico gratuito Niente di più
Port forwarding diretto verso Home Assistant https://yourname.duckdns.org:8123 Una Da configurare tu Esistono DNS dinamici gratuiti Niente di più

Home Assistant Cloud è il servizio in abbonamento gestito da Nabu Casa; i suoi abbonamenti finanziano lo sviluppo a tempo pieno di Home Assistant. La documentazione di Home Assistant lo definisce l’opzione più semplice per la maggior parte delle persone: non richiede porte aperte sul router, cifra il traffico e genera per te un URL remoto unico.

Per AmazHA, quell’URL remoto è tutto ciò che ti serve: copialo, così come lo mostra Home Assistant, in URL remoto, senza nulla dopo. Il tuo token di accesso a lunga scadenza funziona attraverso di esso esattamente come sul tuo indirizzo locale, dato che entrambi portano allo stesso server.

Il 2 ottobre 2026 Nabu Casa ha annunciato che Home Assistant Cloud verrà rinominato Home Assistant Link il 2 dicembre 2026. L’annuncio dice che è lo stesso abbonamento con un nuovo nome e che non c’è nulla da fare. Non parla di cambi di indirizzo, quindi oggi non c’è nulla da cambiare in AmazHA.

Una VPN: Tailscale, WireGuard e altre

Una VPN mette virtualmente il telefono sulla rete di casa, ovunque si trovi. La documentazione di Home Assistant elenca servizi VPN come Tailscale e ZeroTier One come una via d’accesso sicura, e ne indica il rovescio: la VPN deve essere connessa prima che qualcosa possa raggiungere Home Assistant da fuori. Per AmazHA significa che la VPN deve essere connessa sul telefono. Se cade, l’orologio mostra Offline · Home Assistant non raggiungibile finché non torna.

In URL remoto va l’indirizzo che il telefono usa per Home Assistant mentre la VPN è attiva: l’indirizzo del server dentro la VPN, o un nome che la tua VPN risolve per lui. Due dettagli:

  • Se lì il server risponde in http semplice, scrivi http:// davanti all’indirizzo. Senza schema, AmazHA aggiunge https:// all’indirizzo remoto, che non risponderebbe.
  • Con alcune configurazioni VPN il tuo indirizzo di casa stesso, 192.168.1.50, diventa raggiungibile attraverso il tunnel. Allora l’indirizzo locale funziona ovunque la VPN sia attiva, e il campo remoto è una riserva per quando non lo è.

Una VPN è l’opzione con la minore esposizione: nulla del tuo server è aperto verso internet. Il prezzo è che ogni dispositivo che ha bisogno di Home Assistant, telefono compreso, deve far girare il client VPN.

Un tuo dominio con HTTPS: un reverse proxy o un tunnel

Con un tuo dominio, https://ha.example.com porta al tuo Home Assistant da qualsiasi luogo. Due modi comuni per arrivarci:

  • Un reverse proxy (Nginx, Caddy, Traefik o simili) a casa riceve le richieste sulla porta 443, gestisce il certificato e passa le richieste a Home Assistant. Richiede un port forwarding sul router.
  • Un tunnel come Cloudflare Tunnel fa girare un piccolo connettore dentro la tua rete che tiene aperta una connessione in uscita verso il fornitore, quindi sul router non si apre nulla. Il fornitore serve il tuo dominio con un certificato valido.

In entrambi i casi c’è qualcosa davanti a Home Assistant che gli inoltra le richieste, e bisogna dire a Home Assistant di fidarsene. La documentazione di Home Assistant è esplicita: le richieste da un reverse proxy vengono bloccate a meno che tu non attivi Trust X-Forwarded-For (fidati di X-Forwarded-For) e aggiunga il proxy ai Trusted proxies (proxy attendibili). Se salti questo passaggio, ogni richiesta attraverso il proxy riceve 400 Bad Request (ne parliamo più sotto).

Il port forwarding da solo

Inoltrare una porta del router direttamente a Home Assistant è la via più diretta, e quella su cui la documentazione sull’accesso da remoto di Home Assistant è più prudente: aprire semplicemente una porta non è sicuro, il traffico deve essere cifrato, e dovresti seguire la sua checklist di sicurezza prima di esporre qualsiasi cosa. Segnala anche due trappole pratiche: molti fornitori di internet ti danno un indirizzo IP dinamico, motivo per cui suggerisce un nome DNS dinamico come DuckDNS, e alcuni fornitori ti mettono dietro un CG-NAT, dove le connessioni in entrata non possono raggiungerti affatto.

Se scegli questa strada, l’indirizzo remoto è il tuo nome DNS dinamico con https e la porta che hai inoltrato, per esempio https://yourname.duckdns.org:8123. Metti esattamente quello in URL remoto.

HTTPS e certificati fuori casa

Fuori casa, la regola nel tutorial sulla risoluzione dei problemi è breve: l’indirizzo ha bisogno di https con un certificato valido. I motivi sono due.

Il primo è la sicurezza. Il tuo token di accesso a lunga scadenza accompagna ogni richiesta che il telefono invia. Con http semplice su internet, chiunque si trovi sul percorso può leggerlo, e con esso controllare la tua casa.

Il secondo è che i telefoni rifiutano i certificati di cui non si fidano. Un certificato autofirmato, creato sul tuo server, non è firmato da un’autorità di cui il telefono si fida di serie, quindi la connessione viene rifiutata prima ancora di raggiungere Home Assistant. Sull’orologio sembra un qualsiasi altro server irraggiungibile. La soluzione semplice è un certificato di cui il telefono si fida già:

  • Home Assistant Cloud e i tunnel come Cloudflare Tunnel te ne forniscono uno.
  • Con un tuo dominio o un nome DNS dinamico, i certificati Let’s Encrypt sono gratuiti e i telefoni se ne fidano.

Due insidie colpiscono chi configura l’HTTPS su Home Assistant stesso, anziché su un proxy davanti a esso:

  • Cambia anche l’indirizzo locale. Una volta che Home Assistant serve HTTPS sulla sua porta, il semplice http://192.168.1.50:8123 non risponde più su quella porta.
  • Un indirizzo IP non corrisponde al certificato. Un certificato per ha.example.com non è valido per https://192.168.1.50:8123, quindi quell’indirizzo locale non supera il controllo del certificato. Un reverse proxy o un tunnel per il lato remoto, lasciando Home Assistant stesso in http semplice a casa, evita entrambe le cose.

L’http semplice è normale e va bene per l’indirizzo locale a casa. Dentro una VPN, il cui tunnel è già cifrato, anche l’http può essere accettabile; su internet, usa https.

Errori comuni e cosa dice l’orologio

Quando qualcosa non va, l’orologio dice quale collegamento è saltato. La tabella elenca i messaggi che riguardano gli indirizzi, e quello che sembra simile ma non lo è.

Sull’orologio Cosa significa Soluzione
Offline · Home Assistant non raggiungibile · Riprovo ogni 8 s Il telefono non è riuscito a raggiungere Home Assistant a nessuno degli indirizzi che hai inserito Apri l’indirizzo nel browser del telefono da dove si trova il telefono; fuori casa, https con un certificato valido
Indirizzo sbagliato · Risponde, ma non è l’API di Home Assistant Qualcosa ha risposto, ma non l’API di Home Assistant: di solito un percorso come /lovelace dopo l’indirizzo Tieni solo l’indirizzo del server, senza nulla dopo
Offline · Il telefono non risponde L’orologio non è riuscito a raggiungere il telefono; l’indirizzo non c’entra Telefono vicino, Bluetooth attivo, app Zepp in esecuzione
Serve un token admin L’indirizzo funziona, ma il token appartiene a un utente senza diritti di amministratore Crea un token a lunga scadenza come amministratore

Offline · Home Assistant non raggiungibile

Il banner mostra Offline, poi Home Assistant non raggiungibile · Riprovo ogni 8 s, e sotto un breve codice che dice al supporto esattamente cosa non ha funzionato. Le cause abituali: sei fuori casa con il solo indirizzo locale; la VPN non è connessa sul telefono; l’indirizzo remoto funziona a casa ma non da fuori; il telefono non si fida del certificato; oppure Home Assistant stesso è spento o si sta riavviando. La soluzione comincia sempre allo stesso modo: apri l’indirizzo nel browser del telefono, come descritto più sotto. Il tutorial sulla risoluzione dei problemi, passo 3, mostra questo messaggio in video.

Indirizzo sbagliato

Indirizzo sbagliato significa che l’indirizzo ha risposto, ma con una pagina web anziché con l’API di Home Assistant. Quasi sempre l’indirizzo contiene un percorso, tipicamente copiato dalla barra del browser: https://ha.example.com/lovelace/0 invece di https://ha.example.com. Togli tutto ciò che viene dopo l’indirizzo del server (e la sua porta). Nelle impostazioni di AmazHA, il test di connessione dice la stessa cosa a modo suo: l’indirizzo risponde, ma non con l’API di Home Assistant, e fa l’esempio di un indirizzo Home Assistant Cloud con e senza /lovelace. Vedi risoluzione dei problemi, passo 4. Più di rado, l’indirizzo porta a tutt’altro, come la pagina di amministrazione di un router.

400 Bad Request dietro un reverse proxy

Se il tuo indirizzo remoto passa da un reverse proxy o da un tunnel e ogni richiesta torna con 400 Bad Request, Home Assistant sta rifiutando il proxy. La sua integrazione HTTP respinge qualsiasi richiesta che porti un’intestazione forwarded-for quando non le è stato detto di fidarsi dei reverse proxy, o quando l’indirizzo del proxy non è nel suo elenco di quelli attendibili, e in entrambi i casi la risposta è 400. Il log di Home Assistant indica l’indirizzo da cui è arrivata la richiesta; nel secondo caso dice “Received X-Forwarded-For header from an untrusted proxy”, seguito da quell’indirizzo.

In AmazHA, Connetti mostra Errore 400 con un solo indirizzo, o un pallino rosso accanto a Remoto con entrambi.

La soluzione è dal lato di Home Assistant. Nelle versioni attuali, le impostazioni del server HTTP sono nell’interfaccia: in Impostazioni › Sistema › Rete, attiva Trust X-Forwarded-For e aggiungi l’indirizzo o la rete del proxy in Trusted proxies. Le versioni più vecchie usano lo YAML in configuration.yaml (l’indirizzo qui sotto è un esempio; usa quello del tuo proxy):

http:
  use_x_forwarded_for: true
  trusted_proxies:
    - 192.168.1.10

La documentazione dell’integrazione HTTP di Home Assistant ha i dettagli per ogni versione. Riavvia Home Assistant se la tua versione lo richiede, poi tocca di nuovo Connetti.

Offline · Il telefono non risponde

Questo non riguarda affatto gli indirizzi. L’orologio non è riuscito a raggiungere il telefono via Bluetooth, quindi il telefono non ha nemmeno avuto modo di provare Home Assistant. Tieni il telefono vicino, con il Bluetooth attivo e l’app Zepp in esecuzione (risoluzione dei problemi, passo 2). Cambiare gli indirizzi non lo risolve.

L’impostazione dell’URL esterno di Home Assistant

Home Assistant ha le sue impostazioni URL di Home Assistant, con un campo Internet e uno Rete locale in Impostazioni › Sistema › Rete. Dicono a Home Assistant e alle sue app dove si trova. AmazHA non le legge: usa solo i due indirizzi scritti nelle sue impostazioni. Se hai cambiato l’URL esterno in Home Assistant e l’orologio non l’ha seguito, ecco perché. Copia il nuovo indirizzo in URL remoto.

Prova prima dal browser del telefono

Prima di cambiare qualsiasi cosa in AmazHA, apri l’indirizzo nel browser dello stesso telefono, dallo stesso posto. È la prova più rapida che ci sia, perché segue lo stesso percorso di AmazHA: il telefono, la sua rete attuale, il tuo indirizzo.

  1. Spegni il Wi-Fi sul telefono se stai provando l’indirizzo remoto da casa, così esce davvero con i dati mobili. Attiva la VPN se l’indirizzo remoto ne ha bisogno.
  2. Scrivi esattamente l’indirizzo che hai inserito in AmazHA, per esempio https://ha.example.com.
  3. Leggi il risultato.
Il browser mostra Cosa ti dice
La pagina di accesso di Home Assistant L’indirizzo e il certificato vanno bene: il problema è altrove (percorso, token, Bluetooth)
Un avviso sul certificato Il telefono non si fida del certificato; AmazHA non può usare questo indirizzo così com’è
Niente, oppure “impossibile raggiungere la pagina” Il telefono non riesce a raggiungere l’indirizzo da questa rete
400 Bad Request Un reverse proxy di cui Home Assistant non si fida ancora
Una pagina diversa (router, fornitore, pagina predefinita del proxy) L’indirizzo porta da un’altra parte

Per l’indirizzo locale, fai lo stesso con il Wi-Fi acceso, a casa. Se il browser raggiunge la pagina di accesso e AmazHA continua a fallire, controlla che il campo contenga solo l’indirizzo del server, senza nulla dopo, e lo stesso schema usato dal browser.

Puoi anche aggiungere /api/ all’indirizzo nel browser. Home Assistant risponde con un errore di autenticazione, dato che il browser non invia nessun token: è la prova che l’indirizzo porta all’API di Home Assistant e non a qualche altra pagina. In AmazHA, scrivi l’indirizzo senza /api/.

Il test di connessione in AmazHA: leggere LAN e Remoto

Connetti, nelle impostazioni di AmazHA, prova gli indirizzi dal telefono e ti dice cosa ha trovato. Dopo averlo toccato, il risultato compare in pochi secondi:

  • Con un solo indirizzo: Connesso ✓ quando Home Assistant risponde, Non raggiungibile quando non risponde nulla, Errore seguito da un numero quando qualcosa ha risposto con un errore HTTP (per esempio Errore 400 o Errore 401), e Risponde, ma non è Home Assistant quando l’indirizzo risponde con qualcosa che non è l’API.
  • Con entrambi gli indirizzi: un risultato per indirizzo, LAN e Remoto, ognuno con un pallino colorato: verde quando lì risponde Home Assistant, arancione quando risponde qualcosa che non è Home Assistant, rosso quando fallisce.

Leggilo tenendo conto di dove si trova il telefono. A casa, un Remoto rosso può essere normale (un dominio che non torna indietro dentro la tua rete, una VPN spenta) oppure un problema reale, quindi riprova con il Wi-Fi spento. Fuori casa, un LAN rosso è previsto; lì conta solo Remoto. Entrambi verdi, provati una volta a casa e una volta con i dati mobili, è la configurazione che ti segue ovunque. Il passo 8 del tutorial Collega Home Assistant mostra la schermata.

Quando l’indirizzo funziona ma il token viene da un utente senza diritti di amministratore, Connetti lo dice sotto il risultato. È un problema di token, non di indirizzo: la prova dell’indirizzo riesce, ma l’orologio non può caricare le tue stanze finché il token non viene da un amministratore.

Quattro configurazioni, passo per passo

Gli stessi due campi coprono case molto diverse. Quattro esempi, con indirizzi d’esempio:

Un appartamento, uso solo in casa. URL locale (LAN): http://192.168.1.50:8123. URL remoto: vuoto. L’orologio funziona sul Wi-Fi di casa; fuori mostra Offline · Home Assistant non raggiungibile, come previsto. A casa Connetti indica Connesso ✓.

Home Assistant Cloud. URL locale (LAN): http://192.168.1.50:8123. URL remoto: https://xxxxx.ui.nabu.casa. A casa AmazHA usa l’indirizzo locale; con i dati mobili passa da sola all’indirizzo di Home Assistant Cloud. Connetti mostra LAN e Remoto, entrambi verdi a casa, perché l’indirizzo cloud funziona anche dall’interno.

Una VPN sul telefono. URL locale (LAN): http://192.168.1.50:8123. URL remoto: l’indirizzo del server dentro la VPN, con http:// scritto davanti se lì il server risponde in http semplice. A casa vince l’indirizzo locale. Fuori, con la VPN connessa, vince quello remoto; con la VPN spenta, l’orologio mostra il banner Offline finché non la riaccendi.

Un tuo dominio dietro un reverse proxy. URL locale (LAN): http://192.168.1.50:8123. URL remoto: https://ha.example.com. Prima che funzioni, Home Assistant deve fidarsi del proxy (Trust X-Forwarded-For, Trusted proxies), altrimenti ogni richiesta remota riceve 400. Prova l’indirizzo remoto con il Wi-Fi spento: alcuni router non instradano il tuo dominio di nuovo verso l’interno, quindi un Remoto rosso a casa non significa sempre che fallisca da fuori.

Una checklist prima di uscire di casa

Cinque minuti a casa ti risparmiano più tardi uno sguardo perplesso all’orologio:

  1. URL locale (LAN) contiene solo l’indirizzo del server, quello che il browser usa a casa.
  2. URL remoto contiene solo l’indirizzo remoto: niente /lovelace, la porta se serve, https:// via internet.
  3. Il browser del telefono apre l’indirizzo remoto con il Wi-Fi spento e mostra la pagina di accesso di Home Assistant, senza avvisi sul certificato.
  4. Se è una VPN: la VPN è impostata per restare connessa sul telefono.
  5. Se è un reverse proxy o un tunnel: Home Assistant se ne fida, quindi niente 400.
  6. Connetti mostra LAN e Remoto in verde, oppure Connesso ✓ con un solo indirizzo.
  7. Il token viene da un amministratore, ed è lo stesso per entrambi gli indirizzi.

Fatto questo, l’orologio usa il tuo indirizzo locale a casa e quello remoto ovunque altrove, senza che tu debba fare nulla. E se un giorno mostra Offline, la seconda riga ti dice da che parte guardare: Il telefono non risponde è il Bluetooth, Home Assistant non raggiungibile è l’indirizzo.

Domande frequenti

Mi serve Home Assistant Cloud (Nabu Casa) per usare AmazHA?

No. A casa AmazHA funziona con il solo indirizzo locale, per esempio http://192.168.1.50:8123. Home Assistant Cloud è uno dei modi per raggiungere il server fuori casa; una VPN o un tuo dominio con HTTPS funzionano altrettanto bene. Metti quello che usi in URL remoto.

AmazHA funziona con il solo indirizzo locale?

Sì. Compila URL locale (LAN), lascia vuoto URL remoto, e l’orologio funziona ogni volta che il telefono è sulla rete di casa. Fuori casa mostra Offline · Home Assistant non raggiungibile finché il telefono non torna su quella rete.

Posso usare Tailscale o un’altra VPN?

Sì, purché la VPN sia connessa sul telefono, perché è il telefono a parlare con Home Assistant. Metti in URL remoto l’indirizzo che Home Assistant ha dentro la VPN. Scrivi http:// davanti se lì il server non serve HTTPS: senza schema AmazHA aggiunge https:// all’indirizzo remoto.

Il mio URL esterno funziona nel browser ma non sull’orologio. Perché?

Controlla tre cose. L’indirizzo in URL remoto deve essere solo l’indirizzo del server, senza nulla dopo (niente /lovelace). Il telefono deve aprirlo da dove si trova, con il Wi-Fi spento. E via internet serve https con un certificato valido. L’impostazione Internet dell’URL di Home Assistant non viene letta da AmazHA: l’indirizzo va scritto in AmazHA stessa.

Perché ricevo 400 Bad Request attraverso il mio reverse proxy?

Home Assistant rifiuta le richieste inoltrate da un proxy di cui non gli è stato detto di fidarsi, e risponde 400. Attiva Trust X-Forwarded-For (fidati di X-Forwarded-For) e aggiungi l’indirizzo del proxy ai Trusted proxies (proxy attendibili): in Impostazioni › Sistema › Rete nelle versioni attuali, con use_x_forwarded_for e trusted_proxies sotto http: in quelle più vecchie.

Fuori casa va bene http, o mi serve https?

Via internet, usa https con un certificato valido: il token viaggia con ogni richiesta, e i telefoni rifiutano i certificati di cui non si fidano, come quelli autofirmati. Il semplice http:// è normale per l’indirizzo locale a casa, e può andare bene dentro una VPN, il cui tunnel è già cifrato.

Un indirizzo DuckDNS funziona?

Sì, se il telefono riesce ad aprirlo con il Wi-Fi spento e ha un certificato valido, di solito Let’s Encrypt. Metti l’indirizzo completo, porta compresa se non è la 443, in URL remoto, per esempio https://yourname.duckdns.org:8123. Di solito richiede un port forwarding sul router, quindi leggi prima le note sulla sicurezza nella documentazione di Home Assistant sull’accesso da remoto.

Home Assistant Cloud continuerà a funzionare quando diventerà Home Assistant Link?

Il 2 ottobre 2026 Nabu Casa ha annunciato che Home Assistant Cloud verrà rinominato Home Assistant Link il 2 dicembre 2026, e dice che si tratta dello stesso abbonamento, senza nulla da fare. L’annuncio non parla di cambi di indirizzo, quindi tieni in URL remoto l’indirizzo remoto che usi oggi.

Guardalo in video

I brevi tutorial su cui si basa questo articolo: video in inglese, ogni passaggio scritto in italiano.

Tutti gli articoli