So konfigurieren Sie ein Ruijie Captive Portal für Gäste-WiFi
Dieser technische Leitfaden beschreibt die Konfiguration von Gäste-WiFi und Captive Portals auf Ruijie Networks-Hardware und deckt sowohl native Cloud-Portale als auch externe RADIUS-Integrationen ab. Er bietet IT-Managern und Netzwerkarchitekten konkrete Schritte für die VLAN-Isolierung, die Einrichtung von Walled Gardens und die Integration von Drittanbieter-Plattformen zur Förderung von Analysen und Umsätzen.
Diesen Leitfaden anhören
Podcast-Transkript ansehen
- Executive Summary
- Technical Deep-Dive
- Captive Portal Deployment Models
- Netzwerk-Isolation: NAT versus VLAN
- Walled Garden Konfiguration
- Implementierungsleitfaden
- Schritt 1: Konfigurieren Sie die Gäste-SSID und das VLAN
- Schritt 2: Konfigurieren Sie die externe Captive Portal Richtlinie
- Schritt 3: Definition des Walled Garden
- Schritt 4: Bandbreitenmanagement anwenden
- Best Practices
- Fehlerbehebung & Risikominderung
- iOS-Geräte zeigen das Portal nicht an
- Authentifizierung schlägt nach Eingabe der Daten fehl
- Gäste umgehen Bandbreitenlimits
- ROI & geschäftlicher Nutzen
- Audio-Briefing

Executive Summary
Die Konfiguration von Gäste-WiFi und Captive Portals auf Hardware von Ruijie Networks erfordert ein klares Verständnis der Plattformarchitektur, insbesondere der Wahl zwischen nativen Cloud-Portalen und externen RADIUS-Integrationen. Dieses technische Referenzhandbuch bietet IT-Managern, Netzwerkarchitekten und Leitern des Standortbetriebs die entscheidenden Schritte zur Bereitstellung sicherer, isolierter und skalierbarer Gästenetzwerke mit Ruijie RG-WS-Controllern und Reyee EG-Gateways. Wir behandeln den Übergang von der einfachen NAT-Weiterleitung zur robusten VLAN-Isolierung, die Konfiguration externer Captive Portals über WISPr und die Integration von Drittanbieter-Plattformen wie Purple, um First-Party-Daten zu erfassen und den Umsatz zu steigern. Unabhängig davon, ob Sie ein einzelnes Hotel oder ein standortübergreifendes Einzelhandelsportfolio verwalten, liefert dieser Leitfaden die praktischen, herstellerneutralen Konfigurationsschritte, die für den Aufbau eines rechtskonformen und leistungsstarken Wireless-Netzwerks erforderlich sind.
Technical Deep-Dive
Ruijie Networks bietet eine robuste Wireless-Architektur der Enterprise-Klasse, die mehrere Bereitstellungsmodelle für den Gästezugang unterstützt. Die Kernentscheidung für jeden Netzwerkarchitekten ist die Auswahl des geeigneten Authentifizierungsflusses und der Isolationsstrategie.
Captive Portal Deployment Models
Ruijie unterstützt drei verschiedene Bereitstellungsmodelle für Captive Portals, die jeweils für unterschiedliche betriebliche Anforderungen geeignet sind:
- Native Cloud Portal (Ruijie JaCS): Die integrierte Ruijie Cloud-Plattform, speziell die JaCS-Schnittstelle für das Gastgewerbe, bietet einen Drag-and-Drop-Portal-Builder. Dieses Modell wird unter „Device Config“ konfiguriert, wobei die SSID-Authentifizierung auf Captive Portal eingestellt wird. Es unterstützt grundlegende Anmeldeoptionen wie One-Click-Zugang und Gutscheincodes. Dies eignet sich für Einzelstandorte, die keine tiefgehenden Analysen oder externen CRM-Integrationen erfordern.
- External Captive Portal (WISPr/RADIUS): Für Enterprise-Bereitstellungen, den standortübergreifenden Einzelhandel und große öffentliche Veranstaltungsorte ist das externe Portalmodell zwingend erforderlich. Dieser Ansatz nutzt das WISPr-Protokoll, um den Gästedatenverkehr an eine Drittanbieter-Plattform wie Purple umzuleiten. Die Authentifizierung wird über eine externe RADIUS-Servergruppe mit PAP-Verschlüsselung abgewickelt. Dieses Modell ermöglicht eine fortschrittliche Datenerfassung, das GDPR-Compliance-Management und eine nahtlose Integration in bestehende Marketing-Stacks.
- Standalone AP Portal: Ruijie Reyee Access Points mit ReyeeOS 1.219 oder höher unterstützen ein lokalisiertes Captive Portal, ohne dass ein EG-Gateway erforderlich ist. Dies ist eine Fallback-Option für temporäre Bereitstellungen, bietet jedoch nicht die robusten QoS- und Isolationsfunktionen einer Controller-basierten Architektur.

Netzwerk-Isolation: NAT versus VLAN
Die wichtigste architektonische Entscheidung ist die Frage, wie der Gastdatenverkehr vom Unternehmensnetzwerk isoliert werden soll. Ruijie bietet zwei Weiterleitungsmodi für Gäste-SSIDs:
- NAT-Modus: Das Gateway weist IP-Adressen aus einem dedizierten Pool zu (standardmäßig 192.168.23.0/24) und führt eine Network Address Translation (NAT) durch, bevor der Datenverkehr ins Internet geleitet wird. Obwohl diese Methode einfach zu implementieren ist, bietet sie auf Layer 3 nur begrenzte Transparenz und Kontrolle über den Gastdatenverkehr.
- VLAN-Modus: Der empfohlene Unternehmensstandard. Die Gäste-SSID wird einem dedizierten VLAN zugewiesen (z. B. VLAN 100). Das Reyee EG Gateway oder der RG-WS Controller verwendet Access Control Lists (ACLs), um eine strikte Isolation zu erzwingen. Es muss eine erweiterte ACL konfiguriert werden, um IP-Datenverkehr vom Gäste-Subnetz zum Unternehmens-Subnetz zu blockieren, während der ausgehende Internetzugang erlaubt wird. Dieser Ansatz entspricht den Prinzipien aus What Is Secure WiFi: Essential Guide for Business 2026 .

Walled Garden Konfiguration
Bevor ein Gast die Authentifizierung am Captive Portal abschließt, befindet sich sein Gerät in einem eingeschränkten Zustand. Ein Walled Garden (Erlaubnisliste) muss konfiguriert werden, um den Zugriff auf wichtige Dienste zu ermöglichen. Wenn Sie eine externe Plattform nutzen, müssen Sie die Domain der Plattform, die IP-Adressen und die Authentifizierungsendpunkte aller Social-Login-Anbieter (wie Facebook oder Google) hinzufügen. Wichtig ist auch die Aufnahme von captive.apple.com, um sicherzustellen, dass iOS-Geräte den Mini-Browser des Captive Portals korrekt aktivieren.

Implementierungsleitfaden
Die Bereitstellung eines externen Captive Portals auf Ruijie-Hardware erfordert eine präzise Konfiguration der SSID, der Authentifizierungsrichtlinien und der Netzwerk-Isolationsschichten. Befolgen Sie diese Schritte, um Ruijie in eine externe Plattform wie Purple für erweiterte Guest WiFi -Analysen zu integrieren.
Schritt 1: Konfigurieren Sie die Gäste-SSID und das VLAN
- Navigieren Sie zu den Wireless-Einstellungen und erstellen Sie eine neue SSID, die für Ihren Standort passend benannt ist.
- Stellen Sie den Sicherheitsmodus auf „Open“ (Offen) ein. Das Captive Portal dient als Authentifizierungsmechanismus.
- Weisen Sie die SSID Ihrem dafür vorgesehenen Gäste-VLAN zu. Stellen Sie sicher, dass die entsprechende VLAN-Schnittstelle auf Ihrem EG Gateway mit einem DHCP-Bereich konfiguriert ist.
Schritt 2: Konfigurieren Sie die externe Captive Portal Richtlinie
- Navigieren Sie zum Bereich „Auth & Account“.
- Wählen Sie im Authentifizierungsmenü „Captive Portal“ aus.
- Erstellen Sie eine neue Richtlinie und stellen Sie den Richtlinienmodus auf „External“ (Extern) ein.
- Wählen Sie die in Schritt 1 erstellte Gäste-SSID aus.
- Geben Sie die von Ihrer externen Plattform bereitgestellte Portal-Server-URL ein (z. B. den Portal-Endpunkt von Purple).
- Konfigurieren Sie die RADIUS-Servergruppe mit den IP-Adressen, Ports (normalerweise 1812 für Authentifizierung und 1813 für Accounting) und Shared Secrets, die von Ihrer Plattform bereitgestellt werden.
Schritt 3: Definition des Walled Garden
- Navigieren Sie zu Auth & Account, dann zu Allowlist.
- Fügen Sie die erforderlichen Domänen und IP-Adressen hinzu. Für eine Purple-Integration umfasst dies die Domänen von Purple, Apples Captive Portal-Erkennungs-URL (
captive.apple.com) und alle erforderlichen Endpunkte für die Social-Media-Authentifizierung.
Schritt 4: Bandbreitenmanagement anwenden
- Navigieren Sie zu den QoS-Einstellungen auf Ihrem EG-Gateway.
- Wenden Sie Download- und Upload-Limits pro Benutzer auf das Gäste-VLAN an. Eine Standardzuweisung liegt je nach Backhaul-Kapazität zwischen 2 Mbit/s und 5 Mbit/s pro Benutzer. Dies ist entscheidend für ein effektives Bandwidth Management .
- Wenn Ihre externe Plattform QoS verarbeitet, stellen Sie sicher, dass "Client Escape" auf dem Ruijie-Gateway deaktiviert ist, um zu verhindern, dass Benutzer die Einschränkungen des Portals umgehen.
Best Practices
Bei der Bereitstellung von Ruijie Captive Portals gewährleistet die Einhaltung von Industriestandards und herstellerneutralen Best Practices ein zuverlässiges und sicheres Gästeerlebnis.
- Layer-3-Isolierung erzwingen: Verwenden Sie immer den VLAN-Modus mit strengen ACLs, um den Gästedatenverkehr von Unternehmensressourcen zu trennen. Sich allein auf den NAT-Modus zu verlassen, setzt das Netzwerk unnötigen Risiken aus. Lesen Sie Why Consumer WiFi Gear Doesn't Belong on Your Guest Network für weitere Informationen.
- Optimierung des Walled Garden: Ein falsch konfigurierter Walled Garden ist die Hauptursache für Fehler beim Captive Portal auf Mobilgeräten. Überprüfen Sie regelmäßig Ihre Allowlist, um sicherzustellen, dass alle erforderlichen Domänen, insbesondere die von Social-Login-Anbietern, vor der Authentifizierung zugänglich sind.
- Robustes QoS implementieren: Unverwaltete Gästenetzwerke verschlechtern sich schnell. Wenden Sie Bandbreitenlimits pro Benutzer am Gateway oder über die externe Portal-Plattform an, um einen fairen Zugriff für alle Benutzer zu gewährleisten.
- Plattformübergreifend testen: Testen Sie den Captive Portal-Ablauf immer sowohl auf iOS- als auch auf Android-Geräten, bevor Sie in die Produktionsumgebung gehen. Die Betriebssysteme handhaben die Erkennung von Captive Portals unterschiedlich, und Tests gewährleisten eine konsistente Benutzererfahrung.
Fehlerbehebung & Risikominderung
Selbst bei einer soliden Konfiguration können Probleme auftreten. Hier sind häufige Fehlerszenarien und wie man sie behebt.
iOS-Geräte zeigen das Portal nicht an
- Ursache: Der Apple-Endpunkt zur Erkennung des Captive Portals ist blockiert.
- Fehlerbehebung: Überprüfen Sie, ob
captive.apple.comexplizit in der Ruijie-Allowlist unter Auth & Account hinzugefügt wurde. Ohne dies können iOS-Geräte den Mini-Browser nicht aktivieren.
Authentifizierung schlägt nach Eingabe der Daten fehl
- Ursache: RADIUS-Kommunikationsfehler zwischen dem Ruijie-Gateway und der externen Plattform.
- Fehlerbehebung: Überprüfen Sie das RADIUS Shared Secret auf Tippfehler. Stellen Sie sicher, dass das EG-Gateway ausgehenden Internetzugang über die UDP-Ports 1812 und 1813 hat. Überprüfen Sie, ob die öffentliche IP-Adresse des Gateways korrekt auf der externen Plattform registriert ist.
Gäste umgehen Bandbreitenlimits
- Ursache: 'Client Escape' ist aktiviert oder die QoS-Richtlinien sind falsch konfiguriert.
- Behebung: Deaktivieren Sie 'Client Escape' auf dem Ruijie-Gateway, wenn Sie eine externe Plattform für QoS nutzen. Stellen Sie sicher, dass die QoS-Richtlinie auf das richtige VLAN oder die richtige Benutzergruppe angewendet wird.
ROI & geschäftlicher Nutzen
Der Übergang von einem einfachen, offenen Netzwerk zu einem verwalteten Captive Portal, das in eine Plattform wie Purple integriert ist, verwandelt das Gäste-WiFi von einem Kostenfaktor in einen umsatzgenerierenden Vermögenswert.
Durch die Erfassung von First-Party-Daten über das Portal können Veranstaltungsorte detaillierte Kundenprofile erstellen, die Besuchshäufigkeit verfolgen und zielgerichtete Marketingkampagnen bereitstellen. Dies ist besonders wertvoll in Einzelhandels- und Gastronomie-Umgebungen , in denen das Verständnis des Kundenverhaltens direkten Einfluss auf das Geschäftsergebnis hat. Darüber hinaus ermöglichen die von der Plattform bereitgestellten WiFi-Analysen den Betriebsteams, den Personaleinsatz zu optimieren, das Layout der Veranstaltungsorte zu verbessern und den Erfolg von Marketinginitiativen zu messen. Der Return on Investment wird durch eine höhere Kundenbindung, höhere Ausgaben pro Besuch und die Möglichkeit, das Netzwerk durch Sponsoring oder Premium-Zugangstarife zu monetarisieren, realisiert.
Audio-Briefing
Hören Sie sich das vollständige technische Briefing zur Konfiguration von Ruijie Captive Portals an:
Schlüsseldefinitionen
WISPr
Wireless Internet Service Provider roaming. Ein Protokoll, das die Weiterleitung und den Authentifizierungs-Handshake zwischen einem Wireless Gateway und einem externen Captive Portal erleichtert.
Erforderlich bei der Integration von Ruijie-Hardware in Analyseplattformen von Drittanbietern wie Purple.
RADIUS
Remote Authentication Dial-In User Service. Ein Netzwerkprotokoll, das eine zentrale Verwaltung von Authentifizierung, Autorisierung und Accounting (AAA) bietet.
Wird von Ruijie-Gateways verwendet, um Gastsitzungen mit der Datenbank einer externen Plattform zu authentifizieren.
VLAN Isolation
Die Praxis, Gast-Traffic einem separaten Virtual Local Area Network zuzuweisen und Access Control Lists (ACLs) zu verwenden, um die Kommunikation mit Unternehmensnetzwerken zu blockieren.
Der obligatorische Sicherheitsstandard für Enterprise-Gast-WiFi-Bereitstellungen.
Walled Garden
Eine eingeschränkte Netzwerkumgebung, die den Zugriff auf bestimmte, freigegebene Domänen oder IP-Adressen ermöglicht, bevor sich ein Benutzer vollständig authentifiziert.
Erforderlich, damit Geräte die Captive Portal-Seite und alle erforderlichen Social-Login-Anbieter erreichen können.
Client Escape
Eine Funktion auf Ruijie-Gateways, die es Clients bei Aktivierung ermöglicht, Portal-Einschränkungen unter bestimmten Bedingungen zu umgehen.
Muss deaktiviert werden, wenn für QoS und Bandbreitenmanagement eine externe Plattform genutzt wird.
JaCS
Das native, auf das Gastgewerbe ausgerichtete Cloud-Managementsystem von Ruijie, das einen integrierten Captive Portal-Builder enthält.
Wird für das Bereitstellungsmodell Native Cloud Portal verwendet, wenn keine externe Integration erforderlich ist.
Captive Portal
Eine Webseite, die ein Benutzer eines öffentlich zugänglichen Netzwerks anzeigen und mit der er interagieren muss, bevor der Zugriff gewährt wird.
Der primäre Mechanismus für das Onboarding von Gästen, die Annahme von Nutzungsbedingungen und die Datenerfassung.
Access Control List (ACL)
Eine Reihe von Regeln, die auf eine Netzwerkschnittstelle angewendet werden und Datenverkehr basierend auf IP-Adressen oder Protokollen explizit zulassen oder blockieren.
Wird in Verbindung mit VLANs verwendet, um eine strikte Isolierung zwischen Gast- und Unternehmensnetzwerken durchzusetzen.
Ausgearbeitete Beispiele
Ein Hotel mit 200 Zimmern möchte in seiner gesamten Anlage ein Gäste-WiFi mit Ruijie Reyee EG-Gateways und RAP-Access-Points bereitstellen. Benötigt werden ein nahtloses Onboarding, Bandbreitenbegrenzungen von 5 Mbps pro Benutzer und eine Integration in das bestehende CRM-System, um E-Mail-Adressen von Gästen für das Marketing nach dem Aufenthalt zu erfassen. Zudem muss sichergestellt werden, dass Gastgeräte nicht auf das Back-Office-Netzwerk des Hotels zugreifen können. Wie sollte der Netzwerkarchitekt die Ruijie-Hardware konfigurieren?
- Konfigurieren Sie die Gäste-SSID mit der Sicherheitsstufe "Offen" und weisen Sie sie einem dedizierten VLAN zu (z. B. VLAN 100). 2. Konfigurieren Sie auf dem EG-Gateway eine erweiterte ACL, um Datenverkehr von VLAN 100 zum Unternehmens-VLAN (z. B. VLAN 10) zu blockieren, während der ausgehende Internetzugang zugelassen wird. 3. Navigieren Sie zu Auth & Account und konfigurieren Sie eine externe Captive Portal-Richtlinie unter Verwendung des WISPr-Protokolls. 4. Verweisen Sie mit der Portal-Server-URL auf die in das CRM integrierte Plattform (z. B. Purple) und konfigurieren Sie die RADIUS-Servergruppe mit den bereitgestellten Anmeldedaten. 5. Fügen Sie die erforderlichen Domänen zur Allowlist hinzu, einschließlich der Portal-Domäne, Social-Login-Endpunkte und
captive.apple.com. 6. Wenden Sie eine QoS-Richtlinie auf dem EG-Gateway an, um die Bandbreite pro Benutzer im VLAN 100 auf 5 Mbps zu begrenzen.
Ein großes Konferenzzentrum veranstaltet einen dreitägigen Technologie-Gipfel. Zum Einsatz kommen Ruijie RG-WS-Controller. Es wird ein Captive Portal benötigt, das Teilnehmer mit einem speziellen Event-Code authentifiziert. Eine langfristige Datenerfassung oder eine externe CRM-Integration sind nicht erforderlich, aber das Portal muss auf allen Teilnehmergeräten zuverlässig geladen werden. Was ist das effizienteste Bereitstellungsmodell?
- Nutzen Sie das native Cloud-Portal-Bereitstellungsmodell (Ruijie JaCS). 2. Navigieren Sie in der Ruijie Cloud zu Device Config und konfigurieren Sie die Gäste-SSID für die Captive Portal-Authentifizierung. 3. Verwenden Sie den JaCS-Portal-Builder, um eine gebrandete Begrüßungsseite zu erstellen. 4. Wählen Sie die Login-Option "Voucher" oder "Access Code" und generieren Sie den spezifischen Event-Code für den Gipfel. 5. Stellen Sie sicher, dass der Walled Garden so konfiguriert ist, dass er
captive.apple.comzulässt, um sicherzustellen, dass das Portal auf iOS-Geräten ausgelöst wird. 6. Synchronisieren Sie die Konfiguration mit dem RG-WS-Controller.
Übungsfragen
Q1. Eine Einzelhandelskette mit 50 Standorten möchte ein Gäste-WiFi mit Ruijie Reyee EG Gateways bereitstellen. Es wird die Möglichkeit benötigt, E-Mail-Adressen von Kunden zu erfassen und diese mit dem zentralen CRM zu synchronisieren. Welches Portal-Bereitstellungsmodell müssen sie wählen?
Hinweis: Berücksichtigen Sie die Anforderungen an die Integration externer Systeme und die Datenerfassung.
Musterlösung anzeigen
Sie müssen das External Captive Portal (WISPr/RADIUS)-Modell wählen. Das Native Cloud Portal (JaCS) unterstützt keine erweiterten externen CRM-Integrationen oder eine zentralisierte Datenerfassung über ein großes, standortübergreifendes Anwesen hinweg.
Q2. Nach der Bereitstellung eines External Captive Portals in einem Ruijie-Netzwerk zeigen Android-Geräte die Login-Seite erfolgreich an, aber iOS-Geräte zeigen einen leeren Bildschirm oder rufen das Portal nicht auf. Was ist die wahrscheinlichste Ursache?
Hinweis: Überprüfen Sie die Anforderungen für den eingeschränkten Netzwerkzustand vor der Authentifizierung.
Musterlösung anzeigen
Der Walled Garden (Allowlist) ist falsch konfiguriert. Insbesondere wurde wahrscheinlich captive.apple.com weggelassen. iOS-Geräte benötigen Zugriff auf diesen Endpunkt, um das Captive Portal zu erkennen und den Mini-Browser zu starten.
Q3. Ein Netzwerkadministrator hat eine Gäste-SSID auf einem Ruijie Gateway im NAT-Modus konfiguriert. Warum wird dieser Ansatz für eine Unternehmensbereitstellung nicht empfohlen und was sollte stattdessen verwendet werden?
Hinweis: Berücksichtigen Sie den Grad der Kontrolle und Isolierung, der für den Gästeverkehr erforderlich ist.
Musterlösung anzeigen
Der NAT-Modus bietet nur begrenzte Transparenz und Kontrolle über den Gästeverkehr auf Layer 3, was die Durchsetzung strenger Sicherheitsrichtlinien erschwert. Der empfohlene Ansatz ist der VLAN-Modus, bei dem die Gäste-SSID einem dedizierten VLAN zugewiesen wird und Access Control Lists (ACLs) verwendet werden, um den Datenverkehr zum Unternehmensnetzwerk explizit zu sperren.
Weiterlesen in dieser Reihe
Einrichtung eines Captive Portals auf Starlink: Ein Leitfaden für abgelegene und maritime Standorte
Dieser Leitfaden beschreibt detailliert, wie Sie die native Starlink-Hardware umgehen und ein Cloud-gesteuertes Captive Portal mithilfe von Enterprise-Routing-Geräten integrieren. Sie erfahren, wie Sie die CGNAT-Einschränkung überwinden, eine VLAN-Segmentierung erzwingen, Bandbreitenbeschränkungen von Satelliten verwalten und die Einhaltung gesetzlicher Vorschriften sicherstellen.
Captive Portal Best Practices: Design für hohe Conversion und Compliance
Dieser technische Leitfaden bietet IT-Managern, Netzwerkarchitekten und Leitern des Standortbetriebs ein vollständiges Konzept für die Bereitstellung von Captive Portalen, die Netzwerksicherheit mit hoher User Conversion verbinden. Er deckt die gesamte Architektur ab, von der VLAN-Segmentierung und RADIUS-Authentifizierung bis hin zur GDPR-konformen Einwilligungserklärung und der Auswahl der Authentifizierungsmethode. Basierend auf den betrieblichen Erfahrungen von Purple in über 80.000 Standorten und 440 Millionen Logins im Jahr 2024 ist jede Empfehlung durch reale Bereitstellungsdaten untermauert.
How to Optimize Captive Portals for Maximum Network Security and User Conversion
Dieser Leitfaden bietet eine vollständige technische Blaupause für die Optimierung von Captive Portals in Unternehmensstandorten und deckt Netzwerksegmentierungsarchitektur, die Auswahl von Authentifizierungsmethoden, GDPR-konformes Einwilligungsdesign und die Conversion-Optimierung ab. Er richtet sich an IT-Manager, Netzwerkarchitekten und CTOs in Hotels, Einzelhandelsketten, Stadien und Organisationen des öffentlichen Sektors, die Netzwerksicherheit mit der Erfassung von First-Party-Daten in Einklang bringen müssen. Purple betreibt eine Captive Portal-Infrastruktur an über 80.000 Standorten mit 440 Millionen Logins im Jahr 2024, und die hier vorgestellten Frameworks spiegeln diese betriebliche Erfahrung wider.