TP-Link Omada: Leitfaden zur Einrichtung des Captive Portals
TP-Link Omada umfasst Access Points, Switches und Gateways, gesteuert über einen Controller, der Ihnen gehört oder den Sie mieten. Das eigene Portal des Controllers kann Gästen bereits eine Login-Seite vorschalten, mit Optionen wie einem einfachen Passwort, Vouchern und einem Form-Auth-Fragebogen. Diese Anleitung zeigt, wie Sie den External Portal Server von Omada stattdessen auf CaptiFi richten, sodass jede Gästeanmeldung einen Kontakt mit dokumentierter Marketing-Einwilligung in Ihre Gästeliste einträgt. Die Schritte entsprechen der CaptiFi-Einrichtungsanleitung für Omada in unserer Kundendokumentation.
Eines vorweg, denn es hat viele Leser früherer Fassungen dieser Anleitung in die Irre geführt: Es gibt keinen RADIUS-Server zu konfigurieren. Omada leitet Gäste auf die CaptiFi-Splash-Seite weiter, und CaptiFi autorisiert sie anschließend über ein Operator-Konto auf Ihrem Controller. Alles, was Sie in Omada eingeben, sind eine URL, vier Pre-Auth-Einträge und ein Operator-Login.
Was ein Captive Portal leistet
Ein Captive Portal ist die Seite, die Gäste sehen, wenn sie sich mit Ihrem WLAN verbinden, bevor sie online gehen. Statt eines offenen Netzwerks oder eines Passworts an der Wand können Sie mit dem Portal Gästedaten wie E-Mail-Adresse, Name oder Telefonnummer erfassen, Ihr eigenes Branding zeigen, die Marketing-Einwilligung dokumentieren, die UK GDPR und PECR verlangen, und den Gast in dem Moment, in dem er sich verbindet, an Ihre WLAN-Marketing-Software übergeben. Omada kümmert sich um Funk und Netzwerk, CaptiFi um die Seite, die Daten und alles, was nach der Anmeldung passiert.
CaptiFi ist externe Captive-Portal-Software. Sie funktioniert mit TP-Link Omada ebenso wie mit UniFi, Cisco Meraki, Aruba, MikroTik, Ruckus, Fortinet und DrayTek, und mit dem CaptiFi-Gerät (gegen eine erstattungsfähige Kaution), falls Sie lieber gar keinen Controller anfassen möchten.
Was Sie brauchen
- Einen TP-Link-Omada-Controller, den CaptiFi über das Internet erreichen kann: einen Hardware-Controller OC200 oder OC300, den kostenlosen, selbst gehosteten Software-Controller oder den kostenpflichtigen Omada Cloud-Based Controller (CBC).
- Nicht die kostenlose Essentials-Stufe, die TP-Link inzwischen Omada Central Essentials nennt (früher Omada Cloud Essentials). Die Funktionstabelle von TP-Link führt dort eine Option External Portal Server auf, die Omada-Anbindung von CaptiFi wird aber nur auf den oben genannten Controllern unterstützt. Wenn Ihre Controller-Adresse wie
xxx-omada-essential-device.tplinkcloud.comaussieht, nutzen Sie Essentials. Stellen Sie die Access Points auf einen OC200, den Software-Controller oder den kostenpflichtigen Cloud-Based Controller um, oder verzichten Sie mit dem CaptiFi-Gerät gegen eine erstattungsfähige Kaution ganz auf den Controller. - Empfohlen wird Controller-Firmware 5.x oder neuer, und für EAPs mit WiFi 7 wie den EAP772 und den EAP773 ist v5.15 oder neuer erforderlich.
- Einen oder mehrere Omada-EAP-Access-Points, adoptiert und online.
- Administratorzugriff auf den Controller.
- Ein CaptiFi-Konto auf my.captifi.io und Ihre Standort-ID griffbereit. Sie wird in Ihrem Dashboard angezeigt, oder der Support schickt sie Ihnen zu. Starten Sie eine 30-tägige kostenlose Testphase, falls Sie noch kein Konto haben.
- Einen Controller, der aus dem Internet erreichbar ist. Der Standardport ist 8043 beim Software-Controller und 443 beim OC200 und OC300, ein Controller vor Ort braucht also in der Regel eine Portweiterleitung.
Die vier Schritte auf einen Blick
- Gäste-SSID: Legen Sie ein eigenes offenes WLAN für Gäste an.
- Externes Portal: Richten Sie das Portal dieser SSID auf CaptiFi.
- Walled Garden: Geben Sie die CaptiFi-Domains vor der Authentifizierung frei, damit die Splash-Seite laden kann.
- Controller-Verbindung: Erstellen Sie ein Operator-Konto und verknüpfen Sie den Controller in CaptiFi.
Danach testen Sie mit einem Smartphone. Wer sich im Omada-Controller auskennt, erledigt das Ganze in einem Durchgang.
Schritt 1: Gäste-SSID anlegen
Öffnen Sie Ihren Omada-Controller, lokal oder in der Cloud, öffnen Sie Ihre Site und gehen Sie zu Network Config, dann Network Settings, dann WLAN (in Omada 5 sind es Settings, dann Wireless Networks). Fügen Sie ein neues WLAN hinzu und vergeben Sie als SSID-Namen das, was Gäste sehen sollen, etwa „Gratis-WLAN“. Stellen Sie Security auf None, denn das Captive Portal regelt, wer online geht, und lassen Sie SSID Broadcast aktiviert. Wählen Sie unter Band 2.4 GHz, 5 GHz oder beide und klicken Sie auf Save.
Zur Netzwerkisolierung legen Sie den Gästeverkehr in ein eigenes VLAN. Gehen Sie zu Network Config, Network Settings, LAN (in Omada 5 Settings, Wired Networks, LAN), legen Sie ein neues Netzwerk für Gäste an, kehren Sie dann zum WLAN zurück und weisen Sie ihm die Gäste-SSID zu. So bleiben Gäste von Ihren Kassen, Druckern und Bürorechnern getrennt.
Schritt 2: Externes Portal konfigurieren
Das ist der wichtigste Schritt. Gehen Sie zu Network Config, Authentication, Portal (in Omada 5 Settings, Authentication, Portal), klicken Sie auf Create New Portal und füllen Sie den Tab Basic aus.
| Einstellung | Wert |
|---|---|
| Portal Name | CaptiFi oder ein beliebiger Name |
| Portal | An |
| SSID & Netzwerk | Ihre Gäste-SSID aus Schritt 1 |
| Landingpage | Original-URL |
Lassen Sie das Feld Portal URL im Tab Basic unverändert: Das ist die eigene Adresse des Controllers, nicht die von CaptiFi. Öffnen Sie dann den Tab Authentication, stellen Sie Authentication Type auf External Portal Server und Custom Portal Server auf URL. Wählen Sie im Dropdown https:// und geben Sie den Rest Ihrer Adresse in das Feld daneben ein: app.captifi.io/guest/omada?site_id=YOUR_SITE_ID. Das Feld lehnt eine Adresse ab, die mit https:// beginnt, fügen Sie also alles ein, was danach kommt. Speichern Sie das Portal.
Ersetzen Sie YOUR_SITE_ID durch Ihre CaptiFi-Standort-ID. Der Einrichtungsassistent zeigt Ihre vollständige Adresse mit einer Schaltfläche zum Kopieren. Die Adresse muss exakt eingegeben werden, und ein Tippfehler an dieser Stelle ist der häufigste Grund, warum die Splash-Seite nie erscheint. Sie akzeptiert die Weiterleitungsparameter der Omada-Controller-Versionen 4, 5 und 6 automatisch. Für ein externes Portal ist in Omada kein Timeout einzustellen: Wie lange Gäste online bleiben, bestimmt die Sitzungsdauer Ihres Standorts in CaptiFi, die CaptiFi bei jeder Anmeldung mitsendet.
Schritt 3: Pre-Auth-Einträge hinzufügen
Der Walled Garden, den Omada 6 Pre-Authentication Access nennt, lässt Gäste die Server von CaptiFi erreichen, bevor sie sich angemeldet haben. Ohne diese Einträge kann die Splash-Seite nicht laden. Öffnen Sie auf der Seite Portal den Tab Access Control, schalten Sie Pre-Authentication Access ein und klicken Sie für jeden der folgenden Einträge auf Add (in Omada 5 suchen Sie in den Portal-Einstellungen nach dem Abschnitt Pre-Auth Policy oder Walled Garden).
| Domain oder IP | Wofür er gebraucht wird |
|---|---|
app.captifi.io | Liefert die Splash-Seite aus |
46.62.168.7 | Die CaptiFi-IP, für Controller, die nur IP-Einträge akzeptieren |
fonts.googleapis.com | Schriftarten der Seite |
fonts.gstatic.com | Schriftarten der Seite |
Fügen Sie die drei Hosts als URL-Einträge hinzu und die IP als IP-Range-Eintrag mit der Subnetzmaske 32. Omada akzeptiert keine Wildcard-Einträge wie *.captifi.io, und die Seite braucht auch keinen. Manche Omada-Controller-Versionen akzeptieren nur IP-basierte Walled-Garden-Einträge. Wenn Ihre eine Domain ablehnt, hält der IP-Eintrag 46.62.168.7 das Portal erreichbar. Klicken Sie auf Save oder Apply, sobald die Liste vollständig ist.
Schritt 4: Controller mit CaptiFi verbinden
Operator-Konto in Omada erstellen
CaptiFi autorisiert Gäste über die Hotspot-Operator-API von Omada und braucht deshalb ein eigenes Operator-Konto statt Ihres Haupt-Admin-Logins. Öffnen Sie im Controller Ihre Site und klicken Sie im linken Menü auf Hotspot (Omada 6 öffnet Hotspot Management in einem neuen Tab, in Omada 5 heißt es Hotspot Manager), dann gehen Sie zu Operators. Fügen Sie einen neuen Operator für Ihre Site hinzu, zum Beispiel mit dem Benutzernamen captifi, und vergeben Sie ein starkes Passwort.
Standort in CaptiFi hinzufügen
- Stellen Sie sicher, dass der Controller aus dem Internet erreichbar ist. Controller vor Ort brauchen in der Regel eine Portweiterleitung für 8043 (Software-Controller) oder 443 (OC200/OC300).
- Melden Sie sich bei my.captifi.io an und gehen Sie zu Meine Standorte, dann Standort hinzufügen, oder wählen Sie Ihre Hardware während des Onboardings, und wählen Sie dort TP-Link Omada.
- Geben Sie die Controller-URL ein: die eigene Adresse des Controllers einschließlich Port, zum Beispiel
https://YOUR-CONTROLLER-IP:8043, oder seine Domain. Beim kostenpflichtigen Cloud-Based Controller verwenden Sie die Controller-URL aus Ihrem Omada-Cloud-Konto. Fügen Sie keineomada://-Links aus der Omada-App ein, das sind keine Controller-Adressen. - Geben Sie die Controller-ID ein, also das lange ID-Segment in der URL Ihres Omada-Controllers.
- Geben Sie den Operator-Benutzernamen und das Passwort ein, die Sie gerade erstellt haben.
- Klicken Sie auf Verbinden. CaptiFi testet den Login und bestätigt die Verbindung.
Portweiterleitung prüfen
Wenn der Controller vor Ort steht, prüfen Sie den Fernzugriff, bevor Sie mit Gästen testen. Ermitteln Sie Ihre öffentliche IP auf whatismyip.com und rufen Sie dann von außerhalb Ihres Netzwerks https://YOUR_PUBLIC_IP:8043 auf. Sie sollten die Omada-Login-Seite sehen, möglicherweise hinter einer Zertifikatswarnung, die Sie akzeptieren können.
Schritt 5: Mit einem Smartphone testen
- Verbinden Sie ein Smartphone oder einen Laptop mit dem Gäste-WLAN.
- Die CaptiFi-Splash-Seite sollte automatisch erscheinen. Öffnet ein Smartphone sie nicht von selbst, öffnen Sie einen Browser und rufen Sie eine beliebige HTTP-Seite auf, etwa
http://example.com. - Füllen Sie das Anmeldeformular auf der Splash-Seite aus.
- Prüfen Sie, ob Sie nach der Anmeldung Internetzugang haben.
- Öffnen Sie Ihr CaptiFi-Dashboard: Der Testgast sollte in Ihrem Gästeprotokoll erscheinen.
Fehlerbehebung
| Symptom | Was zu überprüfen ist |
|---|---|
| Splash-Seite erscheint nicht | Das Portal ist aktiviert, die richtige SSID ist ausgewählt, und Authentication Type steht auf External Portal Server |
| Fehler „Portal unreachable“ | Der Walled Garden enthält app.captifi.io und 46.62.168.7 |
| Leere oder fehlerhafte Splash-Seite | fonts.googleapis.com und fonts.gstatic.com stehen im Walled Garden, damit die Seitenelemente laden können |
| Gast kommt nach der Anmeldung nicht online | Die CaptiFi-Adresse steht unter Custom Portal Server im Tab Authentication des Portals, das Operator-Konto gehört zu dieser Site, und weder VLAN- noch Firewall-Regeln blockieren den Verkehr nach der Authentifizierung |
| Controller verbindet sich nicht mit CaptiFi | Die Portweiterleitung funktioniert bei Controllern vor Ort. Testen Sie von außerhalb des Netzwerks auf Port 8043 |
| „Invalid credentials“ in CaptiFi | Operator-Benutzername und Passwort sowie die aus der Omada-URL kopierte Controller-ID |
| Portal funktioniert nur an manchen APs | Jeder EAP ist adoptiert, online und strahlt die Gäste-SSID aus. Bei Bedarf neu provisionieren |
| HTTPS-Seiten lösen die Weiterleitung nicht aus | Rufen Sie zuerst eine HTTP-Seite auf, etwa http://example.com |
| Walled Garden akzeptiert keine Domains | Diese Firmware unterstützt nur IP-Einträge. Fügen Sie 46.62.168.7 als IP-Eintrag hinzu |
Kompatible Omada-Hardware
CaptiFi funktioniert mit Omada-EAP-Access-Points, die von einem unterstützten Controller adoptiert wurden, darunter die Innengeräte EAP225 und EAP245, die Geräte EAP660 HD und EAP670 mit WiFi 6, der EAP225-Outdoor und der EAP610-Outdoor sowie die Deckengeräte EAP772 und EAP773 mit WiFi 7 an einem Controller mit v5.15 oder neuer. Unterstützte Controller sind der OC200, der OC300, der selbst gehostete Software-Controller und der kostenpflichtige Cloud-Based Controller. Die kostenlose Stufe Cloud Essentials wird nicht unterstützt. Wenn Sie Access Points mit WiFi 7 betreiben oder Ihr Betrieb über Starlink angebunden ist, finden Sie in der Kundendokumentation eine eigene Anleitung zu Omada mit WiFi 7 und Starlink. Sie behandelt die Anforderungen an die Controller-Version, die Einschränkung der Gäste-SSID bei 6 GHz und das CGNAT von Starlink.
Was nach der Einrichtung passiert
Sobald das Portal live ist, sieht jeder Gast, der sich verbindet, Ihre Seite im eigenen Design, und ab da übernimmt CaptiFi. Es speichert die Daten und die Einwilligung jedes Gastes aus der Anmeldung und erfasst wiederkehrende Besuche, sodass Sie sehen, wer Ihre Stammgäste sind. Ab Essentials kann es außerdem nach dem ersten Besuch eine Willkommens-E-Mail senden, eine Google-Bewertungsanfrage, sobald der Gast gegangen ist, und ein Rückgewinnungsangebot an Gäste, die länger nicht mehr da waren. Sie richten es einmal ein, und es läuft weiter.
Das integrierte Omada-Portal im Vergleich zu Omada mit CaptiFi
Das ändert sich, wenn Sie das eigene Portal des Controllers gegen CaptiFi als externes Portal tauschen. Die Omada-Spalte gibt wieder, was die Dokumentation von TP-Link beschreibt. Wo sie etwas nicht erwähnt, steht das in der Zelle.
| Funktion | Das eigene Portal von Omada | Omada mit CaptiFi |
|---|---|---|
| So melden sich Gäste an | Sieben Authentifizierungsarten, darunter ein einfaches Passwort, Hotspot (Voucher und mehr), RADIUS, Google und ein External Portal Server | Eine Seite mit Ihrem Logo und Ihren Farben, die Name und E-Mail-Adresse abfragt |
| Erfasste Gästedaten | Ein Form-Auth-Fragebogen, den TP-Link als Möglichkeit beschreibt, Feedback von Kunden einzuholen | E-Mail-Adresse, Name und Telefonnummer, mit dokumentierter Marketing-Einwilligung |
| Automatisiertes E-Mail-Marketing | Von TP-Link nicht angegeben | Ab Essentials: Willkommens-E-Mail, Bewertungsanfrage und Rückgewinnung |
| Google-Bewertungsanfragen | Von TP-Link nicht angegeben | Ab Essentials, Versand nach dem Besuch |
| Erfassung wiederkehrender Besuche | Von TP-Link nicht angegeben | Besuchsverlauf für jeden Gast |
| Mehrere Standorte | Multi-Site-Verwaltung auf dem Omada-Controller | Alle Standorte in einem CaptiFi-Konto |
| Einwilligungsnachweise | Von TP-Link nicht angegeben | Für jeden Gast gespeichert, wobei das Marketing-Opt-in vom Internetzugang getrennt ist |
Mehrere Omada-Sites betreiben
Wenn Sie mehr als eine Omada-Site oder mehr als einen Standort verwalten, kann jeder davon in CaptiFi sein eigenes Splash-Seiten-Design haben. Die Einstellungen je Standort finden Sie unter Meine Standorte in Ihrem Dashboard. Jeder zusätzliche CaptiFi-Standort über den in Ihrem Tarif enthaltenen hinaus wird zum Preis für zusätzliche Standorte in Ihrer Währung berechnet, der auf der Tarifseite in der Kundendokumentation steht.
Wenn Sie nur Gästeerfassung und CSV-Export auf der Hardware möchten, die Sie bereits betreiben, kostet Lite £19.99/Monat für einen Standort. Lite starten.
Ein Captive Portal für TP-Link Omada mit CaptiFi einzurichten, bedeutet einen Durchgang im Controller und ein Formular in Ihrem Dashboard. Starten Sie Ihre 30-tägige kostenlose Testphase, verbinden Sie Ihren Omada-Controller, und Ihr Gäste-WLAN baut ab der ersten Anmeldung eine Liste auf. Wenn Sie nicht weiterkommen, schreiben Sie an hello@captifi.io und nennen Sie Controller-Typ und Firmware-Version.
Quellen: TP-Link, Portal-Authentifizierungsarten, Omada Central Essentials und Omada Software Controller, alle gelesen am 28. Oktober 2026. Die Omada-Schritte von CaptiFi folgen unserer Kundendokumentation. TP-Link und Omada sind Marken von TP-Link. CaptiFi ist weder mit TP-Link verbunden noch wird es von TP-Link empfohlen.
Häufig gestellte Fragen
Schnelle Antworten auf die häufigsten Fragen zu diesem Thema.
Brauche ich einen RADIUS-Server, um CaptiFi mit TP-Link Omada zu nutzen?
Funktioniert CaptiFi mit Omada Cloud Essentials?
Welche Omada-Controller unterstützt CaptiFi?
Welche Portal-URL trage ich in Omada ein?
Was gehört in den Walled Garden von Omada?
Was braucht CaptiFi, um sich mit meinem Omada-Controller zu verbinden?
Kann ich mehrere Omada-Sites mit einem CaptiFi-Konto betreiben?
Das CaptiFi-Redaktionsteam schreibt über Gäste-WLAN-Marketing, Captive Portals, DSGVO-konforme Datenerfassung und lokale SEO für Betreiber gastorientierter Betriebe. Wenn wir CaptiFi mit einer anderen Plattform vergleichen, nutzen wir die eigene Website dieses Unternehmens und nennen das Datum, an dem wir sie geprüft haben.
Bereit, Ihr Gäste-WLAN in einen Marketingmotor zu verwandeln?
CaptiFi erfasst Kundendaten bei jeder WLAN-Anmeldung, automatisiert Google-Bewertungen und Follow-up-E-Mails und lässt sich mit den Tools verbinden, die Sie bereits nutzen. Das CaptiFi-Gerät ist in jedem Tarif gegen eine erstattungsfähige Kaution enthalten, die Preise stehen auf der Preisseite, und jeder Tarif hat eine 30-tägige kostenlose Testphase.