本文详述了故障排除步骤,以帮助您解决 UniFi Wi-Fi 网络的连接问题,主要涉及 UniFi AP 和用户终端设备。

在进一步故障排除之前,请确保设备使用的是最新版本的固件和 UniFi Network 网络应用程序。

关于升级设备固件的更多信息,请参阅 UniFi Network 网络 - 设备和应用程序更新的高级选项


了解连接问题


连接问题通常包括以下两种情况:

  • 用户终端连接问题,即用户终端设备无法连接到 Wi-Fi,例如安卓手机无法连接到 UniFi 网络,或 iOS 设备经常断开连接
  • UniFi 设备连接问题,即用户终端设备可以正常连接到 Wi-Fi 网络,但是 无法上网

为了更好地了解你所面临的情况,请先梳理以下问题:

  • 有多少设备受到影响?(是全部还是部分?)
  • 这些设备有什么共同点?(所处位置、设备类型、操作系统、版本、制造商等)
  • 它是持续发生还是间歇发生的?
  • 你能复现这个问题吗?
  • 你收到何种报错提示?

这些信息将帮助您和我们的支持团队,从而更有效地解决连接问题。


用户终端连接故障排除


如果您发现是个案,只发生在某台设备上(例如,某台笔记本电脑连不上 Wi-Fi),请按照以下步骤进行排障。

1.尝试自行重现用户报告的问题并确认基本操作

在许多案例中,单一用户终端连不上 Wi-Fi 是由于操作不当,或是一系列同类问题。为避免这种情况,请先检查基本设置,例如:

  • 是否输入正确的 WPA WiFi 密码
  • 用户终端设备的无线信号较弱,无线干扰较为严重
  • 用户终端是否支持 5GHz Wi-Fi,等等。

2.如果只有个别用户终端设备受到影响,尝试重启用户终端设备

3.检查用户终端设备,查找可能导致连接问题的恶意软件

4.当使用相同无线网卡的设备都出现故障时,更新用户终端设备上无线网卡的驱动程序

5.尝试禁用 UniFi Network 网络高级网络功能

在某些情况下,您可能错误地配置了类似 RADIUS 等高级功能,或者你的设备不支持这些高级功能,请尝试禁用它们,查看是否可以解决问题。

有关详细信息,请参阅本文的高级功能部分。

6.在网络上搜索故障设备的类似错误提示或问题

如果问题仅发生在特定设备类型上,您可能会在非 UniFi 产品的论坛上找到解决方案。

在这种情况下,按照您找到的故障排除步骤进行操作,或者联系设备制造商(例如安卓的技术支持)寻求帮助。

7.使用抓包工具来监测流量,帮助确定根本原因

如果上述故障排除步骤均无帮助,则表明 UniFi 设备本身可能存在问题,或者是配置不当。

您可以继续阅读本文查找相关信息,或者联系我们的支持团队寻求帮助。


UniFi 设备连接故障排除


在进行 UniFi 设备故障排除之前,请确保设备使用最新版本的 UniFi Network 网络应用程序和固件。您遇到的问题可能已在最新版本中得到解决。

更多关于设备固件更新的信息,请参阅 UniFi - 升级 UniFi 设备的固件

如果您的设备和 Network 网络应用程序已是最新版本,但是问题仍然存在,请继续执行故障排除步骤,下面会列出最常见的连接问题和解决方案。


AP 距离和网络布局


网络规划不当可能是 UniFi 设备连接问题的原因之一。

如果用户终端靠近所连接的 AP 可以解决问题,则您可能需要重新评估 UniFi AP 的型号、安装位置或数量。

此外,与其他电子设备的干扰可能会造成问题。

如果是这种情况,我们建议您访问 UniFi 设计中心,获取有关 UniFi 网络规划和部署的帮助。


确保 AP 没有重启


在某些情况下,连接问题可能是由 UniFi AP 重启引起的。

为排除这种情况,请检查 AP 的在线运行时长:

  1. 登录 UniFi Network 网络
  2. 在设备选项中,选择 AP
  3. 在设备属性面板上,查看详细信息(Details)>概述(Overview)部分(或在线运行时长列)

如果在线运行时长不断重置,并且与网络中断同时发生,则可能是的设备固件存在问题。您需要更新到最新固件,如果故障未排除,请联系我们的支持团队


优化射频配置


WiFi 优化的目标之一是减少干扰。首先确保 AP 的 2.4GHz 使用1、6 和 11这三个非重叠信道中的一个。如果有 3 个以上的 AP ,重叠确保在距离最远的 AP 上面使用相同信道。在 5GHz 信道上,防止信道重叠更加容易。 转到 设备(Devices)> 单击设备图标 > 射频(Radios) 下拉菜单中的 设置(Settings),您可以在此处切换 信道

我们还建议选择占用率最低的信道。 要检查您的信道使用情况,请转到 设备(Devices) > 单击设备图标 > 洞悉(Insights),然后单击 RF 环境(RF Environment) 下拉菜单中的 扫描信道(Scan Channels)

如今,大多数设备都支持 5GHz 信道。 相比 2.4GHz 频段,该频段没有那么拥挤。 出于这个原因,您应该确保 WiFi SSID 启用了 5GHz 频段,并且所有支持 5GHz 的设备都连接到了 5GHz 网络。 可转到 UniFi Network 网络应用程序中 WiFi 的 高级设置(Advanced Setting) 来启用 高性能设备(High Performance Devices),这将强制所有支持 5GHz 的设备使用此频段。 或者您可以创建单独的 2.4 GHz 和 5GHz SSID,并使用户终端连接到相对应的 SSID 上,这是更好的选择。


验证 AP 配置


设备配置不当可能会导致间歇性连接问题、无法升级 AP、NTP 同步失败和其他问题。

始终确保您网络中全部的 AP 都具有:

  • 完整的网络配置,包括 DNS 服务器地址,使其可访问互联网
  • IP 地址,子网掩码长度合适,使其正常路由至网关
  • 网关与静态 IP 地址在相同的子网中

另一个常见错误是交换机端口的 VLAN 配置错误。

要为多个 VLAN 提供服务,请确保:

  • AP 连接到的交换机端口允许相关 VLAN 通过
  • AP 到路由器之间的所有中间交换机都进行了配置,并且允许这些 VLAN 通过

网络丢包和智能队列


要判断连接问题出现在有线还是无线设备上,需要从笔记本电脑的两个终端界面上,同时持续 ping 公共 DNS 服务器地址 (114.114.114.114) 和您路由器的 IP 地址:

  • 如果看到两个 IP 的 ping 结果,数据包都丢失,那么您可能遇到了无线问题
  • 如果仅在 114.114.114.114 上看到数据包丢失,那么您可能遇到了有线/互联网问题

如果本地设备可以通过 Wi-Fi 访问,但在互联网上发生丢包:

  1. 在路由器上启用智能队列或其他流量整形方法
  2. 在 WAN 网络的经典设置上,转到 网络(Networks)> 编辑/新建 WAN 网络(Edit/New WAN Network)> 新设置:互联网(New Settings: Internet)> WAN 网络(WAN Networks)> 编辑/新建 WAN 网络(Edit/New WAN Network)
  3. 准确配置智能队列的上传和下载值,以匹配您的签约 ISP 运营商宽带大小

许多笔记本电脑无论是否处于充电状态,都会在其 Wi-Fi 接口上启用 Wi-Fi 省电模式。

您可能会看到最多延迟 1.25 秒的 ping 响应,尤其是当笔记本电脑未进行其他网络使用操作时, 这是数据包延迟,而不是丢失。


禁用高级功能


某些 UniFi Network 网络高级功能在配置不当,或者是用户终端设备不支持时,可能会导致连接问题。

此外,一些无线用户终端可能在无线网卡驱动程序中,启用了高级选项,也会影响性能(如吞吐量增强程序)。

在排除连接故障时,请尝试禁用 UniFi Network 网络程序以下功能

  • 频段引导
  • 最小 RSSI
  • 上行链路连通性检测
  • 网络自动优化
  • 无线传输公平性

要找到频段引导和最小 RSSI 的方式如下:

  1. 打开高级功能:转到 设置(Setting)> 站点(Site)> 服务(Services)
  2. 频段引导:转到设备(Devices)选项卡,点击某台 AP 图标,然后转到 配置(Configuration)
  3. 最小 RSSI:转到 射频(Radios)> 高级选项(Advanced Options),打开下拉菜单,找到最小 RSSI

1.png

4.频段引导和无线传输公平性在 配置菜单 中各有单独的选项卡,点击可获得详细信息

2.png

如果禁用高级功能可以解决问题,则可能是用户终端兼容问题,也可能是固件或应用程序错误。请联系我们的支持团队,我们将为您提供帮助。


高发射功率和链路预算


高发射功率 UniFi AP 非常适合在安装在单台 AP 即可覆盖的场景中,但对于企业或多 AP 部署可能会出现问题。

高发射功率只会扩大覆盖范围,对带宽提升没有帮助,因为高协商速率的用户终端设备一般仅在中/低发射功率覆盖范围内传输,通常所有的 AP 和设备皆是如此。在多 AP 部署中,高发射功率会导致高协商速率用户终端设备的无线空口资源减少,拖慢整个网络,并可能导致数据包丢失。

高发射功率还可能导致用户终端和 AP 之间的 Wi-Fi 链路预算不平衡,大多数用户终端的发射功率在 14 到 18 dBm 之间。

因此从 AP 到用户终端的信号很强,用户终端将保持与 AP 的连接( Wi-Fi 信号显示满格)。但是从用户终端到 AP 的信号不够强,用户终端无法将数据回传,所以会导致连接问题。

要解决此问题,请打开 Network 网络应用程序,将 UAP 上的 TX 功率降低到 18 dBm,步骤如下:

  1. 转到 设备(Devices)> 配置(Configuration),然后单击 射频(Radios) 下拉菜单

3.png

  1. 2G 射频(Radio 2G ) 下调整 发射功率,选择 自定义(Custom),并将 dBm 设置为 18
  2. 5G 射频(Radio 5G) 执行相同操作
  3. 单击 队列更改(Queue Changes),然后进行 应用更改(Apply Changes)
  4. 对其他 AP 执行相同操作

4.png


网络环路


网络环路是一种网络故障现象,在两台计算机或设备之间存在多个连接路径,导致数据包不断重复。

您可以在受影响的 UAP 和/或 UniFi 交换机上运行 tcpdump 命令,以及在 Wireshark 中查看输出流量来检测网络环路。

按照以下步骤检测网络环路:

1.SSH 进入受影响的 UAP 并发出以下命令:

tcpdump -i br0 -n -v -s 0 -w /tmp/capture.pcap

2.将生成的 pcap 文件复制到您的笔记本电脑,以便在 Wireshark 中查看。

scp admin@192.168.1.X:/tmp/capture.pcap /tmp

将 capture.pcap 复制到您计算机上的 /tmp。 您也可以按照此种方法使用 winscp。

3.在 Wireshark 中打开文件。

典型网络的组播/广播流量少于 100 kbps,每秒总共只有几十个数据包。

如果每秒有数千个组播/广播数据包,那么可能在某个地方存在需要解决的网络环路。 尝试一一断开基础设备,直到组播/广播数据包的数量下降到合理的数量。

如果您的网络上有 IPTV,由于组播流量较大,这可能表现得和“网络环路”很像。在这种环境下,建议使用组播增强技术,因为它可以将这些数据包转换为单播,并且只传输给需要的设备。


DHCP 配置


有一些较旧的或配置错误的路由器和 DHCP 服务器,将 DHCP 提供/确认消息作为广播数据包传输,更容易发生丢包。 这可能会导致连接速度变慢和连接不稳定。

请确保您的 DHCP 提供和确认消息是单播的,而不是广播的(来自用户终端的发现数据包仍然可以广播)。

您可以通过以下两种方式执行此操作:

  1. 创建不同的 LAN 网段,即如果您只有一个 LAN 用于多台机器/设备,您可以为不同的网络区域创建多个 LAN,这有助于通过创建单播数据包来避免降速
  2. 关于创建不同的 VLAN,详情请参阅 UniFi - 使用带有 UniFi 路由硬件的 VLAN

DHCP 超时计数器可用于调试常见的错误配置问题。

从无线用户终端转发 DHCP 发现/请求后,如果每 10 秒以上未看到 DHCP 响应时,此计数器就会增加 1。

如果 DHCP 超时数快速增加(每天增加数百或数千),请确认:

  1. AP 所连接的交换机端口允许所需 VLAN 的流量通过
  2. 通过嗅探 DHCP 服务器本身的 DHCP 流量,确定 DHCP 服务器是否在响应 DHCP 请求。

此外,您需要检查 DHCP 服务器日志,以了解为什么请求可能会被丢弃或NAK (拒绝),是不是因为错误配置的 DHCP 中继等服务。


通过网络跟踪数据包


在某些情况下,组播/广播数据包会成功传输,而单播数据包不会。

跟踪数据包有助于了解不同类型的数据包在网络上的传输距离。

首先,您需要确定无线用户终端连接到哪个 VAP 接口。 您可以通过 ssh 进入有问题的 AP 并发出命令 iwconfig

在下面的示例中,您可以看到 ath6 是 5 GHz 射频上 ubnt-ut-AP-LR 网络的 VAP。

5.png

确定广播数据包是否到达 UAP

1.通过 SSH 进入 UAP,在 UAP 的 athx 接口上运行 tcpdump:

tcpdump -i athX -n -v -s 0 -w /tmp/broadcast.pcap

2.从您的笔记本电脑(笔记本电脑上的终端程序)ping 一些广播数据包:

ping 192.168.1.255

3.停止抓包,并启用另一个名为 /tmp/unicast.pcap 的抓包:

tcpdump -i athX -n -v -s 0 -w /tmp/unicast.pcap

4.接下来,尝试将单播数据包发送到您的路由器(笔记本电脑上的终端):

ping 192.168.1.1 (replace with your router’s IP)

5.如果广播数据包没有被传送或接收,那么单播数据包也不会出去(由于操作系统中缺少 ARP 条目),您需要在笔记本电脑(笔记本电脑的终端)中强制输入一个静态 ARP 条目。

sudo arp -s 192.168.1.1 00:00:00:00:00:01 ifscope en0 (Mac OS X)
arp -s 192.168.1.1 00-00-00-00-00-01 (from Administrator Command Line in Windows

6.再次尝试 ping,看看 00:00:00:00:00:01 单播数据包是否到达 UAP 的 athX 接口。

确定 UAP 的数据包是否到达用户终端

1.首先,您需要在笔记本电脑上启动 Wireshark 或 tcpdump 以验证数据包是否正在传输中。

2.通过 SSH 进入 UAP,从 UAP ping 广播地址:

ping 192.168.1.255

3.在 wireshark/tcpdump 中抓包,然后开始 ping 您的笔记本电脑(ssh 登录 UAP):

ping 192.168.1.X

4.如果 UAP 没有单播流量,那么 UAP 可能没有办法设置静态 ARP 条目,您可以尝试在有线台式机/笔记本电脑上设置静态 ARP 条目,然后从该单独设备发送数据包。

5.最后,再次检查网桥是否配置正确(ssh 登录 UAP):

brctl show

输出应与此类似:

网桥名称 网桥 ID 启用 STP 接口
br0 ffff.44d9e7f9876a no ath0
ath1
ath2
ath3
ath4
ath5
ath6
ath7
eth0

Wireshark 抓包


Wireshark 是世界上很重要的网络封包分析软件。使用非常广泛,在大多数平台上,都可以使用它来深入分析您自己的网络。

对其进行设置并开始抓包:

  1. 下载并安装 Wireshark
  2. 打开 Wireshark 并点击齿轮图标
  3. 确保为 en0 接口启用了监控模式

6.png

  1. 单击关闭,然后重新启动 Wireshark。
  2. 在 en0 上开始捕获。 您可以看到散布在数据帧中的信标、控制帧和管理帧。

您可以在寻求帮助时,将此抓包数据上传到社区,别忘了提供有问题的笔记本电脑或用户终端的 MAC 地址。