跳至主要內容

如何在 Ruijie Networks 設備上設定訪客 WiFi 與 Captive Portals

本技術指南詳細介紹了在 Ruijie Networks 硬體上設定訪客 WiFi 和 Captive Portals 的步驟,涵蓋原生雲端入口網站與外部 RADIUS 整合。本指南為 IT 經理和網路架構師提供了 VLAN 隔離、Walled Garden 設定以及第三方平台整合的具體實作步驟,以推動數據分析並創造收益。

📖 6 分鐘閱讀📝 1,489 字數🔧 2 範例3 練習題📚 8 關鍵定義

收聽此指南

查看播客逐字稿
How to Configure Guest WiFi and Captive Portals on Ruijie Networks A Purple Technical Briefing - Approximately 10 minutes INTRODUCTION AND CONTEXT - 1 minute Welcome to the Purple Technical Briefing. I am your host, and over the next ten minutes we are going to cover everything you need to know about configuring guest WiFi and captive portals on Ruijie Networks hardware. If you are an IT manager, network architect, or venue operations director at a hotel, retail chain, stadium, or conference centre, and you have Ruijie kit on-site or you are evaluating it, this briefing is for you. Ruijie Networks is one of the fastest-growing enterprise wireless vendors globally. Their RG-WS series controllers, Reyee EG gateways, and cloud-managed access points are now deployed across thousands of venues in Europe, the Middle East, Asia, and beyond. But getting guest WiFi right on Ruijie hardware - specifically the captive portal piece - requires understanding a few architectural decisions upfront. Get those decisions wrong and you end up with a portal that breaks on iOS, guests who cannot authenticate, and a network that is either too open or too locked down. Let us fix that. TECHNICAL DEEP-DIVE - 5 minutes First, the architecture. Ruijie gives you three distinct deployment models for guest WiFi, and choosing the right one depends on your scale and your management approach. Model one is the Ruijie Cloud or JaCS managed portal. This is the native, built-in option. You log into Ruijie Cloud, navigate to Device Config, then Basic, create or edit your guest SSID, enable the Authentication toggle, and select Captive Portal as the mode. Ruijie's JaCS platform, which is their hospitality-focused management system, supports Hotel and Other scenarios and gives you a drag-and-drop portal builder with login options including one-click access, voucher codes, and account-based login. This is the right choice for smaller deployments - a single hotel, a boutique retail site, or a conference centre that wants a quick, branded splash page without external dependencies. Model two is the external captive portal via WISPr and RADIUS. This is the enterprise-grade approach, and it is what you need when you want to integrate Ruijie with a third-party guest WiFi intelligence platform - like Purple. Here, you navigate to Auth and Account in the Ruijie interface, select Captive Portal, set the Policy Mode to External, and point the Portal Server URL at your external platform. You then configure a RADIUS server group with the credentials your platform provides. The WISPr protocol handles the redirect and authentication handshake between the Ruijie gateway and the external portal. This model scales across hundreds of sites, gives you centralised analytics, and lets you run GDPR-compliant data capture workflows. Model three is standalone AP mode. Ruijie's Reyee access points running ReyeeOS version 1.219 or later can run a local captive portal without a gateway, which is useful for temporary deployments or small sites without an EG router. Now, the critical piece that most guides skip: VLAN isolation. When you create a guest SSID on Ruijie, you have two forwarding options - NAT mode and VLAN mode. NAT mode is simpler. The gateway assigns guest devices addresses from a dedicated pool, typically 192.168.23.0 slash 24 by default, and all guest traffic is NATted to the internet. This works, but it gives you less control. VLAN mode is the right choice for any serious deployment. You assign the guest SSID to a dedicated VLAN - say VLAN 100 - and use ACLs on the gateway to block guest traffic from reaching your corporate VLAN. The CLI command pattern looks like this: you create an extended access list, deny IP traffic from your guest subnet to your corporate subnet, permit everything else, and apply that access list inbound on the guest BVI interface. This is the same principle you would apply on Cisco Meraki, HPE Aruba, or Ruckus - Ruijie just has its own CLI syntax. Security standards matter here. Ruijie supports WPA3-Personal and WPA2/WPA3 mixed mode on guest SSIDs. For a guest network where you want zero-friction access, you typically run an open SSID with captive portal authentication rather than a pre-shared key. The captive portal becomes your authentication layer. If you need stronger security - say for a healthcare or financial services environment - you can layer IEEE 802.1X on top, using EAP-TLS or PEAP with a RADIUS server for certificate-based or credential-based authentication. Ruijie's RG-WS series controllers support full 802.1X with dynamic VLAN assignment, meaning you can push different VLANs to different user groups based on RADIUS attributes. The walled garden - or allowlist - is another area that trips people up. Before a guest authenticates through the captive portal, their device can only reach domains you explicitly whitelist. At minimum, you need to allow your portal platform's domain and IP address, any social login providers you are using, and Apple's captive portal detection endpoint, which is captive.apple.com. Miss that last one and iOS devices will show a broken portal experience. You configure the allowlist in Ruijie Cloud under Auth and Account, then Allowlist. IMPLEMENTATION RECOMMENDATIONS AND PITFALLS - 2 minutes Let me give you the four decisions that determine whether your Ruijie guest WiFi deployment succeeds or fails. Decision one: native portal versus external platform. If you are running more than five sites, or if you need to capture first-party data for marketing, use an external platform. Purple, for example, operates as a hardware-agnostic cloud overlay across 80,000-plus live venues. You point your Ruijie gateway at Purple's portal URL, configure the RADIUS credentials, and you get centralised analytics, GDPR-compliant data capture, and CRM integrations - all without touching the Ruijie hardware again. Purple has processed 440 million logins in 2024 alone and holds ISO 27001 certification, so the compliance piece is handled. Decision two: NAT versus VLAN. Always use VLAN mode for production deployments. NAT mode is fine for a proof of concept, but VLAN mode gives you proper Layer 3 isolation, easier firewall policy management, and the ability to apply QoS policies per VLAN. Decision three: bandwidth management. Ruijie's EG gateways have built-in QoS controls. Set per-user download and upload limits on the guest SSID - typically two to five megabits per second download for a standard guest network. This prevents a single guest streaming 4K video from degrading the experience for everyone else. If you are using an external platform, disable Client Escape on the Ruijie side to ensure the platform's bandwidth controls take effect correctly. Decision four: session timeout and re-authentication. Set a sensible session timeout - eight to 24 hours for hospitality, shorter for retail or events. Ruijie lets you configure this per portal policy. Pair it with a post-login redirect URL so guests land on your venue's website or a promotional page after connecting. The most common pitfall I see is teams deploying a captive portal without testing it on iOS and Android simultaneously. Apple and Google both have captive portal detection mechanisms that behave differently. Test both before go-live. The second most common pitfall is forgetting to synchronise the portal configuration to the EG product in JaCS - there is an explicit Synchronise button you must click after creating or editing a portal, otherwise the gateway does not pick up the changes. RAPID-FIRE Q AND A - 1 minute Let me run through the questions I get asked most often. Can Ruijie APs run a captive portal without a gateway? Yes, on ReyeeOS 1.219 or later, but functionality is limited compared to gateway-based deployments. Does Ruijie support 802.1X for guest networks? Yes, the RG-WS series controllers support full 802.1X with dynamic VLAN assignment via RADIUS. Can I integrate Ruijie with Purple? Yes. Configure the external captive portal mode, point the portal URL at Purple's endpoint, set up the RADIUS server group with Purple's credentials, and add Purple's domains to the allowlist. Purple's hardware-agnostic architecture handles the rest. Does WPA3 work with captive portals? Yes. You run an open SSID for the captive portal flow. WPA3 applies to authenticated SSIDs. For guest networks, the portal itself is the authentication layer. SUMMARY AND NEXT STEPS - 1 minute To summarise: Ruijie Networks gives you a capable, flexible platform for guest WiFi and captive portal deployment. The three deployment models - native cloud portal, external RADIUS-based portal, and standalone AP - cover everything from a single-site boutique hotel to a multi-site retail chain. The key decisions are VLAN isolation over NAT, external platform for any multi-site or data-capture use case, and proper walled garden configuration to avoid iOS authentication failures. Your next steps: audit your current Ruijie firmware versions to confirm ReyeeOS compatibility, decide whether you need native or external portal management, and if you are running more than five sites or need analytics, speak to Purple about integrating their platform with your Ruijie infrastructure. You can find Purple's integration documentation and request a demo at purple.ai. Thanks for listening. We will see you in the next briefing.

header_image.png

執行摘要

在 Ruijie Networks 硬體上設定訪客 WiFi 和 Captive Portals,需要對該平台的架構有清晰的理解,特別是原生雲端入口網站與外部 RADIUS 整合之間的選擇。本技術參考指南為 IT 經理、網路架構師和場域營運總監提供了使用 Ruijie RG-WS 控制器和 Reyee EG 閘道器部署安全、隔離且具擴充性之訪客網路的確切步驟。我們將介紹從基本 NAT 轉發到強大 VLAN 隔離的過渡、透過 WISPr 設定外部 Captive Portals,以及整合如 Purple 等第三方平台以獲取第一方數據並推動收益。無論您是管理單一飯店還是多據點的零售物業,本指南都能提供建立合規且高效能無線網路所需的實用、不限特定廠商的設定步驟。

技術深度解析

Ruijie Networks 提供強大的企業級無線架構,支援多種訪客存取部署模式。對於任何網路架構師而言,核心決策在於選擇合適的驗證流程與隔離策略。

Captive Portal 部署模式

Ruijie 支援三種不同的 Captive Portal 部署模式,各自適用於不同的營運需求:

  1. 原生雲端入口網站 (Ruijie JaCS):內建的 Ruijie Cloud 平台(特別是針對旅宿業的 JaCS 介面)提供了拖放式入口網站建置工具。此模式在「Device Config」(裝置設定)下進行設定,其中 SSID 驗證設定為 Captive Portal。它支援基本的登入選項,包括一鍵存取和憑證代碼(Voucher)。這適用於不需要深度分析或外部 CRM 整合的單一場域。
  2. 外部 Captive Portal (WISPr/RADIUS):對於企業級部署、多據點零售和大型公共場所,外部入口網站模式是必不可少的。此方法使用 WISPr 協定將訪客流量重導向至如 Purple 等第三方平台。驗證是透過使用 PAP 加密的外部 RADIUS 伺服器群組進行處理。此模式可實現進階數據收集、GDPR 合規性管理,以及與現有行銷工具鏈的無縫整合。
  3. 獨立 AP 入口網站:執行 ReyeeOS 1.219 或更新版本的 Ruijie Reyee 無線基地台支援本地化的 Captive Portal,無需 EG 閘道器。這是臨時部署的備用方案,但缺乏基於控制器架構的強大 QoS 和隔離功能。

architecture_overview.png

網路隔離:NAT 與 VLAN

最關鍵的架構決策是如何將訪客流量與企業網路隔離。Ruijie 為訪客 SSID 提供兩種轉發模式:

  • NAT 模式:閘道器從專用位址池(預設為 192.168.23.0/24)分配 IP 位址,並在將流量路由到網際網路之前進行網路位址轉換(NAT)。雖然部署簡單,但此方法在 Layer 3 對訪客流量的能見度與控制力有限。
  • VLAN 模式:推薦的企業標準。訪客 SSID 被對應到專用 VLAN(例如 VLAN 100)。Reyee EG 閘道器或 RG-WS 控制器使用存取控制清單(ACL)來執行嚴格的隔離。必須設定擴充 ACL 以拒絕從訪客子網路到企業子網路的 IP 流量,同時允許向外的網際網路存取。此方法符合 Enterprise WiFi Security: A Complete Guide for 2026 的原則。

Walled Garden 設定

在訪客完成 Captive Portal 驗證之前,其裝置會處於受限狀態。必須設定 Walled Garden(或白名單)以允許存取基本服務。如果您使用外部平台,則必須新增該平台的網域、IP 位址以及任何社群登入提供者(例如 Facebook 或 Google)的驗證端點。至關重要的是,您必須包含 captive.apple.com,以確保 iOS 裝置能正確觸發 Captive Portal 迷你瀏覽器。

captive_portal_flow.png

實作指南

在 Ruijie 硬體上部署外部 Captive Portal 需要對 SSID、驗證原則和網路隔離層進行精確設定。請按照以下步驟將 Ruijie 與如 Purple 等外部平台進行整合。

步驟 1:設定訪客 SSID 與 VLAN

  1. 登入 Ruijie Cloud 或控制器的本機 eWeb 介面。
  2. 導覽至「Wireless Settings」(無線設定),並為您的場域建立一個命名合適的 SSID。
  3. 將「Security Mode」(安全性模式)設定為「Open」(開放)。Captive Portal 將作為驗證機制。
  4. 將 SSID 指派給您指定的訪客 VLAN。確保您的 EG 閘道器上已設定對應的 VLAN 介面與 DHCP 範圍。

步驟 2:設定外部 Captive Portal 原則

  1. 導覽至「Auth & Account」(驗證與帳戶)區段。
  2. 在「Authentication」(驗證)選單下選擇「Captive Portal」。
  3. 建立新原則,並將「Policy Mode」(原則模式)設定為「External」(外部)。
  4. 選擇您在步驟 1 中建立的訪客 SSID。
  5. 輸入由您的外外部平台(例如 Purple 的 portal 端點)。
  6. 使用您平台提供的 IP 位址、連接埠(通常驗證為 1812,計費為 1813)以及共用金鑰來設定 RADIUS 伺服器群組。

步驟 3:實作 Walled Garden

  1. 在「驗證與帳戶」(Auth & Account)區段中,找到「允許清單」(Allowlist)設定。
  2. 新增外部平台所需的網域和 IP 位址。
  3. 新增您計劃使用的任何社群身分驗證提供商的網域。
  4. 確保允許標準的 Captive Portal 偵測網域。

步驟 4:強制執行 ACL 隔離

連線至您的 Ruijie 閘道器或控制器的命令列介面(CLI)以設定隔離 ACL。此步驟可確保訪客無法存取內部資源。

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

最佳做法

為確保可靠且安全的訪客 WiFi 體驗,請遵循以下產業標準的最佳做法:

  • 使用外部驗證以進行擴充:如果您管理多個場域或需要詳細的 訪客 WiFi 分析,請繞過原生 portal 並使用外部 RADIUS 整合。像 Purple 這樣的平台提供與硬體無關的管理,讓您能夠在 Ruijie、Cisco Meraki、HPE Aruba 和 Ruckus 硬體上標準化訪客體驗。
  • 實施分級頻寬:使用 Ruijie EG 閘道器上的 QoS 功能來強制執行單一使用者頻寬限制。提供免費的基本層級(例如 5 Mbps),並透過您的外部 portal 與金流閘道整合,以提供付費的高速層級。這能為您的基礎設施創造直接的營收來源。
  • 同步設定:使用 Ruijie JaCS 平台時,修改 Captive Portal 策略後,您必須明確點擊「同步」(Synchronise)按鈕。若未執行此操作,EG 閘道器將無法接收更新後的設定,從而導致 portal 行為不一致。
  • 遵守資料隱私法規:確保您的 Captive Portal 包含針對行銷傳播的明確、自主選擇同意(opt-ins)。使用 Purple 時,平台會自動處理 GDPR 和 CCPA 合規性,提供安全的資料隱私層。請參閱 網路管理員的 GDPR 與訪客資料隱私合規指南 以瞭解詳細需求。

疑難排解與風險緩解

即使經過仔細設定,Captive Portal 部署仍可能會遇到問題。以下是常見的故障模式及其解決方法:

  • iOS 裝置無法顯示 Portal:這幾乎總是 Walled Garden 的問題。Apple 裝置會檢查 captive.apple.com 以判斷它們是否位於 portal 後方。如果此網域被封鎖,裝置會判定其擁有完整的網際網路存取權限,且無法啟動 Captive Network Assistant。請驗證您的允許清單設定。
  • 訪客無法透過 RADIUS 進行驗證:檢查 Ruijie 閘道器上的 RADIUS 共用金鑰和連接埠設定。確保閘道器的公用 IP 位址已正確註冊至您的外部平台。使用 Ruijie 診斷工具來驗證 RADIUS 的連通性。
  • 頻寬限制被忽略:如果您使用外部平台來強制執行頻寬分級,則必須停用 Ruijie 閘道器上的 Client Escape 功能。如果啟用了 Client Escape,閘道器可能會繞過外部平台的 QoS 指令。
  • 訪客流量到達企業網路:審查您的 ACL 設定。確保擴充存取清單已套用至正確 VLAN 或 BVI 介面的輸入(inbound)方向。透過將裝置連線至訪客 SSID 並嘗試 ping 已知的內部 IP 位址來測試隔離情況。

投資報酬率(ROI)與商業影響

在 Ruijie 硬體上部署強大的 Captive Portal,可將訪客 WiFi 從沉沒成本轉化為可衡量的商業資產。透過整合像 Purple 這樣的外部 WiFi 分析 平台,場域可以獲得顯著的回收。

  • 第一方數據獲取:Captive Portal 是主要的數據收集點。透過提供免費 WiFi 以換取電子郵件地址或社群登入,場域能建立豐富的客戶輪廓資料庫。這些數據可助力精準行銷活動,從而提高客戶終身價值。
  • 營運效率:透過 Ruijie Cloud 和 Purple 進行集中式雲端管理,可減少 IT 團隊排查本地網路問題所花費的時間。重疊網路(overlay)與硬體無關的特性,意味著您可以升級或更換無線基地台(AP),而無需重建整個分析架構。
  • 直接產生營收:實施分級頻寬模式可讓場域直接將網路變現。例如,AGS Airports 實施了分級 WiFi 策略,並獲得了 842% 的投資報酬率。
  • 提升訪客體驗:無縫且具品牌特色的登入體驗可提高客戶滿意度。在 旅宿業零售業 等產業中,可靠的連線是基本期望;安全地提供連線能建立品牌信任度。

關鍵定義

Captive Portal

A web page that a user of a public access network is obliged to view and interact with before access is granted.

The primary mechanism for authenticating guests and capturing first-party data on a Ruijie wireless network.

RADIUS

Remote Authentication Dial-In User Service. A networking protocol that provides centralized Authentication, Authorization, and Accounting management.

Used to securely connect Ruijie gateways to external platforms like Purple for guest authentication.

Walled Garden

An allowlist of domains and IP addresses that a guest device can access before completing the captive portal authentication.

Essential for allowing social login providers and captive portal detection mechanisms (like Apple's CNA) to function.

VLAN Isolation

The practice of assigning guest traffic to a separate Virtual Local Area Network and using Access Control Lists to prevent communication with internal corporate networks.

The standard security posture for enterprise guest WiFi deployments on Ruijie hardware.

WISPr

Wireless Internet Service Provider roaming. A protocol that allows users to roam between different wireless providers, often used to handle the redirect to external captive portals.

The underlying mechanism Ruijie uses when the captive portal policy is set to External mode.

Ruijie JaCS

Ruijie's cloud management platform specifically tailored for hospitality and hotel scenarios, offering native captive portal building tools.

Used for managing single-site deployments that do not require external data capture platforms.

Reyee EG Gateway

Ruijie's line of enterprise security routers that handle routing, firewall policies, and captive portal redirection for the wireless network.

The central hardware component where ACLs and RADIUS configurations are applied in a Ruijie deployment.

Client Escape

A feature on Ruijie gateways that, if enabled, can allow clients to bypass certain QoS or portal restrictions.

Must be disabled when using an external platform to enforce tiered bandwidth limits.

範例

A 200-room hotel deploying Ruijie RG-AP access points and an EG gateway needs to provide free guest WiFi while capturing email addresses for their marketing database. They also require strict isolation from their property management system (PMS) network.

The IT team configures a new Open SSID assigned to VLAN 100. On the EG gateway, they configure an extended ACL to deny traffic from VLAN 100 to the PMS VLAN, applying it inbound on the guest interface. They set the captive portal policy to External mode, pointing the Portal Server URL to Purple's platform. They configure the RADIUS server group with Purple's credentials and add Purple's domains to the allowlist. The Purple platform handles the branded splash page and email capture workflow.

考官評語: This approach correctly uses VLAN isolation instead of basic NAT, ensuring security for the PMS. By leveraging an external portal via RADIUS, the hotel gains GDPR-compliant data capture capabilities that the native Ruijie portal cannot provide at an enterprise level.

A retail chain with 50 locations is rolling out Ruijie hardware. Customers report that when they connect to the guest WiFi on their iPhones, the login screen does not appear automatically, forcing them to open a browser manually.

The network administrator logs into Ruijie Cloud, navigates to Auth & Account, and opens the Allowlist configuration. They add 'captive.apple.com' to the walled garden list and synchronise the configuration to all EG gateways across the estate.

考官評語: This resolves the classic Captive Network Assistant (CNA) failure. iOS devices require access to specific Apple endpoints to trigger the automatic portal pop-up. Adding this to the walled garden is a mandatory step for any captive portal deployment.

練習題

Q1. You are deploying Ruijie WiFi across a stadium. You need to capture fan data for marketing and enforce a 5 Mbps bandwidth limit per user. Should you use the native Ruijie portal or an external platform, and how do you enforce the bandwidth?

提示:Consider the scale of the deployment and the data capture requirements.

查看標準答案

You must use an external platform like Purple for the data capture and marketing integration. To enforce the bandwidth, configure the QoS settings on the Ruijie EG gateway for the guest SSID, and ensure the Client Escape feature is disabled so the external platform's policies are respected.

Q2. A client complains that their guest network is insecure because the SSID is set to 'Open'. They ask you to implement a pre-shared key (WPA2-Personal) alongside the captive portal. How do you advise them?

提示:Consider the user experience and the purpose of the captive portal.

查看標準答案

Advise the client that for public guest networks, adding a pre-shared key introduces unnecessary friction without significantly improving security, as the key must be shared publicly anyway. The captive portal itself serves as the authentication and authorization layer. For true security, WPA3-Enterprise with 802.1X should be used, but this is rarely suitable for public guest access.

Q3. After configuring a new external captive portal policy on Ruijie Cloud and pointing it to Purple, guests are still seeing the default Ruijie login page. What is the most likely cause?

提示:Think about the configuration deployment process in the Ruijie interface.

查看標準答案

The administrator likely saved the configuration in Ruijie Cloud but failed to click the Synchronise button. The configuration has not been pushed down to the local EG gateway, so it is still serving the default local portal.