How to Configure Guest WiFi and Captive Portals on Ruijie Networks
This technical guide details the configuration of guest WiFi and captive portals on Ruijie Networks hardware, covering both native cloud portals and external RADIUS integrations. It provides IT managers and network architects with actionable steps for VLAN isolation, walled garden setup, and third-party platform integration to drive analytics and revenue.
Diesen Leitfaden anhören
Podcast-Transkript ansehen
📚 Teil unserer Kernserie: Captive Portal Guide →
- Executive Summary
- Technischer Deep-Dive
- Captive Portal Bereitstellungsmodelle
- Netzwerkisolation: NAT versus VLAN
- Walled Garden Konfiguration
- Implementierungsleitfaden
- Schritt 1: Konfigurieren der Gast-SSID und des VLANs
- Schritt 2: Konfigurieren der externen Captive Portal Richtlinie
- Schritt 3: Walled Garden implementieren
- Schritt 4: ACL-Isolierung erzwingen
- Best Practices
- Fehlerbehebung & Risikominderung
- ROI & geschäftlicher Nutzen

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. Dieser technische Leitfaden bietet IT-Managern, Netzwerkarchitekten und Betriebsleitern von Veranstaltungsorten 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, bietet dieser Leitfaden die praktischen, herstellerneutralen Konfigurationsschritte, die für den Aufbau eines konformen und leistungsstarken drahtlosen Netzwerks erforderlich sind.
Technischer Deep-Dive
Ruijie Networks bietet eine robuste, professionelle Wireless-Architektur, 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 Bereitstellungsmodelle
Ruijie unterstützt drei verschiedene Bereitstellungsmodelle für Captive Portals, die jeweils für unterschiedliche betriebliche Anforderungen geeignet sind:
- Natives Cloud-Portal (Ruijie JaCS): Die integrierte Ruijie Cloud-Plattform, insbesondere die JaCS-Schnittstelle für das Gastgewerbe, bietet einen Drag-and-Drop-Portal-Builder. Dieses Modell wird unter „Device Config“ konfiguriert, wo die SSID-Authentifizierung auf Captive Portal eingestellt ist. 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.
- Externes Captive Portal (WISPr/RADIUS): Für Unternehmensbereitstellungen, standortübergreifenden Einzelhandel und große öffentliche Veranstaltungsorte ist das externe Portalmodell zwingend erforderlich. Dieser Ansatz verwendet das WISPr-Protokoll, um den Gästeverkehr auf eine Drittanbieter-Plattform wie Purple umzuleiten. Die Authentifizierung erfolgt über eine externe RADIUS-Servergruppe mit PAP-Verschlüsselung. Dieses Modell ermöglicht eine fortschrittliche Datenerfassung, ein GDPR-Konformitätsmanagement und eine nahtlose Integration in bestehende Marketing-Systeme.
- 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.

Netzwerkisolation: NAT versus VLAN
Die wichtigste architektonische Entscheidung ist die Frage, wie der Gast-Traffic vom Unternehmensnetzwerk isoliert werden soll. Ruijie bietet zwei Weiterleitungsmodi für Gast-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 durch, bevor der Traffic ins Internet geleitet wird. Diese Methode ist zwar einfach zu implementieren, bietet jedoch nur eingeschränkte Sichtbarkeit und Kontrolle über den Gast-Traffic auf Layer 3.
- VLAN-Modus: Der empfohlene Unternehmensstandard. Die Gast-SSID wird einem dedizierten VLAN (z. B. VLAN 100) zugewiesen. Das Reyee EG-Gateway oder der RG-WS-Controller verwendet Access Control Lists (ACLs), um eine strikte Isolation durchzusetzen. Es muss eine erweiterte ACL konfiguriert werden, um IP-Traffic vom Gast-Subnetz zum Unternehmensnetzwerk zu blockieren, während der ausgehende Internetzugriff erlaubt wird. Dieser Ansatz entspricht den Prinzipien von Enterprise WiFi Security: A Complete Guide for 2026 .
Walled Garden Konfiguration
Bevor ein Gast die Authentifizierung über das Captive Portal abschließt, befindet sich sein Gerät in einem eingeschränkten Zustand. Ein Walled Garden (eine Whitelist) 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 Authentifizierungs-Endpunkte aller Social-Login-Anbieter (wie Facebook oder Google) hinzufügen. Besonders wichtig ist 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 Netzwerkisolationsschichten. Befolgen Sie diese Schritte, um Ruijie mit einer externen Plattform wie Purple zu integrieren.
Schritt 1: Konfigurieren der Gast-SSID und des VLANs
- Melden Sie sich in der Ruijie Cloud oder auf der lokalen eWeb-Benutzeroberfläche Ihres Controllers an.
- Navigieren Sie zu den Wireless-Einstellungen und erstellen Sie eine neue SSID mit einem für Ihren Standort passenden Namen.
- Stellen Sie den Sicherheitsmodus auf "Open". Das Captive Portal dient als Authentifizierungsmechanismus.
- Weisen Sie die SSID Ihrem dafür vorgesehenen Gast-VLAN zu. Stellen Sie sicher, dass die entsprechende VLAN-Schnittstelle auf Ihrem EG-Gateway mit einem DHCP-Bereich konfiguriert ist.
Schritt 2: Konfigurieren der externen Captive Portal Richtlinie
- Navigieren Sie zum Bereich „Auth & Account“.
- Wählen Sie Captive Portal unter dem Menü „Authentication“.
- Erstellen Sie eine neue Richtlinie und setzen Sie den „Policy Mode“ auf „External“.
- Wählen Sie die in Schritt 1 erstellte Guest SSID aus.
- Geben Sie die Portal-Server-URL ein, die von Ihrer externen Plattform bereitgestellt wird (z. B. der Portal-Endpunkt von Purple).
- Konfigurieren Sie die RADIUS-Servergruppe mit den IP-Adressen, Ports (normalerweise 1812 für die Authentifizierung und 1813 für das Accounting) und den von Ihrer Plattform bereitgestellten Shared Secrets.
Schritt 3: Walled Garden implementieren
- Suchen Sie im Bereich „Auth & Account“ die Konfiguration für die „Allowlist“.
- Fügen Sie die erforderlichen Domains und IP-Adressen für Ihre externe Plattform hinzu.
- Fügen Sie die Domains für alle Social-Identity-Anbieter hinzu, die Sie verwenden möchten.
- Stellen Sie sicher, dass Standard-Domains zur Erkennung von Captive Portals zugelassen sind.
Schritt 4: ACL-Isolierung erzwingen
Verbinden Sie sich mit der Befehlszeilenschnittstelle (CLI) Ihres Ruijie-Gateways oder -Controllers, um die Isolations-ACL zu konfigurieren. Dieser Schritt stellt sicher, dass Gäste keine internen Ressourcen erreichen können.
Ruijie(config)# access-list extended 107
Ruijie(config-ext-nacl)# deny ip 192.168.100.0 0.0.0.255 192.168.10.0 0.0.0.255
Ruijie(config-ext-nacl)# permit ip any any
Ruijie(config-ext-nacl)# exit
Ruijie(config)# interface BVI 100
Ruijie(config-if-BVI 100)# access-group 107 in
Best Practices
Um ein zuverlässiges und sicheres Gäste-WiFi-Erlebnis zu gewährleisten, halten Sie sich an diese branchenüblichen Best Practices:
- Externe Authentifizierung für Skalierbarkeit nutzen: Wenn Sie mehrere Standorte verwalten oder detaillierte Guest WiFi -Analysen benötigen, umgehen Sie das native Portal und nutzen Sie eine externe RADIUS-Integration. Plattformen wie Purple bieten eine hardwareunabhängige Verwaltung, mit der Sie das Gästeerlebnis über Ruijie-, Cisco Meraki-, HPE Aruba- und Ruckus-Hardware hinweg standardisieren können.
- Gestaffelte Bandbreite implementieren: Nutzen Sie die QoS-Funktionen des Ruijie EG-Gateways, um Bandbreitenbegrenzungen pro Benutzer durchzusetzen. Bieten Sie eine kostenlose Basisstufe an (z. B. 5 Mbps) und binden Sie über Ihr externes Portal ein Zahlungs-Gateway ein, um eine kostenpflichtige Premium-Stufe mit hoher Geschwindigkeit anzubieten. Dies schafft eine direkte Einnahmequelle aus Ihrer Infrastruktur.
- Konfigurationen synchronisieren: Wenn Sie die Ruijie JaCS-Plattform verwenden, müssen Sie nach dem Ändern einer Captive Portal-Richtlinie explizit auf die Schaltfläche „Synchronise“ klicken. Andernfalls erhält das EG-Gateway die aktualisierte Konfiguration nicht, was zu einem inkonsistenten Verhalten des Portals führt.
- Datenschutzbestimmungen einhalten: Stellen Sie sicher, dass Ihr Captive Portal explizite Opt-ins mit bewusster Zustimmung für Marketingkommunikation enthält. Bei der Verwendung von Purple übernimmt die Plattform automatisch die GDPR- und CCPA-Konformität und bietet eine sichere Datenschutzebene. Detaillierte Anforderungen finden Sie im Leitfaden The Network Administrator’s Guide to GDPR and Guest Data Privacy Compliance .
Fehlerbehebung & Risikominderung
Selbst bei sorgfältiger Konfiguration kann es bei der Bereitstellung von Captive Portals zu Problemen kommen. Hier sind die häufigsten Fehlerszenarien und deren Behebung:
- iOS-Geräte zeigen das Portal nicht an: Dies ist fast immer ein Problem mit dem Walled Garden. Apple-Geräte prüfen
captive.apple.com, um festzustellen, ob sie sich hinter einem Portal befinden. Wenn diese Domain blockiert ist, geht das Gerät davon aus, dass es vollen Internetzugang hat, und startet den Captive Network Assistant nicht. Überprüfen Sie Ihre Allowlist-Konfiguration. - Gäste können sich nicht über RADIUS authentifizieren: Überprüfen Sie das RADIUS Shared Secret und die Portkonfigurationen auf dem Ruijie-Gateway. Stellen Sie sicher, dass die öffentliche IP-Adresse des Gateways auf Ihrer externen Plattform korrekt registriert ist. Nutzen Sie die Ruijie-Diagnosetools, um die RADIUS-Erreichbarkeit zu überprüfen.
- Bandbreitenbegrenzungen werden ignoriert: Wenn Sie eine externe Plattform zur Durchsetzung von Bandbreitenstufen nutzen, müssen Sie die Funktion "Client Escape" auf dem Ruijie-Gateway deaktivieren. Wenn Client Escape aktiv ist, umgeht das Gateway unter Umständen die QoS-Anweisungen der externen Plattform.
- Gast-Traffic gelangt in das Unternehmensnetzwerk: Überprüfen Sie Ihre ACL-Konfiguration. Stellen Sie sicher, dass die erweiterte Access-Liste eingehend auf dem richtigen VLAN- oder BVI-Interface angewendet wird. Testen Sie die Isolierung, indem Sie ein Gerät mit der Gast-SSID verbinden und versuchen, eine bekannte interne IP-Adresse anzupingen.
ROI & geschäftlicher Nutzen
Die Bereitstellung eines robusten Captive Portals auf Ruijie-Hardware verwandelt das Gast-WiFi von einem Kostenfaktor in einen messbaren Geschäftswert. Durch die Integration einer externen WiFi Analytics -Plattform wie Purple können Veranstaltungsorte erhebliche Renditen erzielen.
- Erfassung von First-Party-Daten: Das Captive Portal fungiert als primärer Datenerfassungspunkt. Indem sie kostenloses WiFi im Austausch gegen eine E-Mail-Adresse oder einen Social-Login anbieten, bauen Veranstaltungsorte eine reichhaltige Datenbank mit Kundenprofilen auf. Diese Daten speisen zielgerichtete Marketingkampagnen und steigern den Customer Lifetime Value.
- Operative Effizienz: Das zentrale Cloud-Management über Ruijie Cloud und Purple reduziert den Zeitaufwand für IT-Teams bei der Behebung lokaler Netzwerkprobleme. Da das Overlay hardwareunabhängig ist, können Sie Access Points aktualisieren oder austauschen, ohne Ihren gesamten Analytics-Stack neu aufbauen zu müssen.
- Direkte Umsatzgenerierung: Die Implementierung von gestuften Bandbreitenmodellen ermöglicht es Veranstaltungsorten, das Netzwerk direkt zu monetarisieren. So implementierte beispielsweise AGS Airports eine gestufte WiFi-Strategie und erzielte eine Investitionsrendite von 842 %.
- Verbessertes Besuchererlebnis: Ein nahtloser, gebrandeter Login-Prozess steigert die Kundenzufriedenheit. In Branchen wie dem Gastgewerbe und dem Einzelhandel ist eine zuverlässige Konnektivität eine Grunderwartung; eine sichere Bereitstellung stärkt das Markenvertrauen.
Schlüsseldefinitionen
Captive Portal
Eine Webseite, die ein Benutzer eines öffentlichen Netzwerks ansehen und mit der er interagieren muss, bevor ihm der Zugriff gewährt wird.
Der primäre Mechanismus zur Authentifizierung von Gästen und zur Erfassung von First-Party-Daten in einem drahtlosen Ruijie-Netzwerk.
RADIUS
Remote Authentication Dial-In User Service. Ein Netzwerkprotokoll, das eine zentrale Verwaltung von Authentifizierung, Autorisierung und Accounting bietet.
Wird verwendet, um Ruijie-Gateways sicher mit externen Plattformen wie Purple für die Gästebewertung zu verbinden.
Walled Garden
Eine Whitelist von Domains und IP-Adressen, auf die ein Gästegerät zugreifen kann, bevor die Authentifizierung am Captive Portal abgeschlossen ist.
Unerlässlich, damit Social-Login-Anbieter und Mechanismen zur Erkennung von Captive Portals (wie Apples CNA) funktionieren können.
VLAN Isolation
Die Praxis, den Gast-Traffic einem separaten Virtual Local Area Network zuzuweisen und Access Control Lists zu verwenden, um die Kommunikation mit internen Unternehmensnetzwerken zu verhindern.
Der Standard-Sicherheitsstatus für Enterprise-Gast-WiFi-Bereitstellungen auf Ruijie-Hardware.
WISPr
Wireless Internet Service Provider Roaming. Ein Protokoll, das es Benutzern ermöglicht, zwischen verschiedenen Mobilfunkanbietern zu wechseln, und das häufig für die Weiterleitung zu externen Captive Portals verwendet wird.
Der zugrunde liegende Mechanismus, den Ruijie verwendet, wenn die Captive Portal-Richtlinie auf den externen Modus eingestellt ist.
Ruijie JaCS
Die Cloud-Management-Plattform von Ruijie, die speziell auf das Gastgewerbe und Hotelszenarien zugeschnitten ist und native Tools zur Erstellung von Captive Portals bietet.
Wird für die Verwaltung von Bereitstellungen an einzelnen Standorten verwendet, die keine externen Datenerfassungsplattformen erfordern.
Reyee EG Gateway
Die Produktlinie von Ruijie für Enterprise-Sicherheitsrouter, die das Routing, Firewall-Richtlinien und die Weiterleitung zum Captive Portal für das drahtlose Netzwerk übernehmen.
Die zentrale Hardwarekomponente, auf der ACLs und RADIUS-Konfigurationen in einer Ruijie-Bereitstellung angewendet werden.
Client Escape
Eine Funktion auf Ruijie-Gateways, die es Clients bei Aktivierung ermöglichen kann, bestimmte QoS- oder Portal-Einschränkungen zu umgehen.
Muss deaktiviert werden, wenn eine externe Plattform zur Durchsetzung von gestaffelten Bandbreitenbegrenzungen verwendet wird.
Ausgearbeitete Beispiele
Ein Hotel mit 200 Zimmern, das Ruijie RG-AP Access Points und ein EG Gateway einsetzt, muss kostenloses Guest WiFi anbieten und gleichzeitig E-Mail-Adressen für seine Marketing-Datenbank erfassen. Zudem ist eine strikte Isolierung vom Netzwerk des Property-Management-Systems (PMS) erforderlich.
Das IT-Team konfiguriert eine neue Open SSID, die VLAN 100 zugewiesen ist. Auf dem EG Gateway konfigurieren sie eine erweiterte ACL, um den Datenverkehr von VLAN 100 zum PMS-VLAN zu blockieren, und wenden diese eingehend auf der Guest-Schnittstelle an. Sie setzen die Captive Portal-Richtlinie auf den externen Modus und verweisen mit der Portal-Server-URL auf die Plattform von Purple. Sie konfigurieren die RADIUS-Servergruppe mit den Zugangsdaten von Purple und fügen die Domains von Purple zur Whitelist hinzu. Die Purple-Plattform übernimmt die gebrandete Splash-Page und den Workflow zur E-Mail-Erfassung.
Eine Einzelhandelskette mit 50 Standorten führt Ruijie-Hardware ein. Kunden berichten, dass beim Verbinden mit dem Guest WiFi auf ihren iPhones der Anmeldebildschirm nicht automatisch erscheint, sodass sie manuell einen Browser öffnen müssen.
Der Netzwerkadministrator meldet sich in der Ruijie Cloud an, navigiert zu "Auth & Account" und öffnet die Whitelist-Konfiguration. Er fügt "captive.apple.com" zur Walled-Garden-Liste hinzu und synchronisiert die Konfiguration mit allen EG Gateways im gesamten Bestand.
Übungsfragen
Q1. Sie stellen Ruijie WiFi in einem Stadion bereit. Sie müssen Fandaten für das Marketing erfassen und ein Bandbreitenlimit von 5 Mbps pro Benutzer durchsetzen. Sollten Sie das native Ruijie-Portal oder eine externe Plattform verwenden, und wie setzen Sie die Bandbreite durch?
Hinweis: Berücksichtigen Sie die Skalierung der Bereitstellung und die Anforderungen an die Datenerfassung.
Musterlösung anzeigen
Sie müssen eine externe Plattform wie Purple für die Datenerfassung und Marketing-Integration nutzen. Um die Bandbreite durchzusetzen, konfigurieren Sie die QoS-Einstellungen auf dem Ruijie EG-Gateway für die Gäste-SSID und stellen Sie sicher, dass die Funktion "Client Escape" deaktiviert ist, damit die Richtlinien der externen Plattform eingehalten werden.
Q2. Ein Kunde beschwert sich, dass sein Gästenetzwerk unsicher ist, weil die SSID auf "Open" eingestellt ist. Er bittet Sie, einen Pre-Shared Key (WPA2-Personal) parallel zum Captive Portal zu implementieren. Was raten Sie ihm?
Hinweis: Berücksichtigen Sie die Benutzererfahrung und den Zweck des Captive Portals.
Musterlösung anzeigen
Weisen Sie den Kunden darauf hin, dass das Hinzufügen eines Pre-Shared Keys bei öffentlichen Gästenetzwerken unnötige Hürden schafft, ohne die Sicherheit signifikant zu verbessern, da der Schlüssel ohnehin öffentlich geteilt werden muss. Das Captive Portal selbst dient als Authentifizierungs- und Autorisierungsebene. Für echte Sicherheit sollte WPA3-Enterprise mit 802.1X verwendet werden, was jedoch für den öffentlichen Gästezugang selten geeignet ist.
Q3. Nach dem Konfigurieren einer neuen externen Captive Portal-Richtlinie in der Ruijie Cloud und der Ausrichtung auf Purple sehen Gäste immer noch die standardmäßige Ruijie-Anmeldeseite. Was ist die wahrscheinlichste Ursache?
Hinweis: Denken Sie an den Prozess der Konfigurationsbereitstellung in der Ruijie-Benutzeroberfläche.
Musterlösung anzeigen
Der Administrator hat die Konfiguration wahrscheinlich in der Ruijie Cloud gespeichert, aber vergessen, auf die Schaltfläche "Synchronisieren" zu klicken. Die Konfiguration wurde nicht an das lokale EG-Gateway übertragen, sodass dieses immer noch das standardmäßige lokale Portal anzeigt.
Weiterlesen in dieser Reihe
Captive Portal für Ruijie: Einrichtung mit Purple Gäste-WiFi
Wie das Cloud-Gäste-WiFi von Purple über Web-Authentifizierung und RADIUS auf Ruijie RG Series Access Points aufsetzt, konfiguriert über die Befehlszeile, und wo Sie die genauen Einrichtungsschritte finden.
B2B Captive Portals gestalten: Erfassung von registrierten Namen und Unternehmensdaten
Dieser Leitfaden bietet IT-Managern und Betreibern von Veranstaltungsorten ein herstellerneutrales technisches Framework für das Design von B2B Captive Portals. Er beschreibt im Detail, wie Registrierungsfelder strukturiert werden sollten, um registrierte Namen und Unternehmensdaten zu erfassen, um hohe Ausfüllraten zu gewährleisten, während gleichzeitig die GDPR-Konformität gewahrt und Account-Level-Intelligence aufgebaut wird.
Captive Portal Architektur: Sicherheit, Umleitung und Best Practices
Ein definitives technisches Referenzdokument zur Captive Portal-Architektur in Unternehmen. Dieser Leitfaden beleuchtet Netzwerkisolierung, DNS-Umleitung, RADIUS-Authentifizierung und Sicherheitskonformität für IT-Entscheider, die sichere, datenreiche Gäste-WiFi-Netzwerke bereitstellen.