本指南介绍如何识别并解决影响 UniFi Protect 摄像头性能和应用访问的常见连接问题。

分类您的连接问题

识别问题的性质将帮助您更有效地处理它：

  • 摄像头连接问题：通常由摄像头 WiFi 信号弱引起，会影响录像质量并造成画面丢失。
  • 客户端连接问题：通常是在远程访问 Protect 时连接不良导致。为保证流畅播放，录制会以较低画质播放，但本地仍以全画质存储。

诊断问题的步骤

  1. 通过不同方式访问：尝试用多种设备、操作系统、浏览器和网络方式进行访问：
    • 使用不同的移动设备（iOS、Android）和浏览器（Chrome、Firefox、Safari）。
    • 试用本地网络和远程网络（如工作场所或公共 WiFi）。
    • 让拥有不同权限的多位用户尝试访问。
  2. 检查网络稳定性：
    • 使用 WiFiman 应用程序在与 UniFi 控制台相同网络中进行速度测试。网络速度低于 2.5 Mbps 可能出现问题。
    • 确保没有开启 VPN 或其他限制带宽的应用程序。
    • 检查 UniFi 控制台未超过所支持摄像头数量。
  3. 应对高 CPU 使用率：如果您的电脑 CPU 使用率接近 100%，请尝试减少实时画面矩阵中同时观看的摄像头数量。

故障排查：加载缓慢、画面缓冲

  1. 网络稳定性：确保网络连接稳定且信号强。
  2. 带宽限制：确认没有因 VPN 或子网分割配置而限制带宽。
  3. 摄像头数量限制：确认 UniFi 控制台未超出所支持的摄像头数量。
  4. 设备性能：检查电脑 CPU 使用率，高占用可能会影响回放。
  5. 直连控制台：连接至本地网络时，将 UniFi 控制台的 IP 地址直接输入浏览器导航栏访问。

故障排查：远程访问

如果远程访问问题仍然存在，请参考以下步骤：

  1. 检查 Ubiquiti 服务状态：访问 status.ui.com，查看 UniFi 服务是否有宕机情况。
  2. 用户权限：确保您拥有远程访问的正确权限。详见 UniFi Protect - 添加和管理用户。
  3. 固件更新：确认 CloudKey 或 UniFi 控制台固件为最新，以支持远程功能。

排查移动应用无法访问

  1. 应用更新与权限：确保 UniFi Protect 应用为最新版本，并拥有 WiFi 和蜂窝数据权限。
  2. 关闭 VPN 和隐私应用：VPN 和隐私应用可能会干扰 WebRTC（Protect 依赖的传输方式）。请尝试关闭 VPN 和私有 DNS，尤其是在 Android 设备上。
  3. 持续异常时重装应用：如果应用仍然无法正常运行，请卸载后重新安装尝试。

故障排查：特定浏览器问题

如果 Protect 在某些浏览器能正常使用，而其他浏览器则出现问题，第三方浏览器扩展可能阻止了连接。

  1. 禁用扩展：尝试关闭可能影响隐私或安全的浏览器扩展，例如 VPN、广告拦截器和 WebRTC 泄露防护工具。
  2. 逐一测试重启扩展：逐个重新启用扩展，以识别潜在冲突的软件。
  3. Chrome 设置调整：通过输入 chrome://flags/#enable-webrtc-hide-local-ips-with-mdns 到地址栏，将 “通过 WebRTC 隐藏本地 IP” 这一选项设为 “Disabled（已禁用）”。

进阶排查：WebRTC 与 NAT 问题

UniFi Protect 使用 WebRTC 在设备间建立连接。某些网络配置，如对称 NAT（Symmetric NAT），会阻断这些连接：

  1. 验证网络要求：确保两个网络的互联网接入可靠、带宽足够，防火墙设置正确（外发 TCP 端口443、外发 UDP 端口0-65535）。
  2. 检测对称 NAT：如果设置为对称 NAT 导致连接被阻断，请设置 VPN 连接或将路由器切换为锥形 NAT（Cone NAT）模式。
  3. SSH 日志查看对称 NAT：如果怀疑控制台端为对称 NAT，可通过 SSH 登录 UniFi 控制台，查看日志中是否有 “symmetric” 字样以确认。

网络特定连接问题排查

如果 Protect 仅在特定网络下无法正常工作，请重点排查该网络：

  • 网络专项排查：
    • 确认 UniFi 控制台网络连接稳定，网关 IP 和 DNS 设置有效。
    • 检查 DNS 是否能解析关键 UniFi Protect 服务域名（如 Device.svc.ubnt.com、Global.stun.twilio.com）。
    • 临时禁用所有自定义防火墙规则，确认 WebRTC 流量未被阻断。