Nexus/docs/changelog/2026-06-10-rdp-display-mount-fix.md

2026-06-10 — RDP 画布挂载与前端同步修复

摘要

修复 3389 页一直「正在连接」：Guacamole 画布需在 connect() 前挂入 DOM；连接层用独立 canvasHost + 遮罩，避免 Vue 重绘抹掉画布；生产同步 web/app 进容器。

动机

• 官方 Guacamole 用法：先 appendChild(display.getElement()) 再 client.connect()
• 原实现等 STATE_CONNECTED 才挂载，sync/flush 可能无法完成，客户端停在 WAITING
• Docker 镜像内前端为旧 vite 缓存，未执行 sync_webapp_to_container

涉及文件

• frontend/src/composables/rdp/useRdpSession.ts
• frontend/src/pages/RdpPage.vue

验证

生产 sync_webapp_to_container.sh 后，3389 连接应进入「已连接」并显示桌面。