MikroTik RouterOS Captive Portal 与 Purple WiFi 集成指南
本技术指南提供了将 MikroTik RouterOS 与 Purple 的 WiFi 平台集成的分步说明。内容涵盖访客 WiFi Captive Portal 配置、员工 WiFi 802.1X 身份验证,以及使用私有 PSK 进行动态 VLAN 细分的多租户 WiFi。
收听本指南
查看播客转录

执行摘要
将 MikroTik RouterOS 与 Purple 集成,可在访客、员工和多租户环境中创建一个统一的、由身份驱动的网络。本指南提供了在 MikroTik 硬件上部署 Purple 云覆盖所需的具体配置逻辑。您将学习如何配置 RouterOS 热点网关以进行 访客 WiFi 重定向、实施用于安全员工 WiFi 的 IEEE 802.1X,以及部署私有预共享密钥 (PPSK) 以隔离多租户 WiFi 流量。
通过遵循这些部署模型,您可以在安全细分网络的同时,收集用于 WiFi 分析 的第一方数据。Purple 在 2024 年处理了 4.4 亿次登录,可用性达 99.999%,这使得该架构非常适合 零售 、 酒店 和 交通 等高密度环境。
技术深挖
访客 WiFi:Captive Portal 与围墙花园
MikroTik 热点网关拦截未通过身份验证的 HTTP 流量,并将其重定向到 Purple 托管的 Captive Portal。Purple 充当 RADIUS 服务器,处理身份验证和会话管理。
为确保 Captive Portal 正确加载,您必须配置围墙花园。这允许在身份验证前访问 Purple 的欢迎页面域名、内容分发网络 (CDN) 和 OAuth 提供商(例如 Google Workspace 和 Microsoft Entra ID)。如果没有这些条目,重定向循环就会中断。
成功通过身份验证后,Purple 的 RADIUS 服务器会返回标准属性,包括用于强制执行连接限制的 Session-Timeout,以及可选的、用于直接从 Purple 控制面板强制执行带宽限制的 Mikrotik-Rate-Limit。
员工 WiFi:802.1X 身份验证
对于员工 WiFi,您可以通过部署 IEEE 802.1X 来消除共享密码。MikroTik 接入点充当认证器,将 EAP 凭据传递给 Purple 的 RADIUS 服务器。Purple 与 Microsoft Entra ID、Okta 和 Google Workspace 原生集成,通过 PEAP-MSCHAPv2 或 EAP-TLS 验证凭据。
当员工连接时,Purple 的 RADIUS 服务器可以返回 Mikrotik-Wireless-VLANID 属性。这会指示 MikroTik 路由器将通过身份验证的设备置于特定的 VLAN 上,从而通过单个 SSID 实现基于角色的网络细分。有关安全标准的更广泛概述,请参阅 企业 WiFi 安全:2026 年完整指南 。
多租户 WiFi:私有 PSK (PPSK)
多租户环境需要安全隔离,而无需 802.1X 的复杂性,因为许多消费级设备(例如智能电视和游戏机)并不支持它。MikroTik 通过基于 MAC 的 RADIUS 身份验证支持私有 PSK (PPSK)。
当设备连接到 SSID 时,MikroTik 路由器会将设备 MAC 地址发送给 Purple。Purple 会返回 Mikrotik-Wireless-Psk 属性(该租户的唯一密码)和 Mikrotik-Wireless-VLANID 属性。这种架构允许数百个租户共享单个 SSID,同时保持在完全隔离的网络气泡中。

实施指南
1. 配置 RADIUS 客户端
首先,在 RouterOS 中将 Purple 定义为 RADIUS 服务器。这适用于所有三个使用场景。
/radius
add address=YOUR-PURPLE-RADIUS-IP secret=YOUR-SHARED-SECRET service=hotspot,wireless authentication-port=1812 accounting-port=1813 timeout=3000ms
2. 访客 WiFi 热点设置
在您的访客 VLAN 接口上运行热点设置向导,然后在生成的配置文件上启用 RADIUS 身份验证。
/ip hotspot profile
set [ find default=yes ] use-radius=yes radius-accounting=yes
配置围墙花园以允许访问 Purple 的基础设施。
/ip hotspot walled-garden
add action=allow dst-host=*purple.ai
add action=allow dst-host=*purpleportal.net
3. 员工 WiFi 802.1X 设置
将无线安全配置文件配置为使用 WPA2-Enterprise 并将其指向 RADIUS 服务器。
/interface wireless security-profiles
add authentication-types=wpa2-eap eap-methods=passthrough mode=dynamic-keys name=staff-8021x radius-mac-authentication=no
确保启用网桥 VLAN 过滤以支持动态 VLAN 分配。
/interface bridge
set bridge1 vlan-filtering=yes
4. 多租户 PPSK 设置
对于 PPSK,在无线安全配置文件上启用 MAC 身份验证并配置 MAC 地址格式。
/interface wireless security-profiles
add authentication-types=wpa2-psk mode=dynamic-keys name=multi-tenant-ppsk radius-mac-authentication=yes radius-mac-format=XX:XX:XX:XX:XX:XX

最佳实践
- 统一使用 RouterOS 7:与 RouterOS 6 相比,通过无线 RADIUS 进行的动态 VLAN 分配在 RouterOS 7 中要健壮得多。
- 增加 RADIUS 超时时间:MikroTik 的默认 RADIUS 超时时间为 1100 毫秒。将其增加到 3000 毫秒,以防止由网络延迟引起的间歇性身份验证失败。
- 使用基于主机名的围墙花园条目:在配置围墙花园条目时,始终使用
dst-host代替dst-address,因为云基础设施的 IP 地址会发生变经常更改。 - 启用网桥 VLAN 过滤:通过 RADIUS (
Mikrotik-Wireless-VLANID) 进行的动态 VLAN 分配需要在网桥接口上设置vlan-filtering=yes。
故障排除与风险规避
如果 Captive Portal 无法加载,几乎可以肯定围墙花园配置不完整。使用 MikroTik Torch 工具监控访客 VLAN 上未认证客户端丢弃的 DNS 查询。将缺失的域名添加到围墙花园中。
如果 802.1X 客户端无法通过身份验证,请验证共享密钥并确保 RADIUS 客户端配置了 service=wireless。检查 Purple 控制面板日志,确认 Access-Reject 是源自 Purple 还是您的身份提供商。
如果客户端通过了身份验证但获取了错误的 IP 地址,请确认已启用网桥 VLAN 过滤,并且 DHCP 服务器已正确绑定到动态分配的 VLAN 接口。
投资回报率 (ROI) 与业务影响
在您的 MikroTik 基础设施中部署 Purple,可将成本中心转化为收入来源。通过捕获第一手数据,场所可以构建详细的数字化画像并实现自动化营销活动。例如,Avanti West Coast 通过利用回头客和追加销售机会,实现了 463% 的投资回报率。
此外,身份驱动的网络连接可减少 IT 开销。通过 Entra ID 自动办理员工 WiFi 的入职和离职流程,消除了手动密码管理的繁琐,而用于多租户 WiFi 的 PPSK 则允许物业经理在无需为每个单元部署专用硬件的情况下配置隔离的网络。
关键定义
热点网关
一种 RouterOS 功能,可拦截未通过身份验证的 HTTP 流量,并将其重定向到 Captive Portal 欢迎页面。
用于在允许访问互联网之前收集访客数据并强制执行服务条款。
围墙花园
未通过身份验证的用户可以访问的允许目标列表。
对于允许访客访问 Purple 欢迎页面、CDN 和 OAuth 提供商(如 Google)以完成登录过程至关重要。
802.1X
一种用于基于端口的网络访问控制的 IEEE 标准,为希望连接到 LAN 或 WLAN 的设备提供身份验证机制。
用于安全的员工 WiFi,允许通过 Entra ID 或 Okta 进行身份验证,而不是使用共享密码。
私有 PSK (PPSK)
一种安全架构,在单个 SSID 上使用多个唯一的预共享密钥,通常与特定的 MAC 地址和 VLAN 绑定。
非常适合多租户 WiFi,为住户及其消费级设备提供隔离的网络气泡。
RADIUS
远程用户拨号认证服务。一种提供集中式认证、授权和计费 (AAA) 管理的网络协议。
将 MikroTik 硬件连接到 Purple 云平台以进行身份验证的核心协议。
VLAN 过滤
一种 RouterOS 网桥设置,用于在网桥端口上强制执行 VLAN 标记和去标记规则。
必须启用此功能,通过 RADIUS 进行的动态 VLAN 分配才能正常工作。
CAPsMAN
受控接入点系统管理器。MikroTik 的集中式无线管理系统。
用于在多个接入点上部署一致的无线安全配置文件和 RADIUS 设置。
EAP-TLS
可扩展身份验证协议 - 传输层安全。一种需要客户端证书的高度安全的身份验证方法。
由 Purple 支持,适用于需要无密码身份验证的零信任员工 WiFi 部署。
应用实例
一家拥有 200 间客房的酒店需要在其 MikroTik 接入点上部署安全的员工 WiFi。他们希望财务员工位于 VLAN 10,运营员工位于 VLAN 20,并使用其现有的 Microsoft Entra ID 凭据。
- 在 Purple 控制面板中将 Purple 与 Microsoft Entra ID 集成。
- 配置 MikroTik RADIUS 客户端,使其指向 Purple 并设置
service=wireless。 - 创建一个
authentication-types=wpa2-eap的 MikroTik 无线安全配置文件。 - 在 MikroTik 网桥上启用
vlan-filtering=yes。 - 在 Purple 中,映射 Entra ID 的“Finance”组以返回
Mikrotik-Wireless-VLANID=10,映射“Operations”组以返回Mikrotik-Wireless-VLANID=20。
一家长租公寓(build-to-rent)的物业经理需要使用从 MikroTik CAPsMAN 广播的单个 SSID,为 50 个公寓提供隔离的 WiFi 网络。
- 为该 SSID 配置 MikroTik 无线安全配置文件,设置
authentication-types=wpa2-psk和radius-mac-authentication=yes。 - 确保 RADIUS 客户端配置为
service=wireless并指向 Purple。 - 在 Purple 控制面板中,注册住户设备的 MAC 地址。
- 在 Purple 中为每个公寓分配唯一的 PSK 和 VLAN ID。
- 当设备连接时,Purple 会返回
Mikrotik-Wireless-Psk和Mikrotik-Wireless-VLANID属性,将设备置于其隔离的网络气泡中。
练习题
Q1. 您已配置了 MikroTik 热点网关并将其指向 Purple 的 RADIUS 服务器。访客连接到 SSID,但他们的浏览器显示超时错误,而不是 Purple 欢迎页面。最可能的配置错误是什么?
提示:考虑在访客进行身份验证之前必须发生什么。
查看标准答案
围墙花园配置错误或缺少条目。如果不允许在 /ip hotspot walled-garden 中访问 Purple 的欢迎页面域名和相关 CDN,未通过身份验证的访客将无法加载登录页面,从而导致超时。
Q2. 一家零售连锁店希望使用 802.1X 和 Entra ID 部署员工 WiFi。他们配置了 `authentication-types=wpa2-eap` 并设置了 RADIUS 客户端。然而,身份验证失败。您检查 RADIUS 客户端配置,发现设置为了 `service=hotspot`。您该如何解决这个问题?
提示:不同的无线身份验证方法在 RouterOS 中需要不同的 RADIUS 服务类型。
查看标准答案
修改 RADIUS 客户端配置以包含 service=wireless。hotspot 服务类型仅用于 Captive Portal 身份验证。802.1X 和 MAC 身份验证需要 wireless 服务类型。
Q3. 您正在使用私有 PSK 部署多租户 WiFi。Purple 成功返回了 `Mikrotik-Wireless-Psk` 和 `Mikrotik-Wireless-VLANID` 属性,并且设备已连接。然而,该设备从默认管理子网获取了 IP 地址,而不是从隔离的租户子网。缺少什么 RouterOS 设置?
提示:动态 VLAN 分配需要网桥处理 VLAN 标签。
查看标准答案
网桥 VLAN 过滤已被禁用。您必须在网桥接口上设置 vlan-filtering=yes。否则,网桥将忽略 RADIUS 分配的动态 VLAN 标签,流量将回退到默认的未标记 PVID。
继续阅读本系列
CommScope Ruckus 与 Purple WiFi 集成:安装与配置指南
本技术参考指南为 CommScope Ruckus 架构与 Purple WiFi 的集成提供了权威的配置指南。它详细介绍了 Guest WiFi Captive Portal、通过 802.1X 实现的 Secure Staff WiFi 以及使用 Ruckus Dynamic PSK 实现的多租户网络隔离的逐步部署过程。
Allied Telesis 接入点与 Purple WiFi 集成
本指南为 Allied Telesis TQ 系列接入点与 Purple WiFi 的集成提供了全面的配置手册。内容涵盖外部 Captive Portal 重定向、802.1X RADIUS 身份验证,以及使用专用预共享密钥 (PPSK) 进行动态 VLAN 引导,以实现安全的多租户部署。
Grandstream GWN Access Points Integration with Purple WiFi
本权威技术参考指南详细介绍了如何将 Grandstream GWN 接入点与 Purple 的访客 WiFi 和分析平台进行集成。它涵盖了 Grandstream Captive Portal 配置、RADIUS AAA 设置、围墙花园(walled garden)设置、带有动态 VLAN 引导的安全员工 802.1X 认证以及多租户 PPSK 细分——为大规模部署访客和员工 WiFi 的 MSP 及 IT 团队提供可操作的逐步指导。