控制台接入
使用一次性票据与同源 WebSocket,打开真实 noVNC 会话。
推荐入口
业务系统可引导已登录用户访问平台 /instances/<实例 UUID>/console。用户需有实例权限,平台页面会在实例运行时自动连接。打开控制台不会改变电源状态。
自建同源客户端
使用 POST /api/v1/instances/{instance_id}/console-sessions 申请,响应包含 id、url、expires_at。URL 对应 RFB WebSocket 流,不是可直接 iframe 的 noVNC HTML 页面。
票据 60 秒内仅能连接一次,最长连接时间 30 分钟。连接仍校验原用户会话及 Origin;不能把票据交给另一个登录身份使用,也不能去掉 Cookie 只凭 URL 接入。HTTPS 使用 WSS,反向代理必须支持 Upgrade。
不要缓存授权 URL 到 localStorage、业务日志或永久链接。每次重新连接都申请新票据。关闭页面时释放 RFB 和 WebSocket。
权限与状态
实例必须运行、解锁且未回收,主机应在线。分配实例的原使用者被转交或撤权后,新的连接会被拒绝,已建立连接会按周期复核。
跨域直接嵌入不属于默认交付能力,需先与平台管理员明确入口和浏览器 Cookie 策略。不要暴露宿主机 VNC TCP 端口或转交内部主机认证密钥。
