P2WLAN诊断与排障指南5步快速定位Direct/Relay连接问题【免费下载链接】p2wlan跨平台 P2P 虚拟局域网(VirtualLAN)工具让异地设备像在同一局域网中互联。支持 NAT 穿透、IPv6 直连、房间组网与 Relay 回退覆盖 Windows / macOS / Linux / Android。项目地址: https://gitcode.com/gh_mirrors/p2/p2wlanP2WLAN 是一款跨平台 P2P 虚拟局域网VirtualLAN工具让异地设备像在同一局域网中互联。当你的设备显示直连失败或只有中继时本文面向新手用 5 步教你通过内置诊断命令和客户端界面快速定位 Direct/Relay 连接问题让异地联机和远程访问尽快恢复。先看懂你的连接路径Direct 还是 RelayP2WLAN 优先建立局域网、IPv6 或 UDP 打洞直连Direct直连不可用时自动回退到端到端加密中继Relay网络条件改善后又会继续尝试恢复直连。连接的有效状态由注册、候选获取、加密确认、路径选择等多个阶段共同决定因此排障时不能只看在线图标——UI 显示在线不等于 TUN 已建立Connecting 也不等于业务可用。在客户端里常用信息都可以直接看到首页展示网络状态与在线设备房间详情页展示虚拟 IP、连接路径Direct/Relay和延迟。第1步记录版本信息一条命令拿到状态全貌 排障的第一步永远是先记录客户端、daemon、Control、Relay 的准确版本和时间再按层排查避免凭感觉下结论。三条最常用的 CLI 命令p2wlan --version确认客户端版本p2wlan status --json查看 daemon、设备和路径状态p2wlan doctor输出结构化诊断摘要是官方排障的起点命令完整说明见 docs/reference/cli.md排障总入口见 docs/guides/troubleshooting.md。第2步先排除虚拟局域网本身的问题 如果虚拟 IP 可见但业务不通问题可能不在 NAT 打洞而在本机或房间层面。按顺序检查运行p2wlan route verify检查本机路由必要时p2wlan route repair修复确认房间租约仍有效多房间场景可结合 docs/guides/rooms.md检查数据面收发计数是否有增长确认目标服务监听在可访问地址且防火墙放行了对应端口最终判断必须用虚拟 IP 执行实际的 TCP、UDP 或 ICMP 验证。加密 ACK 或在线人数不等于业务真正往返这是新手最容易踩的坑。第3步Direct 不通看 reason code别只看候选数量 Direct 不通时优先检查四件事NAT profile、候选来源、UDP 防火墙、路径 reason code。几个关键认知帮你少走弯路STUN 成功不等于对端可入站公网映射不代表对方能收到打洞包家庭宽带、校园网、企业网、移动热点、CGNAT 和双受限 NAT 结果各不相同双对称网络走 Relay 是正常现象排查双对称网络始终 Relay 时要区分candidate_not_executed候选未执行、租约重投、代际取消和已发送但无响应——这是四种不同的问题不能只凭候选数量判断记住Relay 路径正常不说明 Direct 一定有缺陷reason code 是一个封闭集合每个失败原因都有明确标签详见 docs/reference/path-observability.md 与 NAT 限制说明 docs/reference/networking.md。第4步只有 Relay按清单检查中继链路 如果长期停留在 Relay按清单逐项核对检查项说明Relay TLS服务端 TLS 证书是否有效audience / region客户端接入的区域与受众是否匹配ticket中继票据是否签发、未过期/readyzRelay 是否真正就绪还需撤权 feed 已同步且在有效期内撤权 feed账号是否被撤权导致路径被切断Relay 关闭原因有明确区分peer_closed、partial_frame、local_closed、connection_reset、idle_timeout和兜底的read_error。注意关闭原因只说明传输如何结束不能单独推断 NAT 打洞失败。如果是自托管服务还可以在服务端运行p2wlan-server doctor --service all。注意/health只表示进程可响应/readyz才表示 Relay 真正就绪两者都不能证明端到端业务可达详见 docs/guides/operations.md。第5步收集日志与支持包精准定位 前五步仍无法定位时收集证据交给维护者或社区p2wlan logs -f跟随 daemon 日志观察问题复现时的实时输出p2wlan support-bundle生成本地支持包包含版本、reason code、NAT 模型、路径转换等脱敏诊断信息p2wlan support-bundle --upload仅在用户显式确认后上传⚠️ 上传前请务必检查删除不必要的业务日志不要上传 JWT、设备凭据、Relay ticket、私钥和完整环境文件。支持包采集逻辑见 apps/flutter_client/lib/core/diagnostics/日志可靠性与采集边界说明见 client/daemon/DIAGNOSTICS_RELIABILITY.md。常见现象速查表 ⚡现象先检查什么不要据此下结论无法登录Control URL、HTTPS 证书、账号响应、系统时间不能仅凭 Relay 正常判断 Control 正常登录成功但无设备房间成员、设备授权、Control 信令和 daemonUI 在线不等于 TUN 已建立Direct 不通NAT profile、候选来源、UDP 防火墙、reason codeSTUN 成功不等于对端可入站只有 RelayRelay TLS、audience/region、ticket、/readyzRelay 路径不说明 Direct 有缺陷虚拟 IP 可见但业务不通本机路由、房间租约、收发计数、目标服务与防火墙加密 ACK 不等于业务往返重启后状态错误daemon 进程/revision、网络代际、peer session旧快照不能当作实时状态延伸阅读 排障总指南docs/guides/troubleshooting.md客户端与 CLI 用法docs/guides/client.md连接生命周期原理docs/explanation/connection-lifecycle.md路径可观测性参考docs/reference/path-observability.mdNAT 打洞与限制docs/reference/networking.md掌握这 5 步后绝大多数 Direct/Relay 连接问题都能在几分钟内定位到具体环节——从版本信息到路由从 NAT 类型到中继链路最后用支持包兜底。祝你的 P2WLAN 虚拟局域网一直畅通【免费下载链接】p2wlan跨平台 P2P 虚拟局域网(VirtualLAN)工具让异地设备像在同一局域网中互联。支持 NAT 穿透、IPv6 直连、房间组网与 Relay 回退覆盖 Windows / macOS / Linux / Android。项目地址: https://gitcode.com/gh_mirrors/p2/p2wlan创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考