FreeRDP网关RPC模式连接失败问题分析与修复
问题背景
FreeRDP是一款开源的远程桌面协议(RDP)客户端实现,在3.13.0版本中,用户报告了一个严重的回归性问题:当使用RPC网关模式(/gateway:type:rpc)时,连接会失败并显示"tsg_check failure"错误。这个问题影响了通过RPC网关模式连接Windows远程桌面网关(RD Gateway)的用户,特别是那些在网络负载均衡后面部署RD Gateway的场景。
问题表现
在FreeRDP 3.13.0版本中,当用户尝试通过RPC网关模式连接时,会出现以下错误序列:
- RPC PDU解析不完全警告
- RTS PDU故障状态显示ERROR_NOT_DOS_DISK
- 意外的alloc_hint值警告
- 最终tsg_check失败错误
- 连接终止,错误代码ERRCONNECT_SECURITY_NEGO_CONNECT_FAILED
相比之下,3.12.0版本在相同配置下工作正常,而将类型改为HTTP模式(/gateway:type:http)虽然可以连接,但在网络负载均衡后的RD Gateway场景下无法工作。
技术分析
问题的根源在于FreeRDP 3.13.0中对TSG(终端服务网关)检查逻辑的修改。具体来说,b138f6ca18c5这个提交引入了对TSG数据包的更严格检查,但未能正确处理某些情况下的消息包指针。
根据微软的MS-TSGU协议规范,TSG_PACKET_MSG_RESPONSE结构包含一个IsMsgPresent标志,指示messagePacket参数是否存在。当该标志为FALSE时,messagePacket参数应被忽略,但代码仍需读取指针值。3.13.0版本的实现在IsMsgPresent为FALSE时完全跳过了指针读取,导致后续数据解析错位。
解决方案
开发团队通过以下方式修复了这个问题:
- 确保即使IsMsgPresent为FALSE也读取MessageSwitchValue
- 正确读取并忽略消息包指针(MsgPtr)
- 在IsMsgPresent为FALSE时读取但不处理同意消息(consent message)
- 保持数据流解析的完整性
修复后的版本(3.13.1-dev0)已经过测试验证,能够成功建立RPC网关模式的连接。虽然仍会显示"Read NDR pointer"警告,但这些不影响功能,将在未来版本中进一步优化。
影响范围
此问题影响所有使用以下配置的用户:
- 通过RPC模式(/gateway:type:rpc)连接RD Gateway
- 特别是网络负载均衡后端的RD Gateway部署(仅RPC模式可用)
- FreeRDP 3.13.0版本
用户建议
对于遇到此问题的用户,建议:
- 升级到包含修复的FreeRDP版本(3.13.1或更高)
- 如果暂时无法升级,可回退到3.12.0版本
- 避免在生产环境中使用HTTP网关模式替代RPC模式,除非确认兼容性
技术细节补充
RPC(远程过程调用)网关模式是RD Gateway的一种连接方式,相比HTTP模式:
- 使用不同的协议栈和端口
- 支持更复杂的网络拓扑
- 在网络中间设备后表现更可靠
- 实现更高效的二进制数据传输
TSG(终端服务网关)协议是微软专为远程桌面网关设计的协议,负责:
- 身份验证和授权
- 连接隧道建立
- 策略实施
- 资源重定向控制
理解这些底层协议有助于更好地诊断和解决连接问题。
- DDeepSeek-V3.1-BaseDeepSeek-V3.1 是一款支持思考模式与非思考模式的混合模型Python00
- QQwen-Image-Edit基于200亿参数Qwen-Image构建,Qwen-Image-Edit实现精准文本渲染与图像编辑,融合语义与外观控制能力Jinja00
GitCode-文心大模型-智源研究院AI应用开发大赛
GitCode&文心大模型&智源研究院强强联合,发起的AI应用开发大赛;总奖池8W,单人最高可得价值3W奖励。快来参加吧~057CommonUtilLibrary
快速开发工具类收集,史上最全的开发工具类,欢迎Follow、Fork、StarJava04GitCode百大开源项目
GitCode百大计划旨在表彰GitCode平台上积极推动项目社区化,拥有广泛影响力的G-Star项目,入选项目不仅代表了GitCode开源生态的蓬勃发展,也反映了当下开源行业的发展趋势。07GOT-OCR-2.0-hf
阶跃星辰StepFun推出的GOT-OCR-2.0-hf是一款强大的多语言OCR开源模型,支持从普通文档到复杂场景的文字识别。它能精准处理表格、图表、数学公式、几何图形甚至乐谱等特殊内容,输出结果可通过第三方工具渲染成多种格式。模型支持1024×1024高分辨率输入,具备多页批量处理、动态分块识别和交互式区域选择等创新功能,用户可通过坐标或颜色指定识别区域。基于Apache 2.0协议开源,提供Hugging Face演示和完整代码,适用于学术研究到工业应用的广泛场景,为OCR领域带来突破性解决方案。00openHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!C0381- WWan2.2-S2V-14B【Wan2.2 全新发布|更强画质,更快生成】新一代视频生成模型 Wan2.2,创新采用MoE架构,实现电影级美学与复杂运动控制,支持720P高清文本/图像生成视频,消费级显卡即可流畅运行,性能达业界领先水平Python00
- GGLM-4.5-AirGLM-4.5 系列模型是专为智能体设计的基础模型。GLM-4.5拥有 3550 亿总参数量,其中 320 亿活跃参数;GLM-4.5-Air采用更紧凑的设计,拥有 1060 亿总参数量,其中 120 亿活跃参数。GLM-4.5模型统一了推理、编码和智能体能力,以满足智能体应用的复杂需求Jinja00
Yi-Coder
Yi Coder 编程模型,小而强大的编程助手HTML013
热门内容推荐
最新内容推荐
项目优选









