用途:在 macOS 上诊断 Windows App(Microsoft Remote Desktop / AVD / WVD / W365 / 直连 PC)的连接故障,重点是 AVD 传输协议优化与根因排查。
主要能力:区分 AVD/WVD/W365(经工作区与网关连接云端桌面)与直连 PC(按主机名/IP 连接)两类场景;读取 Windows App 的 Connection Info 获取 Transport Protocol、RTT、可用带宽、网关、服务区域;用 ifconfig、netstat、scutil、lsof、tailscale 等收集网络与路由证据;分析 Windows App 日志(位于 ~/Library/Containers/com.microsoft.rdc.macos/Data/Library/Logs/Windows App/,时间戳为 UTC)判断传输协商、证书、网关可达性和身份认证问题。
必要用法:直连 PC 可用 python3 scripts/probe_rdp_server.py <host> [port] 独立探测服务端 RDP+TLS 是否健康。日志可用 grep 过滤 STUN/TURN/Shortpath/VPN/证书等关键条目,并按 activity GUID 聚合单次连接生命周期。修复后复查 Connection Info(传输应回到 UDP/UDP Multicast,RTT 下降)或确认直连会话窗口出现。
适用场景:AVD 传输协议回退到 WebSocket/TCP;VPN/代理导致 STUN/TURN 被路由;ISP 限制 UDP;客户端健康检查失败;服务端未启用 Shortpath;过期 Microsoft 账户导致卡在“Configuring remote PC...”;服务端重启或 Windows Update 导致断连。
限制:主要面向 macOS 客户端;服务端 Shortpath 未启用需管理员在 Azure 门户处理;部分修复需修改代理规则或网络配置;具体收费、价格与平台支持范围暂未提供。