Zum Hauptinhalt springen
Leitfäden Zuletzt aktualisiert: Oktober 2026 9 Min. Lesezeit

TP-Link Omada: Leitfaden zur Einrichtung des Captive Portals

C
CaptiFi Redaktionsteam
CaptiFi · September 2024
TP-Link Omada: Leitfaden zur Einrichtung des Captive Portals
4 Schritte
Gäste-SSID, externes Portal, Pre-Auth-Liste, Controller-Verbindung
4 Einträge
Domains und IP im Pre-Auth-Walled-Garden
8043
Port des Software-Controllers (443 beim OC200/OC300)
Kein RADIUS
Ein Omada-Operator-Konto autorisiert die Gäste

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.com aussieht, 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

  1. Gäste-SSID: Legen Sie ein eigenes offenes WLAN für Gäste an.
  2. Externes Portal: Richten Sie das Portal dieser SSID auf CaptiFi.
  3. Walled Garden: Geben Sie die CaptiFi-Domains vor der Authentifizierung frei, damit die Splash-Seite laden kann.
  4. 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.

EinstellungWert
Portal NameCaptiFi oder ein beliebiger Name
PortalAn
SSID & NetzwerkIhre Gäste-SSID aus Schritt 1
LandingpageOriginal-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 IPWofür er gebraucht wird
app.captifi.ioLiefert die Splash-Seite aus
46.62.168.7Die CaptiFi-IP, für Controller, die nur IP-Einträge akzeptieren
fonts.googleapis.comSchriftarten der Seite
fonts.gstatic.comSchriftarten 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

  1. 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).
  2. 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.
  3. 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 keine omada://-Links aus der Omada-App ein, das sind keine Controller-Adressen.
  4. Geben Sie die Controller-ID ein, also das lange ID-Segment in der URL Ihres Omada-Controllers.
  5. Geben Sie den Operator-Benutzernamen und das Passwort ein, die Sie gerade erstellt haben.
  6. 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

  1. Verbinden Sie ein Smartphone oder einen Laptop mit dem Gäste-WLAN.
  2. 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.
  3. Füllen Sie das Anmeldeformular auf der Splash-Seite aus.
  4. Prüfen Sie, ob Sie nach der Anmeldung Internetzugang haben.
  5. Öffnen Sie Ihr CaptiFi-Dashboard: Der Testgast sollte in Ihrem Gästeprotokoll erscheinen.

Fehlerbehebung

SymptomWas zu überprüfen ist
Splash-Seite erscheint nichtDas 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-Seitefonts.googleapis.com und fonts.gstatic.com stehen im Walled Garden, damit die Seitenelemente laden können
Gast kommt nach der Anmeldung nicht onlineDie 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 CaptiFiDie Portweiterleitung funktioniert bei Controllern vor Ort. Testen Sie von außerhalb des Netzwerks auf Port 8043
„Invalid credentials“ in CaptiFiOperator-Benutzername und Passwort sowie die aus der Omada-URL kopierte Controller-ID
Portal funktioniert nur an manchen APsJeder EAP ist adoptiert, online und strahlt die Gäste-SSID aus. Bei Bedarf neu provisionieren
HTTPS-Seiten lösen die Weiterleitung nicht ausRufen Sie zuerst eine HTTP-Seite auf, etwa http://example.com
Walled Garden akzeptiert keine DomainsDiese 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.

FunktionDas eigene Portal von OmadaOmada mit CaptiFi
So melden sich Gäste anSieben Authentifizierungsarten, darunter ein einfaches Passwort, Hotspot (Voucher und mehr), RADIUS, Google und ein External Portal ServerEine Seite mit Ihrem Logo und Ihren Farben, die Name und E-Mail-Adresse abfragt
Erfasste GästedatenEin Form-Auth-Fragebogen, den TP-Link als Möglichkeit beschreibt, Feedback von Kunden einzuholenE-Mail-Adresse, Name und Telefonnummer, mit dokumentierter Marketing-Einwilligung
Automatisiertes E-Mail-MarketingVon TP-Link nicht angegebenAb Essentials: Willkommens-E-Mail, Bewertungsanfrage und Rückgewinnung
Google-BewertungsanfragenVon TP-Link nicht angegebenAb Essentials, Versand nach dem Besuch
Erfassung wiederkehrender BesucheVon TP-Link nicht angegebenBesuchsverlauf für jeden Gast
Mehrere StandorteMulti-Site-Verwaltung auf dem Omada-ControllerAlle Standorte in einem CaptiFi-Konto
EinwilligungsnachweiseVon TP-Link nicht angegebenFü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?
Nein. Die Omada-Integration nutzt die Controller-Einstellung External Portal Server, um Gäste auf die CaptiFi-Splash-Seite weiterzuleiten, einen Pre-Auth-Walled-Garden, damit diese Seite laden kann, und ein Omada-Operator-Konto, über das CaptiFi Gäste per Hotspot-Operator-API autorisiert. Unter RADIUS ist nichts einzutragen, und es gibt kein Shared Secret zu verwalten.
Funktioniert CaptiFi mit Omada Cloud Essentials?
Nein. CaptiFi unterstützt die kostenlose Essentials-Stufe nicht, die TP-Link inzwischen Omada Central Essentials nennt. Die Funktionstabelle von TP-Link führt für Essentials eine Option External Portal Server auf, die Omada-Anbindung von CaptiFi wird aber nur auf dem OC200, dem OC300, dem selbst gehosteten Software-Controller und dem kostenpflichtigen Cloud-Based Controller unterstützt. Controller-Adressen wie xxx-omada-essential-device.tplinkcloud.com gehören zu Essentials. Stellen Sie Ihre Access Points auf einen OC200 oder OC300, den kostenlosen, selbst gehosteten Software-Controller oder den kostenpflichtigen Cloud-Based Controller um, oder nutzen Sie das CaptiFi-Gerät gegen eine erstattungsfähige Kaution, ganz ohne Controller. Schreiben Sie an support@captifi.io, wenn Sie nicht sicher sind, welchen Sie haben.
Welche Omada-Controller unterstützt CaptiFi?
Die Hardware-Controller OC200 und OC300, den selbst gehosteten Software-Controller und den kostenpflichtigen Omada Cloud-Based Controller, mit Firmware 5.x oder neuer. EAPs mit WiFi 7 wie der EAP772 und der EAP773 brauchen v5.15 oder neuer. Der Controller muss aus dem Internet erreichbar sein, auf Port 8043 beim Software-Controller oder 443 beim OC200 und OC300, Controller vor Ort brauchen also in der Regel eine Portweiterleitung.
Welche Portal-URL trage ich in Omada ein?
Stellen Sie Authentication Type auf External Portal Server und geben Sie https://app.captifi.io/guest/omada?site_id=YOUR_SITE_ID ein, wobei Sie YOUR_SITE_ID durch die Standort-ID ersetzen, die in Ihrem CaptiFi-Dashboard angezeigt wird. Auch Portal Customisation muss auf External Portal Server stehen und nicht auf dem lokalen Webportal. Die URL muss exakt übereinstimmen, und dieser Einstiegspunkt akzeptiert die Weiterleitungsparameter jeder Omada-Controller-Version automatisch.
Was gehört in den Walled Garden von Omada?
Vier Einträge: app.captifi.io, die IP-Adresse 46.62.168.7, fonts.googleapis.com und fonts.gstatic.com. Ohne die ersten beiden kann die Splash-Seite nicht laden, ohne die beiden Schriftarten-Hosts lädt sie leer oder fehlerhaft. Omada akzeptiert keine Wildcard-Einträge wie *.captifi.io, und die Seite braucht auch keinen. Manche Omada-Firmware akzeptiert nur IP-basierte Einträge. In diesem Fall hält der Eintrag 46.62.168.7 das Portal erreichbar.
Was braucht CaptiFi, um sich mit meinem Omada-Controller zu verbinden?
Ein Hotspot-Operator-Konto, nicht Ihren Admin-Login. Erstellen Sie es im Controller unter Hotspot, Operators (in Omada 5 Hotspot Manager, Operators). Gehen Sie dann in Ihrem CaptiFi-Dashboard zu Meine Standorte, Standort hinzufügen, wählen Sie TP-Link Omada und geben Sie die Controller-URL einschließlich Port, die Controller-ID aus der eigenen URL des Controllers sowie Operator-Benutzernamen und Passwort ein. Fügen Sie keine omada://-Links aus der Omada-App ein, das sind keine Controller-Adressen.
Kann ich mehrere Omada-Sites mit einem CaptiFi-Konto betreiben?
Ja. Jeder Standort kann sein eigenes Splash-Seiten-Design haben, und 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.
C
Verfasst von
CaptiFi Redaktionsteam

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.

Weiterführende Artikel