Ubiquiti UniFi 和访客 WiFi：配合 Purple 的 Captive Portal 设置

欢迎来到 Purple 技术简报。我是您的主持人，在接下来的十分钟里，我们将为将 Purple 的 WiFi 智能平台与 Ubiquiti UniFi 网络进行集成提供一份高级指南。这适用于需要切实可行指导以部署世界级访客 WiFi 解决方案的 IT 经理、网络架构师和运营总监。我们将介绍核心架构、分步实施计划以及要避免的常见陷阱。 那么，让我们来看看背景。您拥有一个 UniFi 网络 - 它功能强大且可扩展，但其原生访客门户功能非常基础。您的组织需要的不仅仅是一个密码；它需要智能。您希望了解访客行为，以符合 GDPR 的方式获取用于营销的数据，并提供无缝的、品牌化的用户体验。这就是 Purple 集成所解决的问题。它将您的 UniFi 基础设施从一个简单的互联网提供商转变为丰富的商业智能来源。 此集成的核心在于 UniFi 的外部门户服务器功能。当访客连接时，UniFi 控制器本身并不处理登录。相反，它将用户重定向到 Purple 云平台，由该平台接管整个身份验证过程。在用户通过社交账号、表单或凭证登录后，Purple 会向您的 UniFi 控制器发起安全的 API 调用，指出：“该用户已通过身份验证，请授予其访问权限。” 这是一个简单、强大且高效的架构。 现在进行技术深挖。让我们逐步了解成功部署的五个关键步骤。我会保持简明扼要。 第一步：控制器可达性。您的 UniFi 控制器必须能够被 Purple 的云平台访问。这意味着您需要一个静态公网 IP 或主机名，并且必须在防火墙上配置端口转发规则。对于软件控制器，它是 TCP 端口 8443，对于 UDM Pro 或 Cloud Key Gen2 等硬件，则是端口 443。 第二步：访客 SSID。在您的 UniFi 网络应用程序中，您将创建一个新的无线网络。这里的关键设置是安全协议必须为 Open（开放）。这是不容商榷的。正是这种开放状态才允许发生 Captive Portal 重定向。不用担心 - 安全性是由门户和网络隔离处理的，而不是由预共享密钥处理的。 第三步：热点门户。在这里，您将告诉 UniFi 使用 Purple。您将启用热点门户，并将身份验证类型设置为外部门户服务器。然后，您将输入 Purple 提供的特定 IP 地址和访问域名。这里要避免的一个关键错误是启用 HTTPS 重定向。Purple 会管理安全性，因此应禁用此功能。 第四步：Walled Garden。这是配置中最关键且最常被误解的部分。Walled Garden 是您的预认证白名单。您必须添加 Purple 的所有域名，以及您希望提供的任何社交登录提供商的域名，例如 facebook.com。如果此列表不完整，Portal 页面将无法为您的访客加载。这是排查故障时首先需要检查的地方。 第五步：Purple Portal。最后，您登录到您的 Purple 帐户。在您的场馆设置中，您需要输入 UniFi 控制器的公共地址，非常重要的一点是，还要输入专用本地管理员帐户的凭据，而不是您的 Ubiquiti 云帐户。正是这些凭据允许 Purple 进行关键的 API 调用以授权访客。 遵循这五个步骤，您就拥有了一个强大且企业级的访客 WiFi 解决方案。 让我们来谈谈实施建议和常见陷阱。最佳实践第一条：网络隔离。您的访客 SSID 必须在独立的 VLAN 上，与您的企业网络完全隔离。为了安全性和 PCI-DSS 合规性，这是不可逾越的红线。第二，使用带宽限制。UniFi 允许您设置单用户速率限制。使用它们来确保每个人都能获得公平的体验。第三，正如我所提到的，为 API 使用专用的本地管理员帐户。这能降低您的安全风险。 我们看到最常见的陷阱是重定向失败 - Portal 页面无法加载。十有八九是因为 Walled Garden 设置不完整。第二大常见问题是登录成功，但无法访问互联网。这直接指向 Purple 与您的控制器之间的通信失败。请检查您的端口转发规则以及 Purple Portal 中的管理员凭据。 现在进入快速问答时间。我经常被问到：我可以使用 UDM Pro 来做这个吗？是的，完全可以。过程完全相同，只需记住使用端口 443 即可。如果我的控制器 IP 发生变化怎么办？您需要一个静态 IP 或动态 DNS 主机名。如果地址发生变化，集成将会中断。开放式 SSID 的安全性如何？安全性是通过接入点上的客户端隔离和 VLAN 防火墙规则强制执行的。访客网络是隔离的。为了获得更高的安全性，我们可以部署带有 RADIUS 的 WPA3 企​​业版，这就是我们 Purple 解决方案所做的工作。 简而言之，将 Purple 与 UniFi 集成可将您的访客 WiFi 从一项简单的工具提升为战略资产。它提供了深度的商业智能、强大的营销能力和专业的用户体验。成功的关键在于有条不紊的配置方法：确保公共控制器访问、使用开放的 SSID、正确配置外部门户和 Walled Garden，并为 API 使用专用的本地管理员。通过遵循本指南，您可以确保部署顺利、成功且极具价值。如需详细的分步书面说明和图表，请参阅我们网站上的完整技术参考指南。感谢您收听 Purple 技术简报。