问题说明
本文用于排查“ZSphere Windows 虚拟机控制台黑屏”类问题。
现象
- 打开虚拟机控制台出现黑屏。
- 尝试开启 Hyper-V 或修改引导模式后仍可能无法恢复。
- 需确认管理节点控制台端口是否可达。
适用环境
- 产品：ZVF
- 已验证版本：4.10.x
- 组件：ZSphere
- 涉及对象：控制台
- 场景：虚拟机运行类问题，需结合当前版本、部署形态、存储类型和操作时间线确认。
可能原因
- Guest OS 内部显示、显卡驱动或 Hyper-V 配置导致控制台无画面。
- 控制台代理端口、管理节点服务或浏览器连接异常。
- 虚拟机引导模式、光驱启动或系统进程状态异常。
排查步骤
按顺序执行以下检查，并记录受影响对象、发生时间、完整报错和当前状态。
- 先确认虚拟机是否实际运行，业务网络和远程桌面是否可达。
- 检查控制台代理端口和管理节点相关服务状态。
- 尝试从不同浏览器或网络访问控制台，排除前端连接问题。
- 在变更前记录虚拟机配置，谨慎调整 Hyper-V、显卡和引导模式。
处理方法
- 先确认虚拟机业务网络和远程访问是否正常，避免将控制台显示问题误判为虚拟机故障。
- 素材中的 Hyper-V 和引导模式调整未形成可复用的修复结论；如需修改虚拟机配置，应先备份原配置并联系 ZStack 官方技术支持确认。
验证方法
- 控制台可正常打开并持续显示虚拟机画面。
- 虚拟机业务网络、远程访问和管理服务日志均无同类异常。