跳转到正文
皓量云擎文档

控制台接入

使用一次性票据与同源 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 端口或转交内部主机认证密钥。

本页目录