问题说明
本文用于排查“第三方云管 / 跨网段 VNC”类问题。
适用环境
- 产品：ZCF
- 组件：Cloud
- 涉及对象：控制台/VNC
- 版本：4.x、5.x
- 场景：第三方云管 / 跨网段 VNC
问题现象
- 控制台白屏、noVNC/VNC 无法打开、第三方平台跨网段 VNC 失败。
- 业务网络或云主机本身可能正常，但控制台链路不可用。
可能原因
- 控制台代理地址、管理节点代理、VNC 端口、防火墙、跨网段路由或第三方云管回调地址异常。
- 双管理节点环境中代理地址与访问入口不一致。
排查步骤
- 记录控制台 URL、host 参数、proxy 地址、访问源和目标管理节点。
- 分别验证 VIP、管理节点、物理机和云主机 VNC 端口链路。
- 检查 console proxy/noVNC/nginx/management-server 日志。
- 第三方云管场景同时抓取第三方平台调用参数。
关键命令
ss -lntp | egrep '590|6080|7070|5443|5000'
grep -a -nE "novnc|vnc|console|proxy" /usr/local/zstack/apache-tomcat/logs/management-server.log* /var/log/nginx/* 2>/dev/null解决方案
- 按排查结果修复对应组件、配置、数据状态或链路问题。
- 若涉及数据库、底层存储、快照链、云主机磁盘、GPU 直通或管理服务重启，先确认备份、影响面和回滚路径。
验证方法
- 复核本文所述现象是否消失。
- 平台 UI、API、管理节点日志和底层命令输出能够相互印证。
- 至少观察一个相关任务周期或告警周期，确认问题不再复现。
风险与回滚
- 生产环境执行修复前必须确认客户业务影响、变更窗口和回滚方案。
- 涉及数据删除、数据库修改、快照链修复、底层文件处理和硬件操作时，建议联系 ZStack 官方技术支持确认。
注意事项
- 涉及云主机启动、迁移、HA、Unknown 状态或强制停止时，必须先确认云主机实际运行位置，防止脑裂、双写或误停业务。
- 涉及管理网、存储网、业务网、DHCP/VNC、VLAN、bond、端口组或交换机侧配置时，应保留可用管理通道，并优先在维护窗口执行。
- 若需要数据库修改、底层文件处理、锁释放、服务重启、驱动/固件升级或批量资源变更，应联系 ZStack 官方技术支持确认后再执行。