Blog

Home Assistant unterwegs auf deiner Uhr: lokale URL, Remote-URL, Home Assistant Cloud und VPNs

Zu Hause funktioniert AmazHA mit deiner lokalen Adresse und sonst nichts; unterwegs braucht dein Handy eine zweite Adresse, die es erreichen kann. Wie die beiden zusammenspielen, die Möglichkeiten für den Fernzugriff im Vergleich und was jeder Fehler auf der Uhr bedeutet.

Veröffentlicht 20 Min. Lesezeit

In diesem Artikel
  1. Die kurze Antwort
  2. Zu Hause brauchst du nichts zusätzlich
  3. Warum dein Handy Home Assistant erreichen muss
  4. Wie AmazHA die Adresse wählt
    1. Mit einer Adresse
    2. Mit beiden Adressen
    3. Weggehen und heimkommen
    4. Die Adressen eingeben
  5. Die Möglichkeiten für den Fernzugriff im Vergleich
    1. Home Assistant Cloud (bald Home Assistant Link)
    2. Ein VPN: Tailscale, WireGuard und andere
    3. Deine eigene Domain mit HTTPS: ein Reverse Proxy oder ein Tunnel
    4. Nur eine Portweiterleitung
  6. HTTPS und Zertifikate unterwegs
  7. Häufige Fehler und was die Uhr sagt
    1. Offline · Home Assistant nicht erreichbar
    2. Falsche Adresse
    3. 400 Bad Request hinter einem Reverse Proxy
    4. Offline · Telefon antwortet nicht
    5. Die eigene Einstellung für die externe URL in Home Assistant
  8. Zuerst im Browser des Handys testen
  9. Der Verbindungstest in AmazHA: LAN und Remote lesen
  10. Vier Einrichtungen, durchgespielt
  11. Eine Checkliste, bevor du aus dem Haus gehst
  12. Häufige Fragen

Die kurze Antwort

Zu Hause braucht AmazHA, eine Home-Assistant-App für Amazfit-Uhren, nur deine lokale Adresse, etwa http://192.168.1.50:8123, und nichts muss von außen erreichbar sein. Für den Fernzugriff unterwegs braucht dein Handy eine Remote-Adresse, die es erreichen kann: Home Assistant Cloud, ein VPN wie Tailscale oder WireGuard, oder deine eigene Domain mit HTTPS. Trag beide ein, und AmazHA wählt von selbst die, die funktioniert.

Zu Hause brauchst du nichts zusätzlich

In deinem Heimnetz braucht AmazHA nur die Adresse, mit der du Home Assistant zu Hause schon im Browser öffnest. Das ist das Feld Lokale URL (LAN) in den AmazHA-Einstellungen, und es reicht für sich allein: kein Abo, kein VPN, keine Domain, kein offener Port an deinem Router.

AmazHA hat in seinen Einstellungen zwei Adressfelder: Lokale URL (LAN) und Remote-URL. Jedes darf leer bleiben. Nutzt du die Uhr immer nur zu Hause, füll das lokale aus, lass das Remote-Feld leer, und du bist fertig. Eine Remote-Adresse kannst du später hinzufügen, an dem Tag, an dem die Uhr im Büro oder im Urlaub funktionieren soll, ohne sonst etwas anzufassen.

Die Felder sind in der Zepp-App unter Profil › deine Uhr › Apps › AmazHA › Einstellungen › Home Assistant. Sie erscheinen, sobald die Vollversion freigeschaltet ist (eine einmalige Freischaltung, kein Abo): Die kostenlose Version ist eine Live-Demo mit Beispieldaten und verbindet sich mit keinem Server. Die Anleitung Home Assistant verbinden zeigt den Schritt mit der lokalen Adresse im Video.

Eine typische lokale Adresse sieht so aus wie eine dieser (Beispiele, nimm deine eigene):

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

Gibst du bei Lokale URL (LAN) eine Adresse ohne http:// oder https:// ein, setzt AmazHA http:// davor, weil lokale Server meist einfaches http sprechen.

Warum dein Handy Home Assistant erreichen muss

Die Uhr spricht nie selbst mit Home Assistant. Sie spricht per Bluetooth mit deinem Handy, und der Teil von AmazHA, der in der Zepp-App auf dem Handy läuft, ist der einzige, der Anfragen an deinen Server sendet. Die Frage „Kann meine Uhr Home Assistant erreichen?“ lautet also eigentlich „Kann mein Handy Home Assistant erreichen, jetzt gerade, von dort aus, wo es ist?“

Das hat ein paar praktische Folgen:

  • Die Uhr braucht kein WLAN. Für AmazHA wählt sie sich nie in ein Netz ein. Eine Uhr nur mit Bluetooth funktioniert genauso.
  • Das Handy muss in der Nähe sein, mit eingeschaltetem Bluetooth und laufender Zepp-App. Ist es das nicht, zeigt die Uhr Offline · Telefon antwortet nicht, und das ist ein anderes Problem als eine falsche Adresse (siehe Fehlerbehebung, Schritt 2).
  • Das Netz, in dem das Handy gerade ist, entscheidet, welche Adresse funktioniert. In deinem WLAN zu Hause funktioniert die lokale Adresse. Mit mobilen Daten, bei Freunden oder im Hotel-WLAN kann nur eine Remote-Adresse funktionieren, und nur, wenn das Handy sie von dort aus erreicht.
  • Ein VPN muss auf dem Handy verbunden sein, nicht auf der Uhr. Die Uhr weiß nichts davon.
  • Dein Token bleibt auf dem Handy. Du fügst ein langlebiges Zugriffstoken einmal in den AmazHA-Einstellungen ein. Die Uhr bekommt nur, was sie anzeigt, über die Bluetooth-Verbindung, die sie ohnehin mit dem Handy hat; das Token wird nie an sie gesendet.

Das erklärt ein verwirrendes Bild: Die Einstellungen zeigen Verbunden und die Uhr zeigt Offline. Die Einstellungen testen nur den Weg vom Handy zu Home Assistant; die Uhr braucht zusätzlich den Bluetooth-Weg zum Handy.

Wie AmazHA die Adresse wählt

AmazHA wählt die Adresse selbst, zuerst lokal, dann remote. Es gibt keinen Schalter, den du beim Verlassen des Hauses umlegen musst, und du wählst nie von Hand zwischen den beiden Feldern.

Mit einer Adresse

Ist nur ein Feld ausgefüllt, nutzt AmazHA einfach dieses. Es wird nichts geprüft und nichts gewechselt. Eine Einrichtung nur mit lokaler Adresse funktioniert zu Hause und zeigt unterwegs das Banner Offline; eine nur mit Remote-Adresse funktioniert überall, wo das Handy diese Adresse erreicht.

Mit beiden Adressen

Sind beide Felder ausgefüllt, fragt das Handy beide Adressen gleichzeitig, ob Home Assistant antwortet, mit einem kurzen Zeitlimit von 1,5 Sekunden. Antwortet die lokale Adresse, nutzt AmazHA sie. Antwortet nur die Remote-Adresse, nutzt es diese. Der Gewinner wird gemerkt, spätere Anfragen gehen also direkt an ihn, ohne erneut zu fragen.

Die Prüfung ist strenger als „irgendetwas hat geantwortet“. Eine Adresse zählt nur, wenn sie als Home-Assistant-API antwortet. Das ist in fremden Netzen wichtig: Im Hotel-WLAN kann 192.168.1.50 ein Drucker, die Seite eines Routers oder ein Captive Portal sein, das mit einer Webseite antwortet. AmazHA hält das nicht für deinen Server und bleibt deshalb nicht an deiner lokalen Adresse hängen, während die richtige Antwort deine Remote-Adresse wäre.

Weggehen und heimkommen

Die gemerkte Adresse bleibt, bis eine Anfrage an sie scheitert. Verlässt du das Haus und das Handy fällt aus deinem WLAN, scheitert die nächste Anfrage an die lokale Adresse, AmazHA vergisst sie, und der folgende Versuch fragt wieder beide Adressen und landet bei der Remote-Adresse. Solange die AmazHA-App geöffnet ist, aktualisiert die Uhr alle 8 Sekunden; in der Praxis kann also die erste Aktualisierung nach dem Wechsel scheitern und kurz das Banner Offline zeigen, und die nächste bringt alles wieder in Ordnung.

Heimkommen funktioniert umgekehrt, und leiser: Funktioniert deine Remote-Adresse auch innerhalb deines Netzes, nutzt AmazHA sie weiter, bis eine Anfrage scheitert oder du erneut auf Verbinden tippst. Dann ist nichts falsch; die Remote-Adresse funktioniert einfach weiterhin.

Die Adressen eingeben

Ein paar Details solltest du beim Ausfüllen der Felder kennen:

  • Nichts hinter der Server-Adresse. http://192.168.1.50:8123, nicht http://192.168.1.50:8123/lovelace. Dasselbe gilt für die Remote-Adresse: https://xxxxx.ui.nabu.casa, nicht https://xxxxx.ui.nabu.casa/lovelace. Mit einem Pfad dahinter antwortet die Adresse, aber nicht als Home-Assistant-API.
  • Das Schema. Ohne eingegebenes Schema bekommt Lokale URL (LAN) http:// und Remote-URL https://. Schreib http:// selbst davor, wenn eine Remote-Adresse wirklich einfaches http ist (eine VPN-Adresse zum Beispiel).
  • Der Port. Behalte den Port, wenn deine Adresse einen braucht, wie bei :8123. Ohne Port bedeutet https:// den Port 443.
  • Ein Token für beide. Füge es einmal bei Langlebiges Zugriffstoken ein; es gilt für die lokale und die Remote-Adresse. Beide Adressen müssen zum selben Home Assistant führen.

Die Anleitung Home Assistant verbinden behandelt den Schritt mit der Remote-Adresse und Schritt 8 den Test danach.

Die Möglichkeiten für den Fernzugriff im Vergleich

Jede Remote-Adresse funktioniert mit AmazHA, solange das Handy sie von seinem Standort aus öffnen kann und sie als Home-Assistant-API antwortet. Welche du nimmst, ist eine Entscheidung für Home Assistant, nicht für AmazHA. Hier die gängigen im Vergleich.

Möglichkeit Was bei Remote-URL steht Offene Ports zu Hause HTTPS und Zertifikat Kosten Das Handy braucht
Home Assistant Cloud von Nabu Casa (wird am 2. Dezember 2026 zu Home Assistant Link) Die Remote-Adresse, die es für dich erzeugt, https://xxxxx.ui.nabu.casa Keine Inklusive Abo Nichts weiter
VPN, etwa Tailscale oder WireGuard Die Adresse von Home Assistant im VPN Keine bei Tailscale; einer bei einem selbst betriebenen WireGuard-Server Der Tunnel ist verschlüsselt; https nur, wenn du es einrichtest Es gibt kostenlose Angebote Das VPN verbunden
Deine eigene Domain über einen Tunnel, etwa Cloudflare Tunnel https://ha.example.com Keine Vom Tunnel bereitgestellt Meist eine Domain Nichts weiter
Deine eigene Domain mit einem Reverse Proxy https://ha.example.com Einer (meist 443) Richtest du selbst ein, zum Beispiel mit Let’s Encrypt Eine Domain oder ein kostenloser DynDNS-Name Nichts weiter
Portweiterleitung direkt zu Home Assistant https://yourname.duckdns.org:8123 Einer Richtest du selbst ein Kostenloses DynDNS gibt es Nichts weiter

Home Assistant Cloud ist der Abo-Dienst von Nabu Casa; seine Abos finanzieren die Vollzeit-Entwicklung von Home Assistant. Die Dokumentation von Home Assistant nennt ihn für die meisten Menschen die einfachste Möglichkeit: Er braucht keine offenen Router-Ports, er verschlüsselt den Verkehr und er erzeugt eine eindeutige Remote-URL für dich.

Für AmazHA ist diese Remote-URL alles, was du brauchst: Kopiere sie so, wie Home Assistant sie anzeigt, in Remote-URL, ohne etwas dahinter. Dein langlebiges Zugriffstoken funktioniert darüber genauso wie mit deiner lokalen Adresse, weil beide zum selben Server führen.

Am 2. Oktober 2026 hat Nabu Casa angekündigt, dass Home Assistant Cloud am 2. Dezember 2026 in Home Assistant Link umbenannt wird. Laut Ankündigung ist es dasselbe Abo unter neuem Namen, und du musst nichts tun. Eine Änderung der Adresse wird nicht erwähnt, in AmazHA gibt es heute also nichts zu ändern.

Ein VPN: Tailscale, WireGuard und andere

Ein VPN holt dein Handy virtuell in dein Heimnetz, wo auch immer es gerade ist. Die Dokumentation von Home Assistant nennt VPN-Dienste wie Tailscale und ZeroTier One als sicheren Zugang und weist auf den Haken hin: Das VPN muss verbunden sein, bevor irgendetwas Home Assistant von außen erreichen kann. Für AmazHA heißt das: Das VPN muss auf dem Handy verbunden sein. Bricht es ab, zeigt die Uhr Offline · Home Assistant nicht erreichbar, bis es wieder steht.

Bei Remote-URL trägst du die Adresse ein, die dein Handy für Home Assistant nutzt, während das VPN aktiv ist: die Adresse des Servers im VPN oder einen Namen, den dein VPN dafür auflöst. Zwei Details:

  • Antwortet dein Server dort mit einfachem http, schreib http:// vor die Adresse. Ohne Schema setzt AmazHA https:// vor die Remote-Adresse, und darauf käme keine Antwort.
  • Bei manchen VPN-Einrichtungen wird deine Heimadresse selbst, 192.168.1.50, durch den Tunnel erreichbar. Dann funktioniert die lokale Adresse überall, wo das VPN an ist, und das Remote-Feld ist ein Ersatz für die Zeit, in der es aus ist.

Ein VPN ist die Möglichkeit mit der geringsten Angriffsfläche: Nichts von deinem Server ist zum Internet hin offen. Der Preis ist, dass jedes Gerät, das Home Assistant braucht, das Handy eingeschlossen, den VPN-Client ausführen muss.

Deine eigene Domain mit HTTPS: ein Reverse Proxy oder ein Tunnel

Mit deiner eigenen Domain führt https://ha.example.com von überall zu deinem Home Assistant. Zwei gängige Wege dorthin:

  • Ein Reverse Proxy (Nginx, Caddy, Traefik oder Ähnliches) zu Hause nimmt die Anfragen auf Port 443 entgegen, kümmert sich um das Zertifikat und reicht die Anfragen an Home Assistant weiter. Er braucht eine Portweiterleitung an deinem Router.
  • Ein Tunnel wie Cloudflare Tunnel betreibt einen kleinen Connector in deinem Netz, der eine ausgehende Verbindung zum Anbieter offen hält, sodass an deinem Router nichts geöffnet wird. Der Anbieter liefert deine Domain mit einem gültigen Zertifikat aus.

In beiden Fällen sitzt etwas vor Home Assistant und leitet Anfragen an es weiter, und Home Assistant muss angewiesen werden, ihm zu vertrauen. Die Dokumentation von Home Assistant sagt ausdrücklich, dass Anfragen von einem Reverse Proxy blockiert werden, sofern du nicht Trust X-Forwarded-For (X-Forwarded-For vertrauen) einschaltest und den Proxy unter Trusted proxies (vertrauenswürdige Proxys) hinzufügst. Lässt du das weg, bekommt jede Anfrage über den Proxy 400 Bad Request (mehr dazu unten).

Nur eine Portweiterleitung

Einen Router-Port direkt an Home Assistant weiterzuleiten, ist der direkteste Weg, und der, bei dem die Fernzugriffs-Dokumentation von Home Assistant am vorsichtigsten ist: Einfach einen Port zu öffnen, ist nicht sicher, der Verkehr muss verschlüsselt sein, und du solltest ihre Sicherheits-Checkliste durchgehen, bevor du irgendetwas freigibst. Sie nennt außerdem zwei praktische Fallen: Viele Internetanbieter geben dir eine dynamische IP-Adresse, weshalb sie einen DynDNS-Namen wie DuckDNS vorschlägt, und manche Anbieter setzen dich hinter CG-NAT, wo eingehende Verbindungen dich gar nicht erreichen.

Gehst du diesen Weg, ist die Remote-Adresse dein DynDNS-Name mit https und dem weitergeleiteten Port, zum Beispiel https://yourname.duckdns.org:8123. Trag genau das bei Remote-URL ein.

HTTPS und Zertifikate unterwegs

Unterwegs ist die Regel aus der Anleitung Wenn etwas nicht klappt kurz: Die Adresse braucht https mit einem gültigen Zertifikat. Dafür gibt es zwei Gründe.

Der erste ist die Sicherheit. Dein langlebiges Zugriffstoken reist mit jeder Anfrage mit, die das Handy sendet. Über einfaches http im offenen Internet kann es jeder auf dem Weg mitlesen und damit dein Zuhause steuern.

Der zweite ist, dass Handys Zertifikate ablehnen, denen sie nicht vertrauen. Ein selbst signiertes Zertifikat, auf deinem eigenen Server erstellt, ist nicht von einer Stelle signiert, der das Handy von Haus aus vertraut, also wird die Verbindung abgelehnt, bevor sie Home Assistant überhaupt erreicht. Auf der Uhr sieht das aus wie jeder andere nicht erreichbare Server. Die einfache Lösung ist ein Zertifikat, dem das Handy schon vertraut:

  • Home Assistant Cloud und Tunnel wie Cloudflare Tunnel stellen eines für dich bereit.
  • Mit deiner eigenen Domain oder einem DynDNS-Namen sind Zertifikate von Let’s Encrypt kostenlos, und Handys vertrauen ihnen.

Zwei Fallstricke erwischen alle, die HTTPS auf Home Assistant selbst einrichten statt auf einem Proxy davor:

  • Auch die lokale Adresse ändert sich. Sobald Home Assistant auf seinem Port HTTPS ausliefert, antwortet einfaches http://192.168.1.50:8123 auf diesem Port nicht mehr.
  • Eine IP-Adresse passt nicht zum Zertifikat. Ein Zertifikat für ha.example.com gilt nicht für https://192.168.1.50:8123, diese lokale Adresse fällt also bei der Zertifikatsprüfung durch. Ein Reverse Proxy oder ein Tunnel für die Remote-Seite, während Home Assistant zu Hause bei einfachem http bleibt, vermeidet beides.

Einfaches http ist für die lokale Adresse zu Hause normal und in Ordnung. In einem VPN, dessen Tunnel bereits verschlüsselt ist, kann http ebenfalls akzeptabel sein; im offenen Internet nimm https.

Häufige Fehler und was die Uhr sagt

Wenn etwas nicht stimmt, sagt die Uhr, welche Verbindung gescheitert ist. Die Tabelle listet die Meldungen, die mit Adressen zu tun haben, und die eine, die ähnlich aussieht, es aber nicht ist.

Auf der Uhr Was es bedeutet Lösung
Offline · Home Assistant nicht erreichbar · Erneut alle 8 s Das Handy konnte Home Assistant unter keiner der eingetragenen Adressen erreichen Öffne die Adresse im Browser des Handys, von dort aus, wo das Handy ist; unterwegs https mit einem gültigen Zertifikat
Falsche Adresse · Sie antwortet, aber es ist nicht die Home-Assistant-API Etwas hat geantwortet, aber nicht die Home-Assistant-API: meist ein Pfad wie /lovelace hinter der Adresse Lass nur die Server-Adresse stehen, nichts dahinter
Offline · Telefon antwortet nicht Die Uhr konnte das Handy nicht erreichen; die Adresse spielt keine Rolle Handy in der Nähe, Bluetooth an, Zepp-App läuft
Admin-Token nötig Die Adresse funktioniert, aber das Token gehört einem Benutzer ohne Administratorrechte Erstelle als Administrator ein langlebiges Token

Offline · Home Assistant nicht erreichbar

Das Banner zeigt Offline, dann Home Assistant nicht erreichbar · Erneut alle 8 s, und darunter einen kurzen Code, der dem Support genau verrät, was schiefgelaufen ist. Die üblichen Ursachen: Du bist unterwegs und hast nur eine lokale Adresse; das VPN ist auf dem Handy nicht verbunden; die Remote-Adresse funktioniert zu Hause, aber nicht von außen; das Handy vertraut dem Zertifikat nicht; oder Home Assistant selbst ist ausgefallen oder startet gerade neu. Die Lösung beginnt immer gleich: Öffne die Adresse im Browser des Handys, wie unten beschrieben. Die Anleitung Wenn etwas nicht klappt, Schritt 3, zeigt diese Meldung im Video.

Falsche Adresse

Falsche Adresse heißt, dass die Adresse geantwortet hat, aber mit einer Webseite statt der Home-Assistant-API. Fast immer hängt an der Adresse ein Pfad, meist aus der Adressleiste des Browsers kopiert: https://ha.example.com/lovelace/0 statt https://ha.example.com. Entferne alles hinter der Server-Adresse (und ihrem Port). In den AmazHA-Einstellungen sagt der Verbindungstest dasselbe mit eigenen Worten: Die Adresse antwortet, aber nicht mit der Home-Assistant-API, und er nennt als Beispiel eine Adresse von Home Assistant Cloud mit und ohne /lovelace. Siehe Fehlerbehebung, Schritt 4. Seltener führt die Adresse zu etwas ganz anderem, etwa zur Verwaltungsseite eines Routers.

400 Bad Request hinter einem Reverse Proxy

Läuft deine Remote-Adresse über einen Reverse Proxy oder einen Tunnel und kommt jede Anfrage mit 400 Bad Request zurück, weist Home Assistant den Proxy ab. Seine HTTP-Integration lehnt jede Anfrage mit einem Forwarded-For-Header ab, wenn sie nicht angewiesen wurde, Reverse Proxys zu vertrauen, oder wenn die Adresse des Proxys nicht auf ihrer Vertrauensliste steht, und die Antwort ist in beiden Fällen 400. Das Log von Home Assistant nennt die Adresse, von der die Anfrage kam; im zweiten Fall lautet es „Received X-Forwarded-For header from an untrusted proxy“, gefolgt von dieser Adresse.

In AmazHA zeigt Verbinden bei einer einzigen Adresse Fehler 400, bei beiden einen roten Punkt neben Remote.

Die Lösung liegt auf der Seite von Home Assistant. In aktuellen Versionen sind die Einstellungen des HTTP-Servers in der Oberfläche: Einstellungen › System › Netzwerk, schalte Trust X-Forwarded-For ein und füge die Adresse oder das Netz des Proxys unter Trusted proxies hinzu. Ältere Versionen nutzen YAML in configuration.yaml (die Adresse unten ist ein Beispiel; nimm die deines Proxys):

http:
  use_x_forwarded_for: true
  trusted_proxies:
    - 192.168.1.10

Die Dokumentation der HTTP-Integration von Home Assistant hat die Details für jede Version. Starte Home Assistant neu, wenn deine Version es braucht, und tippe dann erneut auf Verbinden.

Offline · Telefon antwortet nicht

Hier geht es gar nicht um Adressen. Die Uhr konnte das Handy per Bluetooth nicht erreichen, also hatte das Handy gar keine Gelegenheit, Home Assistant zu versuchen. Halte das Handy in der Nähe, mit eingeschaltetem Bluetooth und laufender Zepp-App (Fehlerbehebung, Schritt 2). Adressen zu ändern, hilft hier nicht.

Die eigene Einstellung für die externe URL in Home Assistant

Home Assistant hat eigene Einstellungen für die Home-Assistant-URL, mit einem Feld Internet und einem Feld Lokales Netzwerk unter Einstellungen › System › Netzwerk. Sie sagen Home Assistant und seinen eigenen Apps, wo es zu finden ist. AmazHA liest sie nicht: Es nutzt nur die beiden Adressen, die in seinen eigenen Einstellungen stehen. Hast du deine externe URL in Home Assistant geändert und die Uhr ist nicht gefolgt, liegt es daran. Kopiere die neue Adresse in Remote-URL.

Zuerst im Browser des Handys testen

Bevor du in AmazHA etwas änderst, öffne die Adresse im Browser desselben Handys, am selben Ort. Schneller geht kein Test, weil er denselben Weg nimmt wie AmazHA: das Handy, sein aktuelles Netz, deine Adresse.

  1. Schalte das WLAN aus, wenn du die Remote-Adresse von zu Hause aus testest, damit das Handy wirklich über mobile Daten hinausgeht. Schalte das VPN ein, wenn die Remote-Adresse es braucht.
  2. Gib genau die Adresse ein, die du in AmazHA eingetragen hast, zum Beispiel https://ha.example.com.
  3. Lies das Ergebnis.
Der Browser zeigt Was es dir sagt
Die Anmeldeseite von Home Assistant Adresse und Zertifikat sind in Ordnung: Das Problem liegt woanders (Pfad, Token, Bluetooth)
Eine Zertifikatswarnung Das Handy vertraut dem Zertifikat nicht; AmazHA kann diese Adresse so nicht nutzen
Nichts, oder „Seite nicht erreichbar“ Das Handy erreicht die Adresse aus diesem Netz nicht
400 Bad Request Ein Reverse Proxy, dem Home Assistant noch nicht vertraut
Eine andere Seite (Router, Anbieter, Standardseite des Proxys) Die Adresse führt woandershin

Für die lokale Adresse machst du dasselbe mit eingeschaltetem WLAN, zu Hause. Erreicht der Browser die Anmeldeseite und AmazHA scheitert trotzdem, prüf, ob im Feld nur die Server-Adresse steht, ohne etwas dahinter, und mit demselben Schema, das der Browser genutzt hat.

Du kannst im Browser auch /api/ an die Adresse anhängen. Home Assistant antwortet darauf mit einem Fehler zur Authentifizierung, weil der Browser kein Token sendet: Das beweist, dass die Adresse zur Home-Assistant-API führt und nicht zu irgendeiner anderen Seite. In AmazHA gibst du die Adresse ohne /api/ ein.

Der Verbindungstest in AmazHA: LAN und Remote lesen

Verbinden testet in den AmazHA-Einstellungen die Adressen vom Handy aus und sagt dir, was es gefunden hat. Nachdem du darauf getippt hast, erscheint das Ergebnis in ein paar Sekunden:

  • Mit einer Adresse: Verbunden ✓, wenn Home Assistant antwortet, Nicht erreichbar, wenn nichts antwortet, Fehler mit einer Zahl, wenn etwas mit einem HTTP-Fehler geantwortet hat (zum Beispiel Fehler 400 oder Fehler 401), und Antwortet, aber nicht Home Assistant, wenn die Adresse mit etwas antwortet, das nicht die API ist.
  • Mit beiden Adressen: ein Ergebnis pro Adresse, LAN und Remote, jeweils mit einem farbigen Punkt: grün, wenn Home Assistant dort antwortet, orange, wenn etwas antwortet, aber nicht Home Assistant, rot, wenn es scheitert.

Lies es mit dem Standort des Handys im Kopf. Zu Hause kann ein rotes Remote normal sein (eine Domain, die innerhalb deines Netzes nicht zurückführt, ein ausgeschaltetes VPN) oder ein echtes Problem, also teste noch einmal mit ausgeschaltetem WLAN. Unterwegs ist ein rotes LAN zu erwarten; dort zählt nur Remote. Beide grün, einmal zu Hause und einmal mit mobilen Daten getestet, ist die Einrichtung, die dich überallhin begleitet. Schritt 8 der Anleitung Home Assistant verbinden zeigt den Bildschirm.

Funktioniert die Adresse, aber das Token stammt von einem Benutzer ohne Administratorrechte, sagt Verbinden das unter dem Ergebnis. Das ist ein Problem mit dem Token, nicht mit der Adresse: Der Adresstest klappt, aber die Uhr kann deine Räume erst laden, wenn das Token von einem Administrator stammt.

Vier Einrichtungen, durchgespielt

Dieselben zwei Felder decken sehr unterschiedliche Haushalte ab. Vier Beispiele, mit Beispieladressen:

Eine Wohnung, nur zu Hause genutzt. Lokale URL (LAN): http://192.168.1.50:8123. Remote-URL: leer. Die Uhr funktioniert im WLAN zu Hause; draußen zeigt sie Offline · Home Assistant nicht erreichbar, wie zu erwarten. Verbinden zeigt zu Hause Verbunden ✓.

Home Assistant Cloud. Lokale URL (LAN): http://192.168.1.50:8123. Remote-URL: https://xxxxx.ui.nabu.casa. Zu Hause nutzt AmazHA die lokale Adresse; mit mobilen Daten wechselt es von selbst zur Adresse von Home Assistant Cloud. Verbinden zeigt LAN und Remote, zu Hause beide grün, weil die Cloud-Adresse auch von innen funktioniert.

Ein VPN auf dem Handy. Lokale URL (LAN): http://192.168.1.50:8123. Remote-URL: die Adresse des Servers im VPN, mit http:// davor, wenn der Server dort einfaches http spricht. Zu Hause gewinnt die lokale Adresse. Unterwegs, mit verbundenem VPN, die Remote-Adresse; ist das VPN aus, zeigt die Uhr das Banner Offline, bis es wieder an ist.

Deine eigene Domain hinter einem Reverse Proxy. Lokale URL (LAN): http://192.168.1.50:8123. Remote-URL: https://ha.example.com. Damit es funktioniert, muss Home Assistant dem Proxy vertrauen (Trust X-Forwarded-For, Trusted proxies), sonst bekommt jede Remote-Anfrage eine 400. Teste die Remote-Adresse mit ausgeschaltetem WLAN: Manche Router leiten deine eigene Domain nicht nach innen zurück, ein rotes Remote zu Hause heißt also nicht immer, dass es draußen scheitert.

Eine Checkliste, bevor du aus dem Haus gehst

Fünf Minuten zu Hause ersparen dir später einen ratlosen Blick auf die Uhr:

  1. Lokale URL (LAN) enthält nur die Server-Adresse, die dein Browser zu Hause nutzt.
  2. Remote-URL enthält nur die Remote-Adresse: kein /lovelace, den Port, wenn sie einen braucht, https:// über das Internet.
  3. Der Browser des Handys öffnet die Remote-Adresse mit ausgeschaltetem WLAN und zeigt die Anmeldeseite von Home Assistant, ohne Zertifikatswarnung.
  4. Bei einem VPN: Das VPN ist so eingestellt, dass es auf dem Handy verbunden bleibt.
  5. Bei einem Reverse Proxy oder einem Tunnel: Home Assistant vertraut ihm, also keine 400.
  6. Verbinden zeigt LAN und Remote grün, oder Verbunden ✓ mit einer Adresse.
  7. Das Token stammt von einem Administrator und ist für beide Adressen dasselbe.

Ist das erledigt, nutzt die Uhr zu Hause deine lokale Adresse und überall sonst die Remote-Adresse, ohne dass du etwas tun musst. Und zeigt sie eines Tages Offline, sagt dir die zweite Zeile, auf welcher Seite du suchen musst: Telefon antwortet nicht ist Bluetooth, Home Assistant nicht erreichbar ist die Adresse.

Häufige Fragen

Brauche ich Home Assistant Cloud (Nabu Casa), um AmazHA zu nutzen?

Nein. Zu Hause funktioniert AmazHA allein mit deiner lokalen Adresse, zum Beispiel http://192.168.1.50:8123. Home Assistant Cloud ist ein Weg, deinen Server unterwegs zu erreichen; ein VPN oder deine eigene Domain mit HTTPS funktionieren genauso gut. Trag das, was du nutzt, bei Remote-URL ein.

Funktioniert AmazHA nur mit einer lokalen Adresse?

Ja. Füll Lokale URL (LAN) aus, lass Remote-URL leer, und die Uhr funktioniert, sobald dein Handy in deinem Heimnetz ist. Unterwegs zeigt sie Offline · Home Assistant nicht erreichbar, bis das Handy wieder in diesem Netz ist.

Kann ich Tailscale oder ein anderes VPN nutzen?

Ja, solange das VPN auf dem Handy verbunden ist, denn das Handy spricht mit Home Assistant. Trag die Adresse, die Home Assistant im VPN hat, bei Remote-URL ein. Schreib http:// davor, wenn dein Server dort kein HTTPS anbietet: Ohne Schema setzt AmazHA https:// vor die Remote-Adresse.

Meine externe URL funktioniert im Browser, aber nicht auf der Uhr. Warum?

Prüf drei Dinge. Die Adresse bei Remote-URL muss nur die Server-Adresse sein, ohne etwas dahinter (kein /lovelace). Das Handy muss sie von dort aus öffnen, wo es gerade ist, mit ausgeschaltetem WLAN. Und über das Internet braucht sie https mit einem gültigen Zertifikat. Die Home-Assistant-eigene URL-Einstellung Internet liest AmazHA nicht: Die Adresse muss in AmazHA selbst eingetragen werden.

Warum bekomme ich über meinen Reverse Proxy 400 Bad Request?

Home Assistant weist Anfragen ab, die von einem Proxy weitergeleitet werden, dem es nicht vertrauen soll, und antwortet mit 400. Schalte Trust X-Forwarded-For ein und füge die Adresse des Proxys unter Trusted proxies hinzu (in aktuellen Versionen unter Einstellungen › System › Netzwerk; in älteren use_x_forwarded_for und trusted_proxies unter http:).

Reicht http unterwegs, oder brauche ich https?

Nutze über das Internet https mit einem gültigen Zertifikat: Das Token reist bei jeder Anfrage mit, und Handys lehnen Zertifikate ab, denen sie nicht vertrauen, etwa selbst signierte. Einfaches http:// ist für die lokale Adresse zu Hause normal und kann in einem VPN in Ordnung sein, dessen Tunnel bereits verschlüsselt ist.

Funktioniert eine DuckDNS-Adresse?

Ja, wenn dein Handy sie mit ausgeschaltetem WLAN öffnen kann und sie ein gültiges Zertifikat hat, meist von Let’s Encrypt. Trag die ganze Adresse bei Remote-URL ein, mit dem Port, wenn er nicht 443 ist, zum Beispiel https://yourname.duckdns.org:8123. Das bedeutet normalerweise eine Portweiterleitung an deinem Router, lies also zuerst die Sicherheitshinweise in der Fernzugriffs-Dokumentation von Home Assistant.

Funktioniert Home Assistant Cloud weiter, wenn es zu Home Assistant Link wird?

Nabu Casa hat am 2. Oktober 2026 angekündigt, dass Home Assistant Cloud am 2. Dezember 2026 in Home Assistant Link umbenannt wird, und sagt, es sei dasselbe Abo, ohne dass du etwas tun musst. Die Ankündigung erwähnt keine Änderung der Adresse, behalte also die Remote-Adresse, die du heute nutzt, bei Remote-URL.

Im Video ansehen

Die kurzen Anleitungen, auf denen dieser Artikel aufbaut: Videos auf Englisch, jeder Schritt auf Deutsch ausgeschrieben.

Alle Artikel