ESP32 .local geht nicht auf Android: mDNS erklärt
Warum ein ESP32-.local-Name wie gizmo-ticker.local auf Android oder am Router scheitert, wie du die Ursache findest und die IP-Adresse mit Reservierung nutzt.
- Autor
Mauro Brambilla- Veroffentlicht
- Lesezeit
- 8 Min.
- Kategorie
- Fehlerbehebung

Kurz gesagt
Ein .local-Name braucht mDNS: eine Multicast-Anfrage auf UDP 5353, die Handy, Router und ESP32 durchlassen müssen. Klappt das nicht, nimm die IP-Adresse des Boards und reserviere sie im Router.
Ein .local-Name des ESP32 scheitert, wenn das anfragende Gerät keine mDNS-Anfrage senden kann oder nie eine Antwort bekommt. mDNS (Multicast-DNS) fragt alle Geräte im WLAN gleichzeitig, statt einen DNS-Server zu benutzen. Gast-WLANs, VPNs, Mobilfunk, manche Router und Android-Resolver ohne mDNS können das kaputt machen. Der Ausweg ist die IP-Adresse des Boards.
Als Beispiel nehme ich in dieser Anleitung die drei OpenGizmo-Geräte, denn jedes meldet nach dem Verbinden mit deinem WLAN einen .local-Namen an: gizmo-ticker.local, gizmo-reolink-switch.local und gizmo-camera.local. Ich habe die Firmware, die Bibliothek gizmo-common und die unten verlinkten Quellen von AOSP, Apple, Espressif und aus den RFCs gelesen, und ich kennzeichne, was ich nicht prüfen konnte. Wenig Zeit? Spring zur Checkliste und komm danach für das Warum zurück.
Was ist mDNS und wie wird gizmo-ticker.local aufgelöst?
mDNS ist in RFC 6762 definiert. Es schickt Nachrichten im DNS-Stil per IP-Multicast an UDP-Port 5353 und behandelt jeden Namen, der auf .local. endet, als Link-Local, also nur in dem Netz gültig, in dem er angekündigt wurde. Anfragen gehen an 224.0.0.251 (IPv4) oder FF02::FB (IPv6). Es ist kein Server beteiligt: Das Gerät, dem der Name gehört, antwortet selbst.

Auf der ESP32-Seite macht die Bibliothek gizmo-common drei Dinge, alle in wifi_setup.cpp (Version 2.5.1, die der Ticker und der Reolink Switch festlegen; die Kamera nutzt 2.4.0, wo ich dasselbe MDNS.begin und dieselbe Host-Prüfung kontrolliert habe):
- Sie startet mDNS erst, nachdem das Board im WLAN ist:
startMdns()kehrt sofort zurück, außerWiFi.status() == WL_CONNECTED. - Sie ruft
MDNS.begin(hostname)auf und fügt mitMDNS.addService("http", "tcp", 80)einenhttp-Dienst auf TCP-Port 80 hinzu. - Sie stoppt mDNS wieder, wenn die Verbindung abbricht oder der Setup-Hotspot aufgeht, und startet es nach der nächsten erfolgreichen Verbindung neu.
Nach einem Router-Neustart ist der Name also weg, bis sich das Board neu verbindet. Der Hostname ist immer der Projektname und steht in der Firmware des jeweiligen Projekts, zum Beispiel in der wifi.cpp des Tickers: "gizmo-ticker". Der Gizmo Ticker, der Gizmo Reolink Switch und die Gizmo Camera funktionieren genauso. Wie das Board überhaupt in dein WLAN kam, steht in ESP32 Captive Portal funktioniert nicht? So behebst du das WLAN-Popup.
Warum scheitert .local auf manchen Android-Handys?
Ob .local-Namen funktionieren, hängt vom Resolver des Betriebssystems auf dem Client ab, nicht vom ESP32. Der ESP32 antwortet allen gleich: Löst ein Mac den Namen auf und ein Handy nicht, liegt es am Handy.
| Client | Löst .local-Namen auf? | Quelle und Datum |
|---|---|---|
| Android | Ja, über getaddrinfo(), seit November 2021, aber nicht über VPN oder Mobilfunk | AOSP-Seite zum DNS Resolver |
| macOS | Ja, über Bonjour | Apple-Dokumentation (Seite von 2013, OS-X-Zeit) |
| iOS | Auf dieser Apple-Seite nicht angegeben | Hier nicht geprüft |
| Linux mit systemd-resolved | Nur wenn mDNS für die Verbindung aktiviert ist: MulticastDNS= steht in systemd.network standardmäßig auf false | Man-Page von systemd.network |
| Windows 10 und 11 | Hier nicht geprüft | Keine Primärquelle gefunden |
Zu Android sagt die AOSP-Dokumentation zum DNS Resolver: "Starting from November 2021, Android resolver supports mDNS .local resolution". Sie setzt die einmalige Multicast-Anfrage aus RFC 6762 um, und Apps nutzen sie, indem sie getaddrinfo() mit einem *.local-Namen aufrufen. Dieselbe Seite sagt, dass VPN- und Mobilfunkverbindungen ausgenommen sind. Das habe ich im Resolver-Code bestätigt: res_cache.cpp hat eine Funktion is_mdns_supported_transport_types(), die für Mobilfunk- und VPN-Netze false zurückgibt, und res_send.cpp schickt die mDNS-Anfrage für Namen, die als mDNS markiert sind.
Welche Android-Versionen das haben, sagt die Seite nicht. Der Code liegt in packages/modules/DnsResolver, einem Modulverzeichnis, die Resolver-Version eines Handys muss also nicht zu seiner Android-Version passen. Ich habe keine Primärliste der Versionen gefunden, deshalb nenne ich keine. Tipps aus der Zeit vor November 2021 können veraltet sein.

Zwei weitere Dinge können auch auf einem neuen Handy noch Probleme machen:
- Die App muss den System-Resolver fragen. Ein Browser oder eine App, die eigene DNS-Abfragen macht, zum Beispiel mit einem eingebauten Secure-DNS-Client, kommt nie an diesen Code. Das ist meine Lesart der AOSP-Seite: Ich habe es auf keinem Handy getestet.
- Apps können das Gerät auch ohne den Namen finden. Das Board registriert einen
_http._tcp-Dienst, und Androids Network Service Discovery API sucht DNS-SD-Dienste im lokalen Netz. Sie ist für App-Entwickler gedacht, aber eine App, die sie nutzt, findet das Board über den Diensttyp, ohne den.local-Namen aufzulösen.
Ein Handy kannst du mit einem per adb verbundenen Computer testen: Die AOSP-Seite schlägt adb shell ping6 HOSTNAME.local vor, für den Ticker also adb shell ping6 gizmo-ticker.local. Antwortet das, der Browser aber nicht, liegt es wahrscheinlich am Browser oder seinen DNS-Einstellungen.
Wie findest du die IP-Adresse des ESP32?
Eine IP-Adresse braucht keine Namensauflösung, sie funktioniert also immer, wenn das Handy das Board erreicht. Die OpenGizmo-Geräte nehmen laut README von gizmo-common Anfragen unter drei Namen an: der IP-Adresse, <hostname> oder <hostname>.local. Alles andere ergibt den Fehler host_not_allowed. Das schützt das Board vor DNS-Rebinding, bedeutet aber auch, dass ein vom Router erfundener Name wie gizmo-ticker.lan die Web-App nicht öffnet: Nimm die IP.

Wo du sie ablesen kannst, nach Aufwand sortiert:
- Das Gerät selbst. Das LCD des Reolink Switch zeigt seine Adresse laut README auf dem NVR-Einrichtungsbildschirm, und die Geräteseite im Dashboard listet sie auf. Die Geräteseite und
GET /api/deviceliefern nach dem Verbindenipundhostname. Die Kameraseite der Gizmo-Camera-Web-App zeigt die genaue Adresse und den MCP-Befehl. - Das serielle Log. Ein Debug-Build der Reolink-Switch-Firmware loggt
Connected, open http://gizmo-reolink-switch.local or http://<ip>. Ob die anderen beiden diese Zeile haben, habe ich nicht geprüft. - Die Client-Liste deines Routers. Such nach einem neuen Gerät. Ohne in der Firmware gesetzten Hostnamen ist der DHCP-Name ein Standardname: Die Doku von Arduino-ESP32 sagt, er werde "assigned based on the chip type and MAC address". Soweit ich gelesen habe, ruft gizmo-common
WiFi.setHostname()nicht auf, erwarte also so einen Namen und nichtgizmo-ticker.
Öffne dann http://192.168.1.50 mit der Adresse deines Boards. Öffnet sich eine Seite über die IP, aber nicht über den Namen, sind Board und Web-App in Ordnung, und die Namensauflösung ist schuld.
Welche Router- und Netzwerkeinstellungen blockieren mDNS?
Mehrere Dinge im Netz können mDNS blockieren. Ändere immer nur eine Sache und teste dann erneut.
| Ursache | Was du siehst | Was du prüfen solltest |
|---|---|---|
| Client- oder AP-Isolation | Handy und Board online, der Name scheitert und die IP ebenfalls | Schalte die Client-Isolation für die SSID aus; vermeide Gast-WLANs |
| Verschiedene Subnetze oder VLANs | Der Name scheitert; die IP kann trotzdem gehen, wenn der Router dazwischen routet | Setze Handy und Board ins selbe Subnetz oder nimm die IP |
| Firewall auf dem anfragenden Computer | Der Name scheitert nur von einem Computer aus | Erlaube auf diesem Computer eingehendes UDP 5353 |
| VPN oder Mobilfunk am Handy | Der Name scheitert nur am Handy | Schalte das VPN aus; nutze WLAN |
Die Fehlerbehebungsseite von espboards.dev nennt als Ursachen unter anderem Blockaden im Router, eine Firewall auf UDP 5353 sowie isolierte Hotspots oder Gast-WLANs, dazu den Aufruf von MDNS.begin() erst nach dem Start des WLANs. Das ist eine Fehlersuchliste, keine Spezifikation, deshalb nutze ich sie als Checkliste, und die Reihenfolge bei MDNS.begin() habe ich selbst in gizmo-common geprüft. Der ESP32 selbst braucht keine Router-Einstellung.
Was dir der Test verrät:
- Die IP scheitert auch: Das Netz blockiert den Verkehr zwischen Clients (Isolation), oder der Router routet nicht zwischen den beiden Netzen. Kümmere dich zuerst darum: Es ist kein mDNS-Problem.
- Die IP geht, der Name scheitert auf jedem Gerät: Der mDNS-Responder des Boards läuft nicht, oder die Geräte sind in verschiedenen Subnetzen. Prüfe, ob das Board verbunden ist, und such im Log eines Debug-Builds nach
Failed to start mDNS. - Die IP geht, der Name klappt am Laptop, aber nicht am Handy: Es liegt am Handy, wie im Abschnitt oben.
Wie gibst du dem ESP32 eine feste Adresse?
Eine DHCP-Reservierung sagt dem Router, dass er derselben MAC-Adresse immer dieselbe IP gibt. Das Board nutzt also weiter DHCP, und du musst die Firmware nicht anfassen. Das ist meine Wahl für die OpenGizmo-Geräte, denn gizmo-common bezieht seine Adresse vom Router, und die Firmware ruft WiFi.config() nicht für eine statische auf.
- Such die MAC-Adresse des Boards in der Client-Liste des Routers, neben der aktuellen IP.
- Öffne im Router den Bereich DHCP oder LAN und such nach "Adressreservierung", "Static Lease" oder "IP an MAC binden". Die Namen unterscheiden sich von Router zu Router.
- Wähle eine Adresse im LAN-Bereich, außerhalb des DHCP-Pools, falls der Router das verlangt, und speichere.
- Starte das Board neu und prüfe, ob die Client-Liste jetzt die reservierte Adresse zeigt.
Eine statische IP in der Firmware ist die andere Möglichkeit. Die WiFi-API-Doku von Arduino-ESP32 beschreibt WiFi.config(), um lokale IP, Gateway, Subnetz und DNS-Server vor begin zu setzen. Dann musst du selbst Konflikte mit dem Pool des Routers vermeiden. Für einen Haushalt ist die Reservierung sicherer.
Falls du jemals zwei gleiche OpenGizmo-Geräte im selben Netz betreibst, versuchen beide, denselben .local-Namen zu beanspruchen. RFC 6762 Abschnitt 9 sagt, dass der Verlierer den Namen aufgeben und einen neuen wählen muss. Die Espressif-mDNS-Doku, die ich gelesen habe, beschreibt nicht, wie die ESP32-Komponente damit umgeht, und ich habe es nicht getestet, also erreiche jedes Gerät über seine eigene IP.
Wie setzt du den Hostnamen im Arduino-Code?
Es gibt zwei verschiedene Namen, und man verwechselt sie leicht. Der mDNS-Name ist der, den MDNS.begin() setzt. Der DHCP-Name, gesetzt mit WiFi.setHostname(), ist der, unter dem das Board in der Router-Liste auftaucht. Die Arduino-ESP32-Doku sagt, setHostname() "must be called BEFORE Wi-Fi is started", während mDNS erst nach der Verbindung startet. Das ist ein minimaler Sketch, aus dieser Doku und der Logik von gizmo-common gebaut und für diesen Artikel nicht kompiliert:
#include <WiFi.h>
#include <ESPmDNS.h>
void setup() {
WiFi.setHostname("gizmo-ticker"); // DHCP name in the router's list, before WiFi.begin()
WiFi.begin("my-ssid", "my-password");
while (WiFi.status() != WL_CONNECTED) {
delay(250);
}
// Only after the connection is up
if (MDNS.begin("gizmo-ticker")) {
MDNS.addService("http", "tcp", 80);
}
}
void loop() {}Du erreichst es unter http://gizmo-ticker.local. ESPmDNS prüft den Namen nicht, bleib also bei Kleinbuchstaben, Ziffern und Bindestrichen, wie bei den OpenGizmo-Hostnamen. Ein fertiges Beispiel mit Reconnects findest du in startMdns() in gizmo-common oder im Reolink-Switch-Projekt, das es nutzt.
Checkliste: Der .local-Name öffnet sich nicht
- Sind Handy und Board im selben WLAN, und ist das Handy im WLAN statt im Mobilfunk, bei ausgeschaltetem VPN?
- Öffnet die IP-Adresse des Boards die Web-App? Wenn nicht, behebe zuerst die Client-Isolation oder das Subnetz.
- Klappt der Name an einem Laptop im selben Netz? Wenn ja, ist das Board in Ordnung, und der Resolver des Handys oder die App ist die Ursache.
- Antwortet auf einem Handy mit
adbder Befehladb shell ping6 gizmo-ticker.local? - Hat sich das Board nach einem Router-Neustart neu verbunden? mDNS läuft nur, solange es verbunden ist.
- Beansprucht ein anderes Gerät denselben Namen?
- Hängst du immer noch fest? Nimm die IP und reserviere sie im Router, damit die Adresse nicht mehr wandert.
Bei der Kamera gilt dieselbe Regel für Skripte: Die Anleitung zur Snapshot-URL und die Anleitung zum MCP-Server funktionieren beide mit der IP statt gizmo-camera.local.
Was geprüft wurde und wo die Grenzen liegen
Ich habe die mDNS-Start- und Stopp-Logik und die Host-Prüfung in gizmo-common 2.5.1, die Hostnamen in den drei Firmwares sowie Code und Doku des Android-Resolvers gelesen, Stand November 2026. Nichts davon habe ich für diesen Artikel auf einem Handy, Router oder Board ausgeführt: Der adb-Befehl, die Router-Schritte und der Sketch sind aus den Quellen abgeleitet, nicht gemessen. Die Windows-Unterstützung ist nicht geprüft, keine Quelle, die ich fand, listet die Android-Versionen mit mDNS auf, und Router nennen ihre Einstellungen sehr unterschiedlich.
Scheitert der Name nach der Checkliste immer noch, ist die IP mit Reservierung keine Niederlage: Sie ist genau das, was ein Heimnetz will. Wie das Board an sein WLAN kam, vergleichst du in ESP32-WLAN-Provisioning: Captive Portal, BLE, Improv, und das ganze System siehst du unter Was ist OpenGizmo?.
Haufig gestellte Fragen
Finden Sie schnelle Antworten auf die haufigsten Fragen zu diesem Thema.
Ein .local-Name wird nur aufgelöst, wenn das Handy eine mDNS-Multicast-Anfrage sendet und der Router sie weiterleitet. Laut AOSP unterstützt der Android-Resolver das seit November 2021, aber nicht über VPN oder Mobilfunk, und ein Router mit Client-Isolation blockiert es. Zuverlässig ist, die IP-Adresse des ESP32 zu öffnen.
Autor
Mauro BrambillaLust, dein eigenes Gizmo zu bauen?
Such dir ein Open-Source-Projekt mit dem ESP32 aus und folge der Schritt-für-Schritt-Anleitung, von der Teileliste und der Verkabelung bis zur Firmware und zum ersten Start.





