[{"data":1,"prerenderedAt":597},["ShallowReactive",2],{"post-esp32-captive-portal-not-working-fix-de":3,"related-posts-esp32-captive-portal-not-working-fix-de":554,"related-categories-esp32-captive-portal-not-working-fix-de":581},{"id":4,"title":5,"author":6,"authorImageUrl":7,"authorUrl":8,"body":9,"categorySlug":516,"categoryText":517,"dateModified":518,"datePublished":518,"description":519,"extension":520,"faqs":521,"image":537,"imageAlt":538,"language":539,"meta":540,"navigation":541,"path":542,"seo":543,"sitemap":544,"stem":545,"summary":546,"tags":547,"__hash__":553},"blog\u002Fde\u002Fblog\u002Fesp32-captive-portal-not-working-fix.md","ESP32 Captive Portal öffnet sich nicht? Popup reparieren","Mauro Brambilla","\u002Fimages\u002Fauthors\u002Fbruma.jpg","\u002Fabout",{"type":10,"value":11,"toc":498},"minimark",[12,20,46,51,54,73,80,88,92,95,100,132,145,172,176,191,201,221,232,238,267,273,299,303,306,312,317,340,348,352,355,359,380,384,387,391,414,418,427,431,457,461,471,487,491],[13,14,15,19],"p",{},[16,17,18],"strong",{},"Ein ESP32 Captive Portal öffnet sich nicht",", wenn der Verbindungstest des Handys eine normal aussehende Antwort statt einer Weiterleitung bekommt. Das Board braucht einen DNS-Server, der jeden Namen mit seiner eigenen IP beantwortet, und einen Webserver, der die Probe-Anfrage auf die Einrichtungsseite umleitet. Fehlt eines von beiden, halten Android, iOS und Windows das Netzwerk für in Ordnung und zeigen nichts an.",[13,21,22,23,30,31,35,36,40,41,45],{},"Diese Anleitung folgt dem, was die Bibliothek ",[24,25,29],"a",{"href":26,"rel":27},"https:\u002F\u002Fgithub.com\u002Fopen-gizmo\u002Fgizmo-common",[28],"nofollow","gizmo-common"," wirklich tut, denn jedes OpenGizmo-Gerät (der ",[24,32,34],{"href":33},"\u002Fde\u002Fprojects\u002Fgizmo-ticker","Gizmo Ticker",", der ",[24,37,39],{"href":38},"\u002Fde\u002Fprojects\u002Fgizmo-reolink-switch","Gizmo Reolink Switch"," und die ",[24,42,44],{"href":43},"\u002Fde\u002Fprojects\u002Fgizmo-camera","Gizmo Camera",") startet seine erste WLAN-Einrichtung auf diese Weise. Ich habe ihren Quellcode und die unten verlinkten Quellen von Android, Apple, Microsoft und Arduino-ESP32 gelesen, und ich sage dazu, was ich nicht prüfen konnte. Zeigt dein Board das Popup gerade jetzt nicht? Spring zur Checkliste weiter unten und komm für das Warum zurück.",[47,48,50],"h2",{"id":49},"wie-funktioniert-ein-captive-portal-auf-dem-esp32","Wie funktioniert ein Captive Portal auf dem ESP32?",[13,52,53],{},"Ein Captive Portal ist eine Webseite, die das Handy von selbst öffnet, wenn es sich mit einem WLAN verbindet, das erst nach einer Anmeldung Internet hat. Hotels machen das so. Ein ESP32 kann denselben Trick für seine eigene Einrichtungsseite nutzen, ganz ohne Cloud. Der Ablauf ist kurz:",[55,56,57,61,64,67,70],"ol",{},[58,59,60],"li",{},"Der ESP32 startet einen Access Point (einen Hotspot) und einen DNS-Server auf Port 53.",[58,62,63],{},"Das Handy verbindet sich mit dem Hotspot und sendet eine Probe: eine DNS-Abfrage und dann eine HTTP-Anfrage an eine bekannte Adresse.",[58,65,66],{},"Der DNS-Server antwortet mit der IP des ESP32, egal welcher Name abgefragt wurde.",[58,68,69],{},"Der Webserver beantwortet die Probe mit einer Weiterleitung auf die Einrichtungsseite.",[58,71,72],{},"Das Handy merkt, dass die Antwort nicht die erwartete ist, und öffnet ein Anmeldefenster mit der Einrichtungsseite.",[13,74,75],{},[76,77],"img",{"alt":78,"src":79},"Ein Handy und ein ESP32 tauschen Schritt für Schritt eine DNS-Abfrage, eine HTTP-Probe und eine Weiterleitung auf \u002Fap-setup aus","\u002Fimages\u002Fblog\u002Fde\u002Fesp32-captive-portal-not-working-fix-flow.webp",[13,81,82,83,87],{},"Das Popup ist die Entscheidung des Handys, nicht deine. Du kannst ihm keine Seite aufdrängen: Du kannst der Probe nur eine Antwort geben, bei der das Handy sagt \"hier ist eine Anmeldung nötig\". Für andere Wege, einem Board sein WLAN zu geben, siehe ",[24,84,86],{"href":85},"\u002Fde\u002Fblog\u002Fesp32-wifi-provisioning-methods-compared","ESP32 WLAN-Provisioning: Captive Portal, BLE, Improv",".",[47,89,91],{"id":90},"welche-urls-rufen-android-iphone-und-windows-ab","Welche URLs rufen Android, iPhone und Windows ab?",[13,93,94],{},"Jedes Betriebssystem hat seine eigene Probe, und jedes hält eine andere Antwort für \"online\". Alles andere ist für sie ein Captive Portal.",[96,97],"blog-table",{":headers":98,":rows":99},"[\"OS\",\"Probe-Anfrage (Standard)\",\"Antwort, die online bedeutet\",\"Quelle\"]","[[\"Android\",\"http:\u002F\u002Fconnectivitycheck.gstatic.com\u002Fgenerate_204\",\"HTTP 204\",\"AOSP-NetworkStack-Konfiguration\"],[\"Windows 10 1607 und neuer, 11\",\"http:\u002F\u002Fwww.msftconnecttest.com\u002Fconnecttest.txt\",\"200 mit Microsoft Connect Test\",\"Microsoft Learn, NCSI-FAQ\"],[\"iOS und macOS\",\"http:\u002F\u002Fcaptive.apple.com\u002Fhotspot-detect.html\",\"Eine Seite mit Success\",\"Host in der Apple-Dokumentation, Pfad und Seite aus Community-Berichten\"]]",[13,101,102,103,108,109,113,114,117,118,123,124,127,128,131],{},"Die Standardwerte von Android stehen in der ",[24,104,107],{"href":105,"rel":106},"https:\u002F\u002Fandroid.googlesource.com\u002Fplatform\u002Fpackages\u002Fmodules\u002FNetworkStack\u002F+\u002Frefs\u002Fheads\u002Fmain\u002Fres\u002Fvalues\u002Fconfig.xml",[28],"Ressourcendatei von AOSP NetworkStack",": Die HTTP-Probe ist ",[110,111,112],"code",{},"http:\u002F\u002Fconnectivitycheck.gstatic.com\u002Fgenerate_204",", dazu kommen eine HTTPS-Probe auf ",[110,115,116],{},"https:\u002F\u002Fwww.google.com\u002Fgenerate_204"," und zwei Ersatzprüfungen. In der ",[24,119,122],{"href":120,"rel":121},"https:\u002F\u002Fandroid.googlesource.com\u002Fplatform\u002Fpackages\u002Fmodules\u002FNetworkStack\u002F+\u002Frefs\u002Fheads\u002Fmain\u002Fsrc\u002Fcom\u002Fandroid\u002Fserver\u002Fconnectivity\u002FNetworkMonitor.java",[28],"NetworkMonitor.java"," desselben Projekts wird eine 200-Antwort mit einem Body von höchstens 4 Bytes bewusst nicht als Portal behandelt, und eine Portal-Antwort ohne ",[110,125,126],{},"Location","-Header lässt Android 12 und neuer die Probe-URL als Anmeldeseite verwenden (der Code prüft ",[110,129,130],{},"SdkLevel.isAtLeastS()","). Handyhersteller können diese URLs überschreiben, nimm die Tabelle also als Standardverhalten.",[13,133,134,135,140,141,144],{},"Microsoft dokumentiert seine Seite in der ",[24,136,139],{"href":137,"rel":138},"https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fwindows-server\u002Fnetworking\u002Fncsi\u002Fncsi-frequently-asked-questions",[28],"NCSI-FAQ",": Seit Windows 10 Build 14393 ist die Probe ",[110,142,143],{},"www.msftconnecttest.com\u002Fconnecttest.txt",", und eine 200-Antwort, deren Body den erwarteten Text nicht enthält, oder eine 302 oder 304 wird als Hotspot gemeldet, der eine Anmeldung braucht.",[13,146,147,148,153,154,157,158,161,162,165,166,171],{},"Bei Apple ist die einzige Primärquelle, die ich gefunden habe, die ",[24,149,152],{"href":150,"rel":151},"https:\u002F\u002Fsupport.apple.com\u002Fen-us\u002F101555",[28],"Apple-Support-Liste der Hosts für Unternehmensnetzwerke",". Sie nennt ",[110,155,156],{},"captive.apple.com"," als Host für die \"Internet connectivity validation for networks that use captive portals\". Der Pfad ",[110,159,160],{},"\u002Fhotspot-detect.html"," und die Seite ",[110,163,164],{},"Success"," stammen aus Community-Beiträgen, nimm sie also als weit verbreitete Angabe, nicht als Apple-Spezifikation. Ein Apple-Ingenieur bestätigt außerdem in einer ",[24,167,170],{"href":168,"rel":169},"https:\u002F\u002Fdeveloper.apple.com\u002Fforums\u002Fthread\u002F747798",[28],"Antwort im Entwicklerforum",", dass macOS ein Captive-Netzwerk von der Standardroute fernhält, bis es das Portal für erledigt hält.",[47,173,175],{"id":174},"was-antwortet-gizmo-common","Was antwortet gizmo-common?",[13,177,178,179,182,183,190],{},"Die Bibliothek ist klein genug, um sie zu lesen. Gibt es kein gespeichertes Netzwerk oder schlägt ein Verbindungsversuch fehl, startet sie in ",[110,180,181],{},"startAccessPoint()"," in ",[24,184,187],{"href":185,"rel":186},"https:\u002F\u002Fgithub.com\u002Fopen-gizmo\u002Fgizmo-common\u002Fblob\u002Fv2.5.1\u002Fsrc\u002Fgizmo\u002Fwifi_setup.cpp",[28],[110,188,189],{},"wifi_setup.cpp"," einen offenen Hotspot und einen DNS-Server:",[192,193,199],"pre",{"className":194,"code":196,"filename":189,"language":197,"meta":198},[195],"language-cpp","accessPointEnabled = WiFi.softAP(setupOptions.accessPointName);\n\u002F\u002F Answer every DNS name with the hotspot address, so phones open the setup page\ndnsServer->start(DNS_PORT, \"*\", WiFi.softAPIP());\n","cpp","",[110,200,196],{"__ignoreMap":198},[13,202,203,206,207,210,211,216,217,220],{},[110,204,205],{},"DNS_PORT"," ist 53, und ",[110,208,209],{},"\"*\""," bedeutet \"jeder Name\". Im ",[24,212,215],{"href":213,"rel":214},"https:\u002F\u002Fraw.githubusercontent.com\u002Fespressif\u002Farduino-esp32\u002Fmaster\u002Flibraries\u002FDNSServer\u002Fsrc\u002FDNSServer.cpp",[28],"DNSServer-Quellcode"," von Arduino-ESP32 passt eine leere oder Platzhalter-Domain auf alles, A- und ANY-Abfragen bekommen die IP, und andere Typen wie AAAA bekommen eine leere Antwort. Das ist der aktuelle master-Branch: Den älteren Core, den PlatformIO mit ",[110,218,219],{},"espressif32 @ 8.0.0"," festlegt, habe ich nicht geprüft.",[13,222,223,224,227,228,231],{},"Die HTTP-Hälfte ist ",[110,225,226],{},"handleCaptivePortalRequest()",", das zuerst im Not-found-Handler des Webservers aufgerufen wird. Es betrifft nur GET- und HEAD-Anfragen, die über den Hotspot kommen, nie die Einrichtungsseite, ",[110,229,230],{},"\u002Fapi\u002F"," oder die eigenen Dateien der Web-App, und schickt alles andere auf die Einrichtungsseite:",[192,233,236],{"className":234,"code":235,"filename":189,"language":197,"meta":198},[195],"\u002F\u002F Send everything else to the setup page\nrequest->redirect(setupOptions.setupPagePath);\n",[110,237,235],{"__ignoreMap":198},[13,239,240,241,244,245,252,253,256,257,259,260,262,263,266],{},"Die Einrichtungsseite ist in allen drei Projekten ",[110,242,243],{},"\u002Fap-setup",". In ESPAsyncWebServer 3.12.1, der Version, die der Ticker in seiner ",[24,246,249],{"href":247,"rel":248},"https:\u002F\u002Fgithub.com\u002Fopen-gizmo\u002Fgizmo-ticker\u002Fblob\u002Fmain\u002Fmicrocontroller\u002Fplatformio.ini",[28],[110,250,251],{},"platformio.ini"," festlegt, nutzt ",[110,254,255],{},"redirect()"," standardmäßig den Status 302. Die Probe aus der Tabelle oben bekommt also eine 302 und einen ",[110,258,126],{},"-Header. Android sieht ein Portal statt einer 204, Windows sieht eine 302 statt seiner Textdatei, und Apples Prüfung sollte keine ",[110,261,164],{},"-Seite finden. Das ist der ganze Trick: keine spezielle Route ",[110,264,265],{},"\u002Fgenerate_204",", ein einziger Catch-all.",[13,268,269],{},[76,270],{"alt":271,"src":272},"Eine Tabelle mit den Probe-Anfragen von Android, Apple und Windows, der jeweils erwarteten Antwort und der einen 302-Weiterleitung, die der ESP32 für alle drei sendet","\u002Fimages\u002Fblog\u002Fde\u002Fesp32-captive-portal-not-working-fix-probes.webp",[13,274,275,276,279,280,279,283,279,286,289,290,294,295,87],{},"Zwei Details helfen später. Anfragen aus dem normalen WLAN werden nie umgeleitet, weil die Prüfung die lokale IP des Clients mit der des Hotspots vergleicht. Und über den Hotspot antworten nur vier API-Pfade (",[110,277,278],{},"\u002Fapi\u002Fnetworks",", ",[110,281,282],{},"\u002Fapi\u002Fconnect",[110,284,285],{},"\u002Fapi\u002Fcheck-connection",[110,287,288],{},"\u002Fapi\u002Fdevice","): die WLAN-Einrichtung und die Gerätedetails, sonst nichts, denn jeder in der Nähe kann dem offenen Hotspot beitreten. Den ganzen Ablauf in einem fertigen Gerät siehst du in ",[24,291,293],{"href":292},"\u002Fde\u002Fblog\u002Fcontrol-reolink-nvr-esp32","Wie der Reolink Switch gebaut ist"," und im ",[24,296,298],{"href":297},"\u002Fde\u002Fblog\u002Fwhat-is-opengizmo","Überblick über OpenGizmo",[47,300,302],{"id":301},"checkliste-das-popup-erscheint-nicht","Checkliste: Das Popup erscheint nicht",[13,304,305],{},"Ändere immer nur eine Sache und teste nach jedem Schritt.",[13,307,308],{},[76,309],{"alt":310,"src":311},"Ein Maker hält ein Handy mit hervorgehobenem WLAN Gizmo-Ticker und zeigt auf ein XIAO-Board, das mit einer LED-Matrix verkabelt ist","\u002Fimages\u002Fblog\u002Fesp32-captive-portal-not-working-fix-illustration.webp",[313,314,316],"h3",{"id":315},"_1-gibt-es-den-hotspot-überhaupt","1. Gibt es den Hotspot überhaupt?",[13,318,319,320,323,324,327,328,331,332,335,336,339],{},"Der Hotspot öffnet sich nur, wenn kein Netzwerk gespeichert ist oder das gespeicherte sich nicht verbinden lässt (der Verbindungsversuch läuft nach 12,5 Sekunden ab, laut ",[110,321,322],{},"WIFI_CONNECT_TIMEOUT","). Solange ein gespeichertes Netzwerk funktioniert, gibt es weder Hotspot noch Portal. Baue die Umgebung ",[110,325,326],{},"debug"," (",[110,329,330],{},"pio run -e debug -t upload",", dann ",[110,333,334],{},"pio device monitor",") und such nach ",[110,337,338],{},"Access point ready on http:\u002F\u002F...",". Die Release-Firmware schreibt keine Logs.",[13,341,342,343,347],{},"Hast du das Board aus dem Browser geflasht, erklärt ",[24,344,346],{"href":345},"\u002Fde\u002Fblog\u002Fesp-web-tools-flash-esp32-from-browser","ESP Web Tools: ESP32 aus dem Browser flashen"," die Release-Builds.",[313,349,351],{"id":350},"_2-hat-sich-das-handy-wirklich-mit-dem-hotspot-verbunden","2. Hat sich das Handy wirklich mit dem Hotspot verbunden?",[13,353,354],{},"Viele Handys bevorzugen mobile Daten, wenn ein WLAN kein Internet hat, und manche fragen, ob sie verbunden bleiben sollen. Bleib verbunden oder schalte für den Test die mobilen Daten aus. Auf manchen Handys kommt die Anmeldeaufforderung als Benachrichtigung statt als Fenster, schau also in die Benachrichtigungsleiste, bevor du annimmst, es sei nichts passiert. Eine Primärquelle dazu, wie jeder Hersteller sie formuliert oder platziert, habe ich nicht gefunden.",[313,356,358],{"id":357},"_3-öffne-von-hand-eine-http-adresse","3. Öffne von Hand eine http:\u002F\u002F-Adresse",[13,360,361,362,371,372,375,376,379],{},"Die README von gizmo-common gibt denselben Rat: Während du mit dem Hotspot verbunden bist, ",[24,363,366,367,370],{"href":364,"rel":365},"https:\u002F\u002Fgithub.com\u002Fopen-gizmo\u002Fgizmo-common\u002Fblob\u002Fv2.5.1\u002FREADME.md",[28],"öffne im Browser irgendeine ",[110,368,369],{},"http:\u002F\u002F","-Adresse",", und du wirst weitergeleitet. Klappt das, aber das Popup nicht, sind DNS und Weiterleitung in Ordnung, und nur die Probe-Logik des Handys steht im Weg. Nimm einfaches HTTP: Der Webserver der Firmware lauscht nur auf Port 80 (",[110,373,374],{},"AsyncWebServer server(80)"," in jedem Projekt), eine ",[110,377,378],{},"https:\u002F\u002F","-Adresse lässt sich also nicht umleiten.",[313,381,383],{"id":382},"_4-entferne-was-die-dns-abfrage-abfängt","4. Entferne, was die DNS-Abfrage abfängt",[13,385,386],{},"Ein VPN oder eine App, die einen eigenen DNS-Resolver erzwingt, oder die Einstellung für sicheres DNS im Browser kann die Abfrage an deinem Platzhalter-DNS-Server vorbeileiten, sodass das Handy das Board nie erreicht. Zum privaten DNS-Modus von Android habe ich keine Primärquelle gefunden, daher nenne ich das eine wahrscheinliche Ursache, keine gemessene. Schalte VPN und privates DNS für die Einrichtung aus und danach wieder ein.",[313,388,390],{"id":389},"_5-prüfe-den-statuscode-der-probe","5. Prüfe den Statuscode der Probe",[13,392,393,394,397,398,401,402,405,406,409,410,413],{},"Von einem Laptop im Hotspot aus sollte ",[110,395,396],{},"nslookup example.com"," die IP des Hotspots liefern, und ",[110,399,400],{},"curl -i http:\u002F\u002Fconnectivitycheck.gstatic.com\u002Fgenerate_204"," sollte eine ",[110,403,404],{},"302"," mit ",[110,407,408],{},"Location: \u002Fap-setup"," ausgeben (das habe ich aus dem Code abgeleitet und nicht auf Hardware getestet). Eine falsche IP weist auf ein DNS-Problem hin. Eine ",[110,411,412],{},"204"," heißt, dass deine Firmware oder etwas anderes auf dem Weg die Probe selbst beantwortet, und das Handy glaubt, online zu sein.",[313,415,417],{"id":416},"_6-wenn-du-dein-eigenes-portal-schreibst","6. Wenn du dein eigenes Portal schreibst",[13,419,420,421,423,424,426],{},"Behalte die Regel von oben bei: Das DNS beantwortet jeden Namen, und ein unbekannter Pfad leitet auf deine Seite um. Schick aus deinen eigenen Routen keine ",[110,422,412],{}," und nicht die erwartete ",[110,425,164],{},"-Seite, sonst hält das Handy sich für online und blendet das Popup aus.",[47,428,430],{"id":429},"und-dhcp-option-114-und-die-captive-portal-api","Und DHCP-Option 114 und die Captive-Portal-API?",[13,432,433,438,439,444,445,448,449,452,453,456],{},[24,434,437],{"href":435,"rel":436},"https:\u002F\u002Fwww.rfc-editor.org\u002Frfc\u002Frfc8910",[28],"RFC 8910"," definiert einen Weg, Clients über das Portal zu informieren: in der DHCPv4-Option 114 und in einer IPv6-Router-Advertisement-Option (Typ 37), die einen URI tragen. Der URI zeigt auf eine in ",[24,440,443],{"href":441,"rel":442},"https:\u002F\u002Fwww.rfc-editor.org\u002Frfc\u002Frfc8908",[28],"RFC 8908"," beschriebene API, die über HTTPS ",[110,446,447],{},"application\u002Fcaptive+json"," mit einem ",[110,450,451],{},"captive","-Flag und einer optionalen ",[110,454,455],{},"user-portal-url"," liefert. Der NetworkMonitor von Android enthält bereits Code für diesen Content-Type, aber gizmo-common sendet keine Option 114, daher verlassen sich die drei OpenGizmo-Geräte auf die Weiterleitung der Probe. Ich habe die Option nicht auf einem ESP32 getestet.",[47,458,460],{"id":459},"wie-lange-bleibt-der-hotspot-an-und-wie-holst-du-ihn-zurück","Wie lange bleibt der Hotspot an, und wie holst du ihn zurück?",[13,462,463,464,466,467,470],{},"Sobald die Einrichtungsseite ",[110,465,285],{}," abfragt und den Status Connected bekommt, schaltet die Firmware den Hotspot ab. Kommt das gespeicherte Netzwerk von allein zurück, bleibt der Hotspot 120 Sekunden an (",[110,468,469],{},"ACCESS_POINT_SHUTDOWN_DELAY",") und schaltet sich dann ab. Neue Zugangsdaten werden zuerst ausprobiert und erst gespeichert, wenn sie sich verbinden, ein Tippfehler kann also kein funktionierendes Netzwerk ersetzen. Das gespeicherte Netzwerk liegt in NVS, dem Schlüssel-Wert-Speicher im Flash des ESP32.",[13,472,473,474,477,478,481,482,486],{},"Um das Portal zurückzuholen, halte die ",[16,475,476],{},"BOOT","-Taste des XIAO ESP32-S3 10 Sekunden lang gedrückt, während die Firmware läuft (das löscht auch die eigenen Einstellungen des Projekts), oder drücke in der Web-App auf ",[16,479,480],{},"Forget network",". Die ESP32-CAM hat keinen BOOT-Reset: Ihr GPIO0 ist zugleich der Kameratakt, nutze also die Web-App. Erreichst du das Board nach dem Verbinden mit dem WLAN über seinen Namen, kann mDNS das nächste Problem sein, das ",[24,483,485],{"href":484},"\u002Fde\u002Fblog\u002Fesp32-mdns-local-hostname-not-working","ESP32 .local funktioniert nicht auf Android"," behandelt.",[47,488,490],{"id":489},"was-geprüft-wurde-und-die-grenzen","Was geprüft wurde, und die Grenzen",[13,492,493,494,497],{},"Der DNS-Platzhalter, die 302-Weiterleitung, das Timeout von 12,5 Sekunden und die 120 Sekunden Hotspot-Verzögerung sind direkt aus gizmo-common v2.5.1 (vom Ticker und vom Reolink Switch festgelegt; die Kamera nutzt v2.4.0, die ich für diese Anleitung nicht gelesen habe) und aus ESPAsyncWebServer 3.12.1 gelesen; für diese Anleitung habe ich keine Pakete von einem echten Handy mitgeschnitten. Die Proben von Android und Windows stammen aus der Dokumentation von AOSP und Microsoft, der Apple-Host aus dem Apple-Support und sein Pfad nur aus Community-Quellen, und Handyhersteller oder OS-Versionen können jede davon ändern. Hat die Checkliste dein Popup nicht repariert, teste zuerst Schritt 3: Er zeigt, ob das Board oder das Handy schuld ist. Für einen Vergleich mit BLE und Improv ist die ",[24,495,496],{"href":85},"Übersicht der Provisioning-Methoden"," die nächste Station.",{"title":198,"searchDepth":499,"depth":499,"links":500},2,[501,502,503,504,513,514,515],{"id":49,"depth":499,"text":50},{"id":90,"depth":499,"text":91},{"id":174,"depth":499,"text":175},{"id":301,"depth":499,"text":302,"children":505},[506,508,509,510,511,512],{"id":315,"depth":507,"text":316},3,{"id":350,"depth":507,"text":351},{"id":357,"depth":507,"text":358},{"id":382,"depth":507,"text":383},{"id":389,"depth":507,"text":390},{"id":416,"depth":507,"text":417},{"id":429,"depth":499,"text":430},{"id":459,"depth":499,"text":460},{"id":489,"depth":499,"text":490},"troubleshooting","Fehlerbehebung","2026-11-14T00:00:00Z","Warum sich das Captive-Portal-Popup des ESP32 auf Android, iPhone oder Windows nicht öffnet: DNS, Probe-URLs, 302-Weiterleitungen und wie du es behebst.","md",[522,525,528,531,534],{"question":523,"answer":524},"Warum öffnet sich das Captive Portal meines ESP32 nicht automatisch?","Das Handy öffnet die Anmeldeseite nur, wenn sein Verbindungstest etwas anderes als die erwartete Antwort bekommt. Beantwortet der DNS-Server des ESP32 nicht jeden Namen mit der eigenen IP, oder antwortet der Webserver auf die Probe-URL mit 204 oder der falschen Seite, hält das Handy das Netzwerk für in Ordnung und zeigt nichts an.",{"question":526,"answer":527},"Welche URLs rufen Android, iPhone und Windows ab, um ein Captive Portal zu erkennen?","Android ruft standardmäßig connectivitycheck.gstatic.com\u002Fgenerate_204 ab und erwartet HTTP 204. Windows ruft www.msftconnecttest.com\u002Fconnecttest.txt ab und erwartet eine Antwort mit dem Text Microsoft Connect Test. Die Apple-Supportseite nennt captive.apple.com für Captive-Portal-Prüfungen, und Community-Quellen berichten vom Pfad hotspot-detect.html mit einer Seite, auf der Success steht.",{"question":529,"answer":530},"Brauche ich für ein Captive Portal einen DNS-Server auf dem ESP32?","Ja, praktisch schon. Die Probe des Handys fragt einen echten Host wie connectivitycheck.gstatic.com ab, und das Handy erreicht den ESP32 nur, wenn dieser den Namen mit seiner eigenen IP beantwortet. Die Arduino-Bibliothek DNSServer macht das, wenn du sie mit dem Platzhalternamen und der Adresse des Access Points startest.",{"question":532,"answer":533},"Kann ich die Einrichtungsseite des ESP32 von Hand öffnen, wenn das Popup nie erscheint?","Ja. Bleib mit dem Hotspot des ESP32 verbunden und öffne im Browser irgendeine einfache http:\u002F\u002F-Adresse. Das DNS des ESP32 schickt den Namen zum Board, und sein Webserver leitet die Anfrage auf die Einrichtungsseite um. HTTPS-Adressen funktionieren nicht, weil das Board nur HTTP ausliefert.",{"question":535,"answer":536},"Wie setze ich ein auf dem ESP32 gespeichertes WLAN zurück, damit das Portal wiederkommt?","Mit gizmo-common hältst du die BOOT-Taste des XIAO ESP32-S3 10 Sekunden lang gedrückt, während die Firmware läuft, oder nutzt Forget network in der Web-App. Beides löscht das gespeicherte WLAN und startet das Board neu in seinen Einrichtungs-Hotspot; der BOOT-Reset löscht auch die Projekteinstellungen. Die ESP32-CAM hat keinen BOOT-Reset, nutze also die Web-App.","\u002Fimages\u002Fblog\u002Fesp32-captive-portal-not-working-fix.jpg","Ein Maker mit Brille zeigt auf ein Handy mit einer WLAN-Liste, dem Netzwerk Gizmo-Setup und einem leeren Popup, daneben ein ESP32-Board auf dem Schreibtisch.","de",{},true,"\u002Fde\u002Fblog\u002Fesp32-captive-portal-not-working-fix",{"title":5,"description":519},{"loc":542},"de\u002Fblog\u002Fesp32-captive-portal-not-working-fix","Ein Captive Portal auf dem ESP32 braucht zwei Dinge: ein DNS, das jeden Namen mit der Board-IP beantwortet, und eine HTTP-Weiterleitung für die Probe-URL. Öffnet sich das Popup nicht, prüfe zuerst diese beiden.",[548,549,550,551,552],"ESP32","Wi-Fi","Troubleshooting","Firmware","OpenGizmo","kTlFAZ-0IrmPWn6yig_hIpipgAdEGKSe2fqwD0aOt7k",[555,560,569,573],{"title":556,"description":557,"image":558,"categoryText":517,"categorySlug":516,"tags":559,"path":484},"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.","\u002Fimages\u002Fblog\u002Fesp32-mdns-local-hostname-not-working.jpg",[548,549,550,551,552],{"title":561,"description":562,"image":563,"categoryText":564,"categorySlug":565,"tags":566,"path":568},"ESP32 OTA-Update im Vergleich: Web, GitHub, HTTPS","ESP32 OTA-Update im Vergleich: ArduinoOTA, Web-Upload, HTTPS-Pull von GitHub Releases und USB, mit Partitionen, Sicherheit und Rollback.","\u002Fimages\u002Fblog\u002Fesp32-ota-update-methods-compared.jpg","Vergleiche","comparisons",[548,551,567,549,552],"IoT","\u002Fde\u002Fblog\u002Fesp32-ota-update-methods-compared",{"title":86,"description":570,"image":571,"categoryText":564,"categorySlug":565,"tags":572,"path":85},"ESP32 WLAN-Provisioning im Vergleich: Passwort im Code, Captive Portal, BLE und SoftAP von Espressif, Improv, ESP-Touch, nach Sicherheit und Komfort.","\u002Fimages\u002Fblog\u002Fesp32-wifi-provisioning-methods-compared.jpg",[548,549,567,551,552],{"title":574,"description":575,"image":576,"categoryText":517,"categorySlug":516,"tags":577,"path":580},"ESP32 verbindet nicht: No serial data received","Behebe 'Failed to connect to ESP32: No serial data received' Schritt für Schritt: Datenkabel, Treiber, Ports, Download-Modus bei S3, C3, XIAO, ESP32-CAM-MB.","\u002Fimages\u002Fblog\u002Fesp32-failed-to-connect-no-serial-data-received.jpg",[548,550,551,578,579],"XIAO ESP32-S3","ESP32-CAM","\u002Fde\u002Fblog\u002Fesp32-failed-to-connect-no-serial-data-received",[582,585,591],{"name":564,"slug":565,"path":583,"count":584,"image":563},"\u002Fblog\u002Fcategories\u002Fcomparisons",8,{"name":586,"slug":587,"path":588,"count":589,"image":590},"Anleitungen","guides","\u002Fblog\u002Fcategories\u002Fguides",11,"\u002Fimages\u002Fblog\u002Fcoingecko-api-esp32-rate-limits.jpg",{"name":592,"slug":593,"path":594,"count":595,"image":596},"Projekte","builds","\u002Fblog\u002Fcategories\u002Fbuilds",6,"\u002Fimages\u002Fblog\u002F3d-printed-esp32-enclosure-design-guide.jpg",1795018244759]