Teleport 连不上怎么排查：IPv6、NAT、iOS 后台与桌面版网卡问题

Teleport 平时一键就通，翻车时翻车得也很安静——「显示已连接但完全没流量」是最高频的症状。这一页按出现频率列出已知的坑与对应解法。

症状一：蜂窝数据下连不上（尤其特定运营商）

现象：WiFi 下一切正常，切到移动网络就连不上或秒断。

已知原因：Teleport 的隧道地址同时带 IPv4 与 IPv6，当蜂窝运营商或家庭宽带的 IPv6 支持不完整时（一方给 IPv6、另一方不给），流量会路由失败。1.37.x 的 iOS 更新专门修过「部分移动网络（T-Mobile 等 IPv6 运营商常见）Teleport 不工作」的问题。

处理：

1. 先把两端 App 都升到最新版（iOS 1.37.x 起、桌面端 1.2.x 起）。
2. 仍不行时，确认家庭宽线的 IPv6 状态，与蜂窝运营商的环境交叉对比——两端至少一端纯 IPv4 且双栈健康时成功率最高。
3. 临时救急：换 WiFi 环境连接，或等官方继续修复（这类兼容问题在更新记录里持续出现）。

症状二：iOS 上连几分钟后断流

现象：连上后切到别的 App，几分钟后隧道静默失效，回 WiFiman 重连又好。

已知原因：iOS 版 WiFiman 没有后台刷新保活，退到后台后不再发送保活包，运营商 NAT 的 UDP 映射超时后隧道静默塌掉。这是当前版本的设计限制，社区反馈集中。

处理：把它当「随用随连」的短会话工具——用的时候留在前台；长会话需求（挂机下载）改在桌面端跑。系统设置里找不到 WiFiman 的后台刷新开关是正常现象，不是你手机的问题。

症状三：桌面版断开后网卡卡死

现象：Windows 上 Teleport 断开（或连接失败）后，电脑整体断网；或重启后网络异常。

已知原因：WireGuard 虚拟网卡的残留问题。1.2.8 更新声称修复了「断开 Teleport 后 WireGuard 网络接口卡住」，但社区帖子里仍有陆续反馈，Linux 端还有缺 nftables 依赖导致连接卡在 Connecting 的案例。

处理：

1. 升级到最新桌面版。
2. Windows 上重置虚拟网卡：设备管理器里卸载 WireGuard/TAP 类适配器后重连。
3. Linux 端确认装了 nftables 或 iptables 再启动服务。
4. 顽固案例重启大法，并把问题反馈到官方社区版块。

症状四：谁都连不上（家里端问题）

现象：所有设备、所有网络都失败。

处理：回网关侧设置自查——网关是否在线（Discover 页确认，见Discover 页）、UniFi OS 是否更新、Teleport 开关是否仍在启用状态、家庭宽带是否换了光猫导致公网环境变化。

万能三步

所有排障的最小闭环：两端升级到最新 → 重启隧道（断开再连）→ 重启网关。三步走完仍不行，带着「两端版本号 + 网络环境 + 症状」去官方社区反馈，比干等快。