WiFiman Desktop 已知问题清单：WireGuard 网卡、Linux 依赖与扫描限制

桌面版迭代快、问题也集中在特定几处。这一页汇总官方已知事项与社区反馈里出现频率最高的问题，装机前扫一眼能省不少时间。

官方承认的已知问题

1.2.8 发布说明里明确列出的 Known issue：

• Linux 的 6GHz 扫描结果可能显示错误的信道宽度——源于操作系统或无线网卡驱动的限制，不是 App 单方面能修好的。5 GHz 数据不受影响；需要严谨 6GHz 数据的场景换用支持良好的硬件。

Windows：Teleport 相关的网卡问题

这是桌面版社区反馈最多的一类：

• 症状：Teleport 断开（或连接失败、开机自启）后，WireGuard 虚拟网卡残留，整机断网或网络异常。
• 官方动作：1.2.8 更新称已修复「断开 Teleport 后 Windows 的 WireGuard 网络接口卡住」，但社区后续仍有零星反馈，属于长期攻凹的硬骨头。
• 规避与自救：

1. 始终用最新版；
2. 出问题时在设备管理器卸载残留的 WireGuard/TAP 虚拟适配器后重连；
3. 顽固案例重启，并暂时用手机版 Teleport 过渡；
4. 详细症状对照见Teleport 连接排障的症状三。

Linux：依赖与平台支持

• 缺 nftables 依赖：1.2.8 的 deb 包依赖列表里没有 nftables/iptables，裸装系统上 Teleport 会永远卡在 Connecting（社区已给出分析：wg-quick 的默认路由处理依赖这两个工具之一）。解法：先安装 nftables 再启用服务。
• 发行版覆盖：目前只有 deb 系（Ubuntu 22+/24.04），Fedora/RHEL 系与 Flatpak 尚无官方包，社区呼声持续存在。
• 5 GHz 网络在某些 Linux 设备上不可见的显示问题在 1.2.x 里修过，遇旧版先升级。

跨版本的显示类小问题

以下在更新记录里被点名修复过，旧版本遇到时升级即可：

• Discovery 页超长设备名被截断（1.2.8 修复）。
• 部分系统托盘图标显示为黑色（1.2.8 修复）。
• 信道健康计算错误（1.2.8 修复）。
• macOS 上偶发的 Teleport 需多次点击才连上（社区反馈，官方持续跟进中）。

什么时候绕开桌面版

• 需要信道扫描：桌面端没有这页，用 Android 手机。
• 需要信号热力图：手机 LiDAR 才能做（见Floor Plan Mapper）。
• macOS 上 Teleport 反复连不上：社区经验是 Mac App Store 装 iPad 版当桌面客户端用，稳定性口碑更好。

问题状态随版本变化，以上基于官方发布说明与社区公开反馈整理；遇到本页未覆盖的症状，去 Ubiquiti 社区 WiFiman Desktop 版块检索或反馈。