Ruckus captive portal 疑難排解：WISPr 重新導向、熱點與 walled garden 檢查清單

大多數 Ruckus Captive Portal 故障可歸因於五個方面：熱點 (WISPr) 登入 URL 與起始頁面、未為門戶及其資產配置的 Walled Garden 條目、不匹配的 Northbound Portal 介面密碼、RADIUS 驗證或計費失敗，以及 HTTPS 重新導向憑證警告。請依此順序檢查，並利用 SmartZone、Ruckus One 或 Unleashed 上的用戶端事件歷史記錄。

損壞的 Ruckus Captive Portal 是什麼樣子？

Ruckus 熱點服務使用 WISPr (無線網際網路服務供應商漫遊)。這是一個控制器將未經驗證的訪客保留在 Captive Portal 後方，直到外部系統核准的架構。Captive Portal 是訪客在連上網際網路前完成的歡迎頁面。當此鏈條中斷時，訪客會看到以下六種症狀之一：

• 完全沒有重新導向。 裝置加入 SSID 並取得 IP 位址，但未出現登入提示，且瀏覽器逾時。
• 空白或僅載入一半的歡迎頁面。 提示已開啟，但標誌、字型、指令碼或社群登入按鈕無法載入。
• 門戶前出現憑證警告。 瀏覽器顯示「您的連線不是安全連線」或類似訊息，訪客必須點擊才能繼續。
• 登入迴圈。 訪客填寫完表單後，又回到歡迎頁面，但仍然處於離線狀態。
• 沒有提示，但也沒有網際網路。 裝置報告已上線，因此 Captive Network Assistant 從未開啟。
• 已上線，但無工作階段資料。 訪客正常瀏覽，但登入和工作階段持續時間從未進入您的報表。

最後兩個症狀很容易被忽略，因為沒有人會打電話給客服台。您通常是在事後發現訪客資料停止增長時才注意到。

什麼原因通常導致 Ruckus Captive Portal 失敗？

先瞭解運作順序會很有幫助。Purple 的 Captive Portal 支援文章 對此進行了詳細說明。控制器管理 WiFi 與 Purple 歡迎頁面伺服器之間的互動。這些伺服器收集訪客的詳細資訊並發行一次性登入。接著，控制器將該登入傳遞給 Purple 的 RADIUS 伺服器以完成存取。RADIUS (遠端用戶撥入驗證服務，RFC 2865) 是用於驗證該工作階段的協定。RADIUS 計費 (RFC 2866) 隨後會報告該工作階段。

每個步驟都有其專屬的失敗模式。

熱點服務重新導向與起始頁面設定

熱點服務包含外部登入 URL 和起始頁面。登入 URL 是未驗證訪客被導向的地方。起始頁面是訪客登入後抵達的位置。打字錯誤、門戶變更後失效的 URL，或是 WLAN 附加了錯誤的熱點服務，都會阻止重新導向。指向被封鎖或已停用 URL 的起始頁面，會讓成功的登入看起來像失敗一樣。

Walled Garden 遺漏

Walled garden（圍牆花園）是未驗證的訪客在登入前可以存取的目的地清單。它必須包含 Portal 主機名稱以及 Splash Page 載入資源的每個主機。它還必須包含您所提供的任何社群或單一登入身分識別提供者的網域。如果您新增了登入選項，請閱讀 如何啟用單一登入 並新增該提供者的網域。只要遺漏一個資源主機，就會導致頁面載入不完整。

相反的錯誤也會造成問題。根據 Purple 的支援文章，裝置會透過檢查預定義的網域名稱來測試連線能力。如果該探測網域位於 Walled garden 中，裝置就會認為它已上線，因而永遠不會出現提示，使訪客處於無法連線的狀態。

Northbound portal interface 認證

在 SmartZone 上，Northbound portal interface 是外部 Portal 用來告訴控制器訪客已登入的方式。Portal 會使用控制器上設定的密碼向該介面進行驗證。如果該密碼僅在其中一端變更，Portal 就無法授權任何人。訪客填寫完表單後，會重新回到 Splash Page 並不斷循環。

RADIUS 驗證與計費

控制器會將一次性登入轉發給 RADIUS。如果共用金鑰不同、無法連線至 RADIUS 伺服器，或請求來自伺服器無法識別的位址，驗證就會失敗。計費失敗的影響較不明顯。訪客可以上線，但工作階段的開始和結束記錄永遠不會送達。

HTTPS 重新導向行為

現代瀏覽器預期透過 HTTPS 載入登入頁面。Purple 的 Cisco WLC 憑證文章 說明了這對 Cisco 控制器的影響。重新導向至控制器位址的 HTTP 會觸發安全性警告，訪客必須點擊才能通過。解決方法是使用一個公開信任的憑證，其主旨名稱（Common Name）必須與控制器的網頁驗證主機名稱相符。當您在 Ruckus 控制器上啟用 HTTPS 重新導向時，也適用相同的原理。憑證過期或名稱不符都會使警告再次出現。

如何找出是哪一個原因造成的？

請從症狀開始著手，而不是從設定開始。下表將每種症狀對應至最可能的原因以及您應該首先查看的地方。

症狀	最可能的原因	首先查看的地方	首次檢查
無登入提示，瀏覽器逾時	熱點登入 URL 錯誤，或 WLAN 上的熱點服務錯誤	熱點 (WISPr) 服務與 WLAN 設定	在測試裝置上開啟 neverssl.com 並查看其導向至何處
Splash Page 載入，但沒有圖片或按鈕	Walled garden 中遺漏資源或身分識別提供者主機	Walled garden 清單	在筆記型電腦上載入 Portal，並在瀏覽器開發者工具中列出每個被封鎖的主機
裝置顯示已上線、無提示、無網際網路	連線探測網域位於 Walled garden 中	Walled garden 清單	移除寬鬆的萬用字元項目並重新測試
進入 Portal 頁面前顯示憑證警告	在沒有受信任且相符的憑證下進行 HTTPS 重新導向	控制器憑證設定	比較憑證名稱和到期日與重新導向的主機名稱
表單填寫完成後，訪客陷入循環	北向 Portal 介面密碼不相符	北向介面設定與 Portal 整合	確認雙方的密碼相符
填寫表單後登入遭拒	RADIUS 共用密鑰或來源地址不相符	RADIUS 驗證服務和用戶端事件	尋找驗證逾時或遭拒絕的記錄
訪客已上線，但無工作階段資料	RADIUS 計費設定錯誤或未附加	WLAN 上的 RADIUS 計費服務	確認已啟用計費功能並指向正確的伺服器

在乾淨的裝置上重現問題

在測試用的手機和測試用的筆記型電腦上清除該 SSID，然後重新連線。如果沒有彈出提示，Purple 的支援文章建議瀏覽 neverssl.com。該網站可避免 SSL 重新導向問題，因此能顯示重新導向本身是否正常運作。

讀取用戶端的事件

每個 Ruckus 平台都會保留用戶端事件歷程記錄。在 SmartZone 上，請使用事件與警報記錄以及用戶端的連線歷程記錄。在 Ruckus One 上，請開啟用戶端並檢視其事件。在 Unleashed 上，請檢查該用戶端 MAC 地址的事件記錄。尋找三件事：用戶端是否已關聯、是否已重新導向，以及 RADIUS 是接受還是拒絕。該順序會告訴您鏈結中的哪一個環節中斷了。

如何在 SmartZone、Ruckus One 和 Unleashed 上解決此問題？

這三個平台的解決步驟順序相同。選單有所不同，因此請參考適用於您版本的 Ruckus 文件，以及 Captive Portal 支援文章 以取得 Purple 的數值。

SmartZone

確認 WLAN 使用了您預期的熱點 (WISPr) 服務，且其登入 URL 與整合項目相符。請根據目前的清單重新建立 Walled Garden (圍牆花園)，而不要憑記憶建立。檢查北向 Portal 介面密碼是否與為 Portal 設定的密碼相符。然後確認 RADIUS 驗證和計費服務均指向正確的伺服器，且具有正確的共用密鑰。

Ruckus One

Ruckus One 會集中管理相同的 WISPr 元素。檢查訪客網路的 Portal 提供者設定、Walled Garden (圍牆花園) 和 RADIUS 服務。場域層級 (venue-level) 的覆寫設定特別需要注意，因為某個場域可能會偏離應用於其他所有地方的範本。

Unleashed

Unleashed 在基地台上執行控制器功能，因此請檢查該主要 AP 上的熱點服務。請注意 Walled Garden (圍牆花園) 和 RADIUS 設定，並確認熱點服務已附加到訪客 WLAN。

排除類似的故障錥誤

有些投訴看起來像是 Portal 故障，但其實不然。如果訪客在無線基地台（AP）之間移動時被重複要求登入，請閱讀 解決企業 WLAN 中的漫遊問題。如果連線在 5GHz 頻道上無故中斷，那麼 DFS 雷達事件診斷清單 會是更好的著手點。

這在實際場域中看起來如何？

以下兩個情境僅供說明之用。它們展示了解決方法，而非回報特定的實際部署案例。

情境 1：進行 Splash Page 重新設計後的擁有 200 間客房的飯店

狀況。 行銷團隊重新推出了飯店的 Splash Page。隔天早上，前台回報訪客只看到一個帶有單一表單欄位的空白頁面。

採取的行動。 工程師在筆記型電腦上載入 Portal，並在瀏覽器的開發者工具中列出被阻擋的要求。新設計從一個未加入 SmartZone Walled Garden（圍牆花園）的主機載入字型和圖片。工程師將該主機加入，重新連接測試手機與測試筆記型電腦，並確認兩者都能完整呈現頁面。

結果。 首次重新測試時，兩台測試裝置上都完整呈現了 Splash Page。此修正僅需新增一個 Walled Garden 項目，用戶端事件顯示訪客已再次通過重新導向與 RADIUS 認證。如需深入了解此產業的訪客體驗，請參閱適用於 飯店 的 Purple。

情境 2：進行控制器移轉後的擁有 40 家分店的零售連鎖店

狀況。 某零售商將其門市移轉至新的 SmartZone 叢集。顧客仍然可以上網，但訪客報告顯示所有 40 家門市的新連線工作階段數量皆為零。

採取的行動。 用戶端事件顯示 RADIUS 驗證成功，但沒有任何帳務記錄（accounting records）。帳務服務未綁定至新叢集上的訪客 WLAN。工程師將其綁定，並確認共享金鑰（shared secret）相符。

結果。 所有 40 家門市的工作階段記錄重新出現。顧客未受到任何干擾，因為受到影響的只有報告功能。請參閱適用於 零售業 的 Purple，了解這些工作階段資料如何轉化為顧客洞察。

如何防止 Ruckus Captive Portal 故障再次發生？

大多數重複發生的故障源自於變更，而非硬體損壞。以下五個習慣可防止故障發生：

1. 將 Walled Garden 視為受控文件。 記錄每一個項目、其擁有者及存在的原因。每當 Splash Page 變更時，即對其進行審查。
2. 同時輪替雙方的金鑰。 在單一變更視窗內同時變更 Northbound Portal 介面密碼和 RADIUS 共享金鑰，絕不要只變更單一側。
3. 追蹤憑證過期時間。 在 HTTPS 重新導向憑證過期前做好更新時程規劃，並在更新後重新確認名稱是否相符。
4. 每次變更後進行測試。 在 iPhone、Android 手機、Windows 筆記型電腦和 macOS 筆記型電腦上執行相同的檢查。不同的作業系統處理 Captive Network Assistant 的方式各不相同。
5. 每日觀察工作階段數量。 您的 WiFi 分析中若突然降至零，即表示在任何顧客抱怨之前，計費階段就已發生問題。

如 Purple 的支援文章所建議，請保持訪客網路處於開放狀態。開放網路是標準的慣例，而熟悉的行為能減少登入時的摩擦。對於乘客在移動中連線的交通運輸營運商，同樣的檢查也適用；請參閱 Purple 火車與列車 解決方案。

常見問題解答

Purple 是否支援 Ruckus SmartZone、Ruckus One 以及 Unleashed？

是的，Purple 訪客 WiFi 作為外部 Captive Portal 運行於 Ruckus 熱點 (WISPr) 服務上。Purple 支援各種硬體，也適用於 Cisco Meraki、HPE Aruba、Juniper Mist、Ubiquiti UniFi、Cambium、Extreme 與 Fortinet。控制器負責處理重定向與 RADIUS，而 Purple 則託管歡迎頁面並對訪客進行驗證。設定值與步驟可在 Purple 的 Captive Portal 支援文章中找到。

我們需要新的存取點才能將 Purple 新增至現有的 Ruckus 網路中嗎？

不需要，Purple 是以雲端覆蓋 (cloud overlay) 的方式運行於您現有的 Ruckus 存取點和控制器上。您只需在控制器上設定熱點服務、Walled Garden 以及 RADIUS 設定，然後將訪客 WLAN 指向 Purple 即可。現場無需更換任何硬體。大部分的工作在於上線前測試 iOS、Android、Windows 和 macOS 裝置上的重定向。

我們能否在不影響訪客的情況下，將內建的 Ruckus 訪客入口網站轉移到 Purple？

可以，只要您先在獨立的測試 WLAN 上建立 Purple 設定即可。在您目前的線上訪客網路旁，設定熱點服務、Walled Garden 和 RADIUS 服務，並在測試裝置上確認完整登入。確認運作正常後，在離峰時段將新的熱點服務連結到線上的 WLAN。訪客只會看到新的歡迎頁面，而不會遇到服務中斷。

Purple 如何處理透過 Ruckus Captive Portal 收集的訪客資料？

Purple 透過歡迎頁面上訪客自主選擇的同意加入來收集第一方資料。Purple 已通過 ISO 27001 與 Cyber Essentials 認證，並符合 GDPR 與 CCPA 的規定。Ruckus 控制器不儲存任何行銷資料，它只會傳送單次登入資訊至 Purple 的 RADIUS 伺服器，因此訪客詳細資訊會保留在 Purple 通過認證的平台內，而不會散布到各個場域的控制器中。

使用 Purple 部署 Ruckus Captive Portal 需要多久時間？

單一場域通常可在一個工作階段內設定完成，因為無需進行硬體變更。控制器需要設定熱點服務、Walled Garden 以及 RADIUS 驗證與計費。多場域的資產則需要較長時間，這主要是用於測試與變更控制，而非設定本身。在 Ruckus One 或 SmartZone 上，從中央套用範本可確保每個場域保持一致，並降低各場域間設定產生偏差的風險。

Purple 的訪客 WiFi 平台被證實可達到何種規模？

根據 Purple 的內部公司數據，Purple 已在超過 80,000 個實際場域中運行，並在 2024 年記錄了 4.4 億次登入。這些場域涵蓋餐飲旅宿、零售、交通、教育和公共部門。Purple 自 2012 年起開始營運，無論底層網路是由哪家支援的硬體廠商運行，每一次部署都使用本指南中說明的相同 Splash Page 和 RADIUS 流程。