知识库故障排查ZStack Cloud 云主机控制台黑屏排查

ZStack Cloud 云主机控制台黑屏排查

故障排查ZCF · Cloud适用版本4.x-4.8.38文章 IDKB-100147更新于2026-07-20

问题说明

提供 ZStack Cloud 云主机控制台打开后黑屏的结构化排查流程。控制台黑屏不一定表示云主机未启动,也可能是控制台协议、显卡类型、Guest OS 图形界面、迁移后驱动、GPU 透传、Windows 工具或系统内部程序异常导致。

现象

  • 云平台控制台窗口可以打开,但画面全黑或长时间无登录界面。
  • 云主机可通过 SSH、远程桌面或业务端口访问,但 VNC/控制台黑屏。
  • 迁移或导入后的 Linux/Windows 云主机启动后控制台黑屏。
  • GPU 透传云主机或安装性能优化工具后的云主机重启黑屏。
  • 修改启动项、关闭 virtio 或恢复快照后仍然黑屏。

适用环境

  • 产品:ZCF
  • 组件:Cloud
  • 涉及对象:ZStack Cloud;云主机、控制台、VNC/SPICE、显卡类型、性能优化工具、GPU 透传
  • 版本:4.x-4.8.38

登录查看余下内容,以及更多产品问题排查与解决经验。