文档目录

问题说明

本文用于排查“Windows 卡住 / 控制台白屏 / RDP 不可用”类问题。

适用环境

  • 产品:ZCF
  • 组件:Cloud
  • 涉及对象:Windows云主机/控制台
  • 版本:4.x、5.x
  • 场景:Windows 卡住 / 控制台白屏 / RDP 不可用

问题现象

  • Windows 云主机卡住、控制台白屏、远程桌面无法登录,重启后可能恢复。

可能原因

  • Guest OS 内部资源、驱动、补丁、RDP 服务、内存压力或宿主机资源抖动。

排查步骤

  1. 先确认业务影响和是否允许重启。
  2. 收集云主机监控、Windows 事件日志、控制台截图和宿主机资源。
  3. 与同宿主机其他云主机对比,判断是单 VM 还是宿主机范围。

关键命令

grep -a -nE "<vmUuid>|qemu|libvirt|console|vnc" /usr/local/zstack/apache-tomcat/logs/management-server.log* /var/log/libvirt/qemu/*.log 2>/dev/null

解决方案

  • 按排查结果修复对应组件、配置、数据状态或链路问题。
  • 若涉及数据库、底层存储、快照链、云主机磁盘、GPU 直通或管理服务重启,先确认备份、影响面和回滚路径。

验证方法

  • 复核本文所述现象是否消失。
  • 平台 UI、API、管理节点日志和底层命令输出能够相互印证。
  • 至少观察一个相关任务周期或告警周期,确认问题不再复现。

风险与回滚

  • 生产环境执行修复前必须确认客户业务影响、变更窗口和回滚方案。
  • 涉及数据删除、数据库修改、快照链修复、底层文件处理和硬件操作时,建议联系 ZStack 官方技术支持确认。

注意事项

  • 涉及云主机启动、迁移、HA、Unknown 状态或强制停止时,必须先确认云主机实际运行位置,防止脑裂、双写或误停业务。
  • 涉及管理服务、数据库、证书、权限、审计和安全配置调整时,应先确认 HA 状态、业务窗口、回退方案和合规保留要求。
  • 若需要数据库修改、底层文件处理、锁释放、服务重启、驱动/固件升级或批量资源变更,应联系 ZStack 官方技术支持确认后再执行。
ZStack Cloud Windows 云主机控制台白屏且远程桌面无法登录排查 | 故障排查 · KB | ZStack 资源中心