Home Assistant mimo domov na vašich hodinkách: místní URL, vzdálená URL, Home Assistant Cloud a VPN

Stručná odpověď

Doma potřebuje AmazHA, aplikace Home Assistant pro hodinky Amazfit, jen vaši místní adresu, například http://192.168.1.50:8123, a nic nemusí být dostupné zvenku. Mimo domov potřebuje telefon vzdálenou adresu, na kterou se dostane: Home Assistant Cloud, VPN jako Tailscale nebo WireGuard, nebo vlastní doménu s HTTPS. Zadejte obě a AmazHA si sama vybere tu, která funguje.

Doma nepotřebujete nic navíc

Ve vaší domácí síti potřebuje AmazHA jen adresu, kterou už doma používáte k otevření Home Assistant v prohlížeči. To je pole Místní URL (LAN) v nastavení AmazHA a samo o sobě stačí: žádné předplatné, žádná VPN, žádná doména, žádný otevřený port na routeru.

AmazHA má v nastavení dvě pole pro adresu: Místní URL (LAN) a Vzdálená URL. Kterékoli z nich může zůstat prázdné. Pokud hodinky používáte jen doma, vyplňte místní, vzdálenou nechte prázdnou a máte hotovo. Vzdálenou adresu můžete přidat později, v den, kdy budete chtít, aby hodinky fungovaly v kanceláři nebo na dovolené, aniž byste sahali na cokoli jiného.

Pole najdete v aplikaci Zepp v části Profil › vaše hodinky › Aplikace › AmazHA › Nastavení › Home Assistant. Objeví se, jakmile je plná verze odemčená (jednorázové odemčení, bez předplatného): bezplatná verze je živá ukázka se vzorovými daty a k žádnému serveru se nepřipojuje. Návod Připojte Home Assistant ukazuje krok s místní adresou ve videu.

Typická místní adresa vypadá jako jedna z těchto (příklady, použijte svou):

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

Pokud do pole Místní URL (LAN) napíšete adresu bez http:// nebo https://, AmazHA před ni doplní http://, protože místní servery obvykle používají obyčejné http.

Proč se k Home Assistant musí dostat váš telefon

Hodinky nikdy nekomunikují s Home Assistant samy. Komunikují s telefonem přes Bluetooth a část AmazHA, která běží v telefonu uvnitř aplikace Zepp, je jediná, která posílá požadavky na váš server. Otázka „dostanou se moje hodinky k Home Assistant?“ tedy ve skutečnosti zní „dostane se můj telefon k Home Assistant, právě teď, z místa, kde je?“

To má několik praktických důsledků:

• Hodinky nepotřebují Wi-Fi. Kvůli AmazHA se nikdy nepřipojují k žádné síti. Hodinky jen s Bluetooth fungují úplně stejně.
• Telefon musí být poblíž, se zapnutým Bluetooth a spuštěnou aplikací Zepp. Pokud není, hodinky hlásí Offline · Telefon neodpovídá, což je jiný problém než špatná adresa (viz řešení potíží, krok 2).
• O tom, která adresa funguje, rozhoduje síť, ve které je telefon. Na domácí Wi-Fi funguje místní adresa. Na mobilních datech, u kamaráda nebo na hotelové Wi-Fi může fungovat jen vzdálená adresa, a to jen tehdy, když se k ní telefon odtamtud dostane.
• VPN musí být připojená v telefonu, ne v hodinkách. Hodinky o ní nic nevědí.
• Váš token zůstává v telefonu. Dlouhodobý přístupový token vložíte jednou, v nastavení AmazHA. Hodinky dostávají jen to, co zobrazují, přes spojení Bluetooth, které už s telefonem mají; token se do nich nikdy neposílá.

To vysvětluje matoucí situaci: nastavení hlásí Připojeno a hodinky hlásí Offline. Nastavení testuje jen cestu telefonu k Home Assistant; hodinky potřebují ještě cestu přes Bluetooth k telefonu.

Jak AmazHA vybírá adresu

AmazHA vybírá adresu sama, nejdřív místní, pak vzdálenou. Při odchodu z domu nemusíte nic přepínat a mezi oběma poli nikdy nevybíráte ručně.

S jednou adresou

Když je vyplněné jen jedno pole, AmazHA ho prostě použije. Nic se nezkouší a nic se nepřepíná. Nastavení jen s místní adresou funguje doma a mimo domov ukazuje banner Offline; nastavení jen se vzdálenou adresou funguje všude, kde se telefon k této adrese dostane.

Se dvěma adresami

Když jsou vyplněná obě pole, telefon se obou adres současně zeptá, zda Home Assistant odpovídá, s krátkým časovým limitem 1,5 sekundy. Pokud odpoví místní adresa, AmazHA ji použije. Pokud odpoví jen vzdálená, použije tu. Vítěz se zapamatuje, takže další požadavky jdou rovnou na něj, bez dalšího ptaní.

Kontrola je přísnější než „něco odpovědělo“. Adresa se počítá jen tehdy, když odpoví jako API Home Assistant. Na tom záleží v cizích sítích: na hotelové Wi-Fi může být 192.168.1.50 tiskárna, stránka routeru nebo přihlašovací portál, který odpoví webovou stránkou. AmazHA si to s vaším serverem nesplete, takže neuvízne na vaší místní adrese, když skutečnou odpověď dává vaše vzdálená.

Odchod z domu a návrat

Zapamatovaná adresa platí, dokud požadavek na ni neselže. Když odejdete z domu a telefon vypadne z vaší Wi-Fi, další požadavek na místní adresu selže, AmazHA ji zapomene a při následujícím pokusu se znovu zeptá obou adres a skončí u vzdálené. Když je aplikace AmazHA otevřená, hodinky se obnovují každých 8 sekund, takže v praxi může první obnovení po přepnutí selhat a krátce ukázat banner Offline, a to další se zotaví.

Návrat domů funguje opačně a tišeji: pokud vaše vzdálená adresa funguje i uvnitř vaší sítě, AmazHA ji používá dál, dokud požadavek neselže nebo dokud znovu neklepnete na Připojit. Když se to stane, nic není špatně; vzdálená adresa prostě pořád funguje.

Zadávání adres

Při vyplňování polí se hodí znát několik podrobností:

• Za adresou serveru nic. http://192.168.1.50:8123, ne http://192.168.1.50:8123/lovelace. Totéž platí pro vzdálenou: https://xxxxx.ui.nabu.casa, ne https://xxxxx.ui.nabu.casa/lovelace. Když za adresou zůstane cesta, adresa odpovídá, ale ne jako API Home Assistant.
• Schéma. Když schéma nenapíšete, Místní URL (LAN) dostane http:// a Vzdálená URL dostane https://. Pokud vzdálená adresa opravdu používá obyčejné http (například adresa ve VPN), napište http:// sami.
• Port. Pokud vaše adresa port potřebuje, ponechte ho, jako v :8123. Bez portu znamená https:// port 443.
• Jeden token pro obě. Vložte ho jednou do pole Dlouhodobý přístupový token; slouží pro místní i vzdálenou adresu. Obě adresy musí vést ke stejnému Home Assistant.

Návod Připojte Home Assistant popisuje krok se vzdálenou adresou a krok 8 test, který následuje.

Možnosti vzdáleného přístupu v porovnání

S AmazHA funguje jakákoli vzdálená adresa, pokud ji telefon z místa, kde je, otevře a odpovídá jako API Home Assistant. Kterou použít, je rozhodnutí v Home Assistant, ne v AmazHA. Tady jsou ty běžné vedle sebe.

Home Assistant Cloud (brzy Home Assistant Link)

Home Assistant Cloud je předplacená služba provozovaná společností Nabu Casa; její předplatné financuje vývoj Home Assistant na plný úvazek. Vlastní dokumentace Home Assistant ji označuje za nejjednodušší možnost pro většinu lidí: nepotřebuje otevřené porty na routeru, šifruje provoz a vygeneruje vám jedinečnou vzdálenou URL.

Pro AmazHA je tato vzdálená URL vše, co potřebujete: zkopírujte ji tak, jak ji Home Assistant ukazuje, do pole Vzdálená URL, bez čehokoli za ní. Váš dlouhodobý přístupový token přes ni funguje stejně jako na místní adrese, protože obě vedou ke stejnému serveru.

Dne 2. října 2026 Nabu Casa oznámila, že Home Assistant Cloud bude 2. prosince 2026 přejmenován na Home Assistant Link. Oznámení uvádí, že jde o stejné předplatné pod novým názvem a že není třeba nic dělat. Žádnou změnu adresy nezmiňuje, takže v AmazHA dnes není co měnit.

VPN: Tailscale, WireGuard a další

VPN virtuálně připojí váš telefon do domácí sítě, ať je kdekoli. Dokumentace Home Assistant uvádí služby VPN, jako Tailscale a ZeroTier One, jako bezpečnou cestu dovnitř a upozorňuje na háček: VPN musí být připojená dřív, než se k Home Assistant zvenku cokoli dostane. Pro AmazHA to znamená, že VPN musí být připojená v telefonu. Pokud spadne, hodinky ukazují Offline · Home Assistant není dostupný, dokud se znovu nepřipojí.

Do pole Vzdálená URL patří adresa, kterou telefon pro Home Assistant používá, když je VPN aktivní: adresa serveru uvnitř VPN, nebo název, který pro něj vaše VPN překládá. Dvě podrobnosti:

• Pokud tam váš server odpovídá obyčejným http, napište před adresu http://. Bez schématu AmazHA ke vzdálené adrese doplní https://, na které by server neodpověděl.
• U některých nastavení VPN se přes tunel stane dostupnou i vaše domácí adresa, 192.168.1.50. Místní adresa pak funguje všude, kde je VPN zapnutá, a vzdálené pole je záloha pro chvíle, kdy zapnutá není.

VPN je možnost s nejmenší expozicí: nic z vašeho serveru není otevřené do internetu. Cenou je, že každé zařízení, které Home Assistant potřebuje, včetně telefonu, musí mít spuštěného klienta VPN.

Vlastní doména s HTTPS: reverzní proxy nebo tunel

S vlastní doménou vede https://ha.example.com k vašemu Home Assistant odkudkoli. Dva běžné způsoby, jak toho dosáhnout:

• Reverzní proxy (Nginx, Caddy, Traefik nebo podobná) doma přijímá požadavky na portu 443, stará se o certifikát a předává požadavky dál do Home Assistant. Potřebuje přesměrování portu na routeru.
• Tunel, například Cloudflare Tunnel, spouští uvnitř vaší sítě malý konektor, který k poskytovateli udržuje otevřené odchozí spojení, takže se na routeru nic neotevírá. Poskytovatel obsluhuje vaši doménu s platným certifikátem.

V obou případech stojí něco před Home Assistant a přeposílá mu požadavky a Home Assistant musí dostat pokyn, že tomu má důvěřovat. Dokumentace Home Assistant výslovně uvádí, že požadavky z reverzní proxy jsou blokované, dokud nezapnete Trust X-Forwarded-For (důvěřovat X-Forwarded-For) a nepřidáte proxy do Trusted proxies (důvěryhodné proxy). Pokud to vynecháte, každý požadavek přes proxy dostane 400 Bad Request (víc o tom níže).

Samotné přesměrování portu

Přesměrování portu routeru přímo na Home Assistant je nejpřímější cesta a ta, ke které je dokumentace vzdáleného přístupu Home Assistant nejopatrnější: samotné otevření portu není bezpečné, provoz musí být šifrovaný a než cokoli zpřístupníte, měli byste projít její bezpečnostní kontrolní seznam. Upozorňuje také na dvě praktické pasti: mnoho poskytovatelů internetu vám přidělí dynamickou IP adresu, a proto doporučuje název dynamického DNS, například DuckDNS, a někteří poskytovatelé vás umístí za CG-NAT, kde se k vám příchozí spojení vůbec nedostanou.

Pokud zvolíte tuto cestu, vzdálenou adresou je váš název dynamického DNS s https a portem, který jste přesměrovali, například https://yourname.duckdns.org:8123. Do pole Vzdálená URL zadejte přesně tohle.

HTTPS a certifikáty mimo domov

Mimo domov je pravidlo z návodu Když něco nefunguje krátké: adresa potřebuje https s platným certifikátem. Důvody jsou dva.

Prvním je bezpečnost. Váš dlouhodobý přístupový token jde s každým požadavkem, který telefon pošle. Přes obyčejné http na otevřeném internetu si ho může přečíst kdokoli na cestě a s ním ovládat váš domov.

Druhým je, že telefony odmítají certifikáty, kterým nedůvěřují. Certifikát podepsaný sebou samým, vytvořený na vašem vlastním serveru, není podepsaný autoritou, které telefon od výroby důvěřuje, takže spojení je odmítnuto dřív, než vůbec dorazí k Home Assistant. Na hodinkách to vypadá jako jakýkoli jiný nedostupný server. Jednoduchým řešením je certifikát, kterému telefon už důvěřuje:

• Home Assistant Cloud a tunely jako Cloudflare Tunnel ho zajistí za vás.
• S vlastní doménou nebo názvem dynamického DNS jsou certifikáty Let’s Encrypt zdarma a telefony jim důvěřují.

Dvě pasti zaskočí ty, kdo nastavují HTTPS přímo v Home Assistant, a ne na proxy před ním:

• Mění se i místní adresa. Jakmile Home Assistant na svém portu poskytuje HTTPS, obyčejné http://192.168.1.50:8123 na tomto portu přestane odpovídat.
• IP adresa neodpovídá certifikátu. Certifikát pro ha.example.com neplatí pro https://192.168.1.50:8123, takže tato místní adresa kontrolou certifikátu neprojde. Reverzní proxy nebo tunel pro vzdálenou stranu, se samotným Home Assistant doma na obyčejném http, se vyhne obojímu.

Obyčejné http je u místní adresy doma normální a v pořádku. Uvnitř VPN, jejíž tunel je už šifrovaný, může být přijatelné také; na otevřeném internetu používejte https.

Časté chyby a co hlásí hodinky

Když něco není v pořádku, hodinky řeknou, které spojení selhalo. Tabulka uvádí hlášení, která souvisejí s adresami, a jedno, které vypadá podobně, ale nesouvisí.

Offline · Home Assistant není dostupný

Banner ukazuje Offline, pak Home Assistant není dostupný · Opakuji každých 8 s a pod tím krátký kód, který podpoře přesně řekne, co selhalo. Obvyklé příčiny: jste pryč a máte jen místní adresu; VPN není v telefonu připojená; vzdálená adresa funguje doma, ale ne zvenku; telefon nedůvěřuje certifikátu; nebo samotný Home Assistant neběží či se restartuje. Řešení vždy začíná stejně: otevřete adresu v prohlížeči telefonu, jak je popsáno níže. Návod Když něco nefunguje, krok 3, ukazuje toto hlášení ve videu.

Špatná adresa

Špatná adresa znamená, že adresa odpověděla, ale webovou stránkou místo API Home Assistant. Téměř vždy adresa obsahuje cestu, typicky zkopírovanou z adresního řádku prohlížeče: https://ha.example.com/lovelace/0 místo https://ha.example.com. Odstraňte všechno za adresou serveru (a jejím portem). V nastavení AmazHA říká test připojení totéž po svém: adresa odpovídá, ale ne rozhraním API Home Assistant, a uvádí příklad adresy Home Assistant Cloud s /lovelace a bez něj. Viz řešení potíží, krok 4. Méně často vede adresa úplně jinam, například na administrační stránku routeru.

400 Bad Request za reverzní proxy

Pokud vaše vzdálená adresa vede přes reverzní proxy nebo tunel a každý požadavek se vrátí s 400 Bad Request, Home Assistant odmítá proxy. Jeho integrace HTTP zamítne každý požadavek s hlavičkou forwarded-for, pokud nedostala pokyn důvěřovat reverzním proxy, nebo pokud adresa proxy není na seznamu důvěryhodných, a odpovědí je v obou případech 400. Protokol Home Assistant uvádí adresu, ze které požadavek přišel; ve druhém případě zní „Received X-Forwarded-For header from an untrusted proxy“, za čímž následuje tato adresa.

V AmazHA ukáže Připojit s jednou adresou Chyba 400, se dvěma červenou tečku vedle Vzdálený.

Řešení je na straně Home Assistant. V současných verzích jsou nastavení serveru HTTP v uživatelském rozhraní: Nastavení › Systém › Síť, zapněte Trust X-Forwarded-For a do Trusted proxies přidejte adresu nebo síť proxy. Starší verze používají YAML v configuration.yaml (adresa níže je příklad; použijte adresu své proxy):

http:
  use_x_forwarded_for: true
  trusted_proxies:
    - 192.168.1.10

Dokumentace integrace HTTP Home Assistant obsahuje podrobnosti pro každou verzi. Pokud to vaše verze vyžaduje, restartujte Home Assistant a pak znovu klepněte na Připojit.

Offline · Telefon neodpovídá

Tohle s adresami vůbec nesouvisí. Hodinky se přes Bluetooth nespojily s telefonem, takže telefon ani nedostal šanci zkusit Home Assistant. Mějte telefon poblíž, se zapnutým Bluetooth a spuštěnou aplikací Zepp (řešení potíží, krok 2). Změna adres to nevyřeší.

Vlastní nastavení externí URL v Home Assistant

Home Assistant má vlastní nastavení Home Assistant URL (URL Home Assistant) s polem Internet a polem Local network (místní síť) v části Nastavení › Systém › Síť. Říkají Home Assistant a jeho vlastním aplikacím, kde se nachází. AmazHA je nečte: používá jen dvě adresy zadané v jejím vlastním nastavení. Pokud jste v Home Assistant změnili externí URL a hodinky se nepřizpůsobily, je to proto. Zkopírujte novou adresu do pole Vzdálená URL.

Nejdřív test v prohlížeči telefonu

Než v AmazHA cokoli změníte, otevřete adresu v prohlížeči na stejném telefonu, ze stejného místa. Je to nejrychlejší test, jaký existuje, protože jde stejnou cestou jako AmazHA: telefon, jeho aktuální síť, vaše adresa.

1. Vypněte v telefonu Wi-Fi, pokud testujete vzdálenou adresu z domova, aby požadavek opravdu šel ven přes mobilní data. Pokud ji vzdálená adresa potřebuje, zapněte VPN.
2. Napište přesně tu adresu, kterou jste zadali v AmazHA, například https://ha.example.com.
3. Přečtěte si výsledek.

U místní adresy udělejte totéž se zapnutou Wi-Fi, doma. Pokud se prohlížeč dostane na přihlašovací stránku a AmazHA přesto selhává, zkontrolujte, že pole obsahuje jen adresu serveru, nic za ní, a stejné schéma, jaké použil prohlížeč.

Za adresu v prohlížeči můžete také přidat /api/. Home Assistant na to odpoví chybou ověření, protože prohlížeč neposílá žádný token: dokazuje to, že adresa vede k API Home Assistant, a ne na nějakou jinou stránku. V AmazHA adresu zadejte bez /api/.

Test připojení v AmazHA: jak číst LAN a Vzdálený

Připojit v nastavení AmazHA otestuje adresy z telefonu a řekne vám, co zjistilo. Po klepnutí se výsledek objeví během několika sekund:

• S jednou adresou: Připojeno ✓, když Home Assistant odpoví, Nedostupné, když neodpoví nic, Chyba s číslem, když něco odpoví chybou HTTP (například Chyba 400 nebo Chyba 401), a Odpovídá, ale není to Home Assistant, když adresa odpoví něčím, co není API.
• Se dvěma adresami: jeden výsledek pro každou adresu, LAN a Vzdálený, každý s barevnou tečkou: zelenou, když tam Home Assistant odpovídá, oranžovou, když něco odpovídá, ale není to Home Assistant, a červenou, když to selže.

Čtěte to s ohledem na to, kde telefon je. Doma může být červený Vzdálený normální (doména, která se uvnitř vaší sítě nevrací zpět, vypnutá VPN), nebo skutečný problém, proto otestujte znovu s vypnutou Wi-Fi. Mimo domov je červené LAN očekávané; tam záleží jen na Vzdálený. Obě zelené, otestované jednou doma a jednou na mobilních datech, jsou nastavení, které vás bude doprovázet všude. Krok 8 návodu Připojte Home Assistant tuto obrazovku ukazuje.

Když adresa funguje, ale token pochází od uživatele bez práv administrátora, Připojit to uvede pod výsledkem. Je to problém tokenu, ne adresy: test adresy projde, ale hodinky nemohou načíst vaše místnosti, dokud token nepochází od administrátora.

Čtyři nastavení, krok za krokem

Stejná dvě pole pokryjí velmi různé domácnosti. Čtyři příklady, s ukázkovými adresami:

Byt, jen pro domácí použití. Místní URL (LAN): http://192.168.1.50:8123. Vzdálená URL: prázdná. Hodinky fungují na domácí Wi-Fi; venku ukazují Offline · Home Assistant není dostupný, což se dá čekat. Připojit doma ukáže Připojeno ✓.

Home Assistant Cloud. Místní URL (LAN): http://192.168.1.50:8123. Vzdálená URL: https://xxxxx.ui.nabu.casa. Doma AmazHA používá místní adresu; na mobilních datech sama přejde na adresu Home Assistant Cloud. Připojit ukáže LAN i Vzdálený, doma oba zelené, protože cloudová adresa funguje i zevnitř.

VPN v telefonu. Místní URL (LAN): http://192.168.1.50:8123. Vzdálená URL: adresa serveru uvnitř VPN, s http:// napsaným na začátku, pokud tam server odpovídá obyčejným http. Doma vyhrává místní adresa. Mimo domov, s připojenou VPN, vyhrává vzdálená; s vypnutou VPN hodinky ukazují banner Offline, dokud ji znovu nezapnete.

Vlastní doména za reverzní proxy. Místní URL (LAN): http://192.168.1.50:8123. Vzdálená URL: https://ha.example.com. Aby to fungovalo, musí Home Assistant proxy důvěřovat (Trust X-Forwarded-For, Trusted proxies), jinak každý vzdálený požadavek dostane 400. Vzdálenou adresu testujte s vypnutou Wi-Fi: některé routery vaši vlastní doménu zpět dovnitř nesměrují, takže červený Vzdálený doma nemusí vždy znamenat, že venku selže.

Kontrolní seznam, než odejdete z domu

Pět minut doma vám ušetří pozdější zmatený pohled na hodinky:

1. Místní URL (LAN) obsahuje jen adresu serveru, tu, kterou doma používá váš prohlížeč.
2. Vzdálená URL obsahuje jen vzdálenou adresu: žádné /lovelace, port, pokud ho potřebuje, https:// přes internet.
3. Prohlížeč telefonu otevře vzdálenou adresu s vypnutou Wi-Fi a ukáže přihlašovací stránku Home Assistant, bez varování o certifikátu.
4. Pokud jde o VPN: VPN je v telefonu nastavená tak, aby zůstávala připojená.
5. Pokud jde o reverzní proxy nebo tunel: Home Assistant mu důvěřuje, takže žádná chyba 400.
6. Připojit ukazuje LAN a Vzdálený zeleně, nebo Připojeno ✓ s jednou adresou.
7. Token pochází od administrátora a je stejný pro obě adresy.

Když je tohle hotové, hodinky doma používají místní adresu a všude jinde vzdálenou, aniž byste cokoli dělali. A když jednoho dne ukážou Offline, druhý řádek vám řekne, kam se podívat: Telefon neodpovídá je Bluetooth, Home Assistant není dostupný je adresa.