KB

KB 的产品指南、组件文档与部署运维参考。

特定 i440fx 兼容机型存在 virtio-blk Discard 能力限制

麒麟 ARM 环境升级 Mellanox 驱动后网卡名称可能变化

特定麒麟 V10 内核环境下 AMD GPU 透传存在兼容性限制

可观测性分析采集鉴权失败后页面仍可能显示健康

可观测性分析修改日志采集目标后更新时间不刷新

可观测性分析日志级别筛选可能匹配正文关键词

可观测性分析完整错误信息可能被拆成多条日志

ZNS 网络服务基础架构容量区域可能显示暂无数据或不适用

Veeam API Proxy 1.0.3卸载后安装1.0.4因数据库残留失败

Windows 云主机使用特定 NVIDIA GPU 作为显示设备时 VNC 控制台可能黑屏

ZNS 应用市场安装后默认可用区未显示或内嵌界面无法访问

ZNS 网络服务跨层 DNAT-LB 同分段场景已知限制

ZNS 网络服务 Tier-1 DNAT 复用上联 Tier-0 网关路由接口 IP 已知限制

ZNS 网络服务四层负载均衡健康检查 LB_IP 保留行为说明

ZNS 网络服务四层负载均衡跨页选择后端成员时已选择数量显示不准确

ZNS 网络服务后端分段从 Tier-1 分离后后端成员仍可能显示 up

ZNS 网络服务四层负载均衡可能允许使用分段网络、网关或广播地址创建 VIP

ZNS 网络服务四层负载均衡 VIP 未统一校验全部已占用或保留 IP

ZNS 网络服务 OvsDpdk 高 CPS 短连接下可能出现少量连接超时或连接重置

ZNS 网络服务 Reflexive NAT 与高优先级 SNAT 命中时的出网源地址行为说明

大容量硬盘备份报 ioHung

同一虚拟机同时执行 CBT 与平台备份导致任务失败

图形化添加存储后主机重启进入 Emergency Mode

热迁移报失败但虚拟机已到目标主机

SAN 数据存储虚拟机导出 OVA 后再次启动进入文件系统 Emergency Mode

ZSphere 升级后同一端口组在不同主机上的网桥名称不一致

ZSphere CVE-2026-46333 / CVE-2026-43494 内核漏洞修复说明

自定义 XML 云主机启动异常修复补丁

DRS 迁移后云主机 GPU 丢失修复补丁

ZStack Cloud 清单标签显示异常修复补丁

子账户删除弹性伸缩组时 UI 卡顿修复补丁

HCI 旗舰版通用存储缓存盘快速更换

HCI 旗舰版通用存储资源下线与清理

HCI 旗舰版通用存储与高性能存储巡检方案

HCI 旗舰版 ZStone V5 升级方案

HCI 旗舰版版本升级（2.4.17 至 2.4.26）

HCI 旗舰版版本升级（2.2.20 至 2.4.26）

RGW 配额缓存调整

对象服务平台新增网关网络

ZCE-X 分布式存储调整存储池 PG 数量

ZCE-X Ceph 集群离线升级方案

ZCE-X Ceph 存储集群缩容

ZCE-X Ceph 存储节点缩容及新存储池创建

修改管理网络网关地址

ZCE-X 分布式存储逐盘缩容

新扩容存储节点开启 XDC 内核态

ZCE-X 升级 glib2 组件

单个 OSD 盘热插拔更换

ZCE-X 无外部时间源场景下手动校准集群时间

ZCE-X 新扩容存储节点升级及 XDC 内核态启用

对象存储数据池重平衡

ZCE-X 使用 logrotate 管理 PostgreSQL 日志

分布式存储恢复隔离 OSD

分布式存储更换缓存盘

存储节点更换硬盘

ZCE-X 存储节点缓存盘更换

ZCE-X 存储节点数据盘更换

ZCE-X 存储 4.2.x 至 5.2.x 在线升级

ZCE-X 存储 UI 标识显示异常修复

将 VPC 路由器迁移至副本存储池

deep-scrub 深度巡检优化

ZCenter Token 过期时间不满足业务要求，如何安全调整？

ZCenter 用户登录被锁定处理

云平台升级至4.8.x版本

ZStack Cloud 4.8.x 至 5.5.x 升级方案

云平台升级至5.5.x版本

云平台5.4.x升级至5.4.x版本

云平台5.4.x版本升级

云平台版本+物理机内核升级至553版本

管理节点添加异构repo源

CDP清理备份脏数据

ZStack Cloud 双管理节点 5.4.x 升级方案

双管理数据库不同步修复

双管理节点数据库重新同步及 zsha2 HA 套件升级

ZStack Cloud 双管理节点 HA 部署断电后管理数据库重新同步

在双管理节点 HA 环境下替换 ZStack Cloud 平台的 HTTPS 证书

在 ZStack Cloud 双管理节点 HA 部署上变更时间源（NTP）

修改物理机的管理网络网关

升级内核

物理机内核升级至553版本

ZStack Cloud 物理机内核升级

ZStack Cloud 物理机操作系统 CVE-2026-31431 漏洞修复

ZStack Cloud 物理机操作系统 CVE-2026-43284 漏洞修复

云平台升级一键升级脚本

ZStack Cloud OpenSSH CVE-2024-6387 与 8080 端口加固

升级OpenSSH版本

不受支持的 SFP 光模块导致物理网卡反复断开/重连告警

端口封禁与OpenSSH升级

更新阵列卡驱动

安全加固

ZStack Cloud 4.4.x ShareBlock sanlock 升级：处理主存储连接失败和锁未释放

ZStack Cloud 4.3.x ShareBlock sanlock 升级：处理 vgchange 卡住和锁未释放

调整云盘安装路径

云主机暂停故障报告

允许Traceroute探测漏洞修复

共享存储断开后 lvmlockd 泄漏 VG 共享锁导致云主机创建失败

物理机 root 密码轮换后云主机热迁移报 rsync "connection unexpectedly closed" 失败

vGPU 重新分区后云主机启动报“mediated device not found”

VNC控制台密码

5900~6050VNC端口禁用

云盘路径不一致导致快照创建报“unable to find volume”

通过 zstack-cli 开启 VPC 网络 DHCP 服务并修改 DHCP 服务 IP

VPC 管理网络与平台管理网络之间 TCP 8080 端口不通导致 VPC vRouter 创建超时

漏洞整改

漏洞修复

ZStack Cloud Windows SMB 445 端口风险处置

ZStack Cloud 与 ZCE-X 集群时区变更

双管理节点 HA 环境下将 ZStack Cube HCI 升级到 2.4.17

删除 ZStone 集群中的异常空存储池

ZStone 缓存盘数据刷盘

ZStone 存储节点缓存盘更换

ZStone 超融合管理节点重装与恢复

ZStone 超融合节点内存扩容

ZStone 主存储 Trash 卷清理与空间释放

Temporal 脑裂后在双管理节点上重建 PostgreSQL 和 Temporal

修改 NTP 时间源

HCI 旗舰版 ZStone 授权注册失败或 UKey 无法识别排查

HCI 旗舰版 ZStone 授权上传与双管理节点 UKey 状态异常排查

Veeam API Proxy安装时健康检查失败但服务随后正常

非默认HTTP端口环境中Veeam API Proxy连接平台超时

Veeam创建Worker失败并提示没有有效的主机可用

Veeam备份失败并提示data-agent未在16443端口就绪

Veeam中Windows虚拟机备份点的文件级恢复按钮置灰

Veeam创建Worker时初始化卡住且未自动关机

Windows 2008 云主机启动时蓝屏 0x0000005D

Windows 云主机启动时提示“INACCESSIBLE_BOOT_DEVICE”

添加云环境或测试云账号连接失败，如何排查？

ZCenter 服务因数据库连接异常无法启动或接口报错，如何排查？

ZCenter 部署或访问因端口未放通失败，如何排查？

ZCenter 数据库 Flyway 迁移失败排查

Gateway返回503且提示无可用服务实例，如何排查？

ZCenter 启用 HTTPS 后页面或 API 无法访问，如何排查？

ZCenter 监控报表无数据或页面空白，如何排查？

ZCenter 任务已执行但订单或操作状态一直处理中，如何排查 RabbitMQ？

ZCenter 登录或资源同步失败，如何确认并恢复 Redis？

ZCenter 资源同步失败排查

单个云账号或资源同步卡住并提示锁超时，如何排查？

重启承载 ZCenter 的虚拟机后服务持续循环启动，如何排查？

ZCenter 对接 ZSphere 提示 requestTimeTooSkewed，如何处理？

手动删除 ZSphere 平台连接后，ZMigrate 无法获取平台数据

ZSphere 迁移添加目标云平台 API 连通性校验失败

ZSphere 迁移保护进程接收或中转节点选项被锁住

ZSphere 迁移无法创建目标主机实例

ZSphere 虚拟机无法克隆或克隆按钮置灰

ZSphere 克隆报找不到备份存储或卷快照无法提交为镜像

ZSphere 导入 OVF 模板报上传 session 失效

ZSphere 快照容量异常且 UI 无快照信息

ZSphere 备份创建的单个快照无法在 UI 快照组中删除

ZSphere 添加主机失败且提示管理 VLAN 与集群默认 VLAN 不一致

ZSphere 初始化或添加主机因虚拟化未开启失败

ZSphere 添加超聚变物理机报 kvm_intel 模块加载失败

ZSphere 安装系统无法识别硬盘或 RAID 卡驱动未适配

ZSphere 缺少华为 Hi1822 SP680 网卡驱动

ZSphere 更新 IPMI 信息报 RMCP+ session 建立失败

ZSphere 嵌套环境 BMC/IPMI 组件导致主机 CPU 占用异常

ZSphere 分布式交换机无法绑定 bond 网卡

ZSphere 创建 VLAN 类型为无的分布式端口组失败

ZSphere UI 网卡状态与底层系统状态不一致

ZSphere 添加 SAN 数据存储报 mpath 设备被占用

ZSphere 对接 3PAR iSCSI 双活存储无法将 LUN 透传给虚拟机

ZSphere 升级失败并提示 unknown variable wait_timeout

ZSphere change_ip 后管理服务启动异常且数据库用户登录失败

ZSphere 单管理未配置 NTP 导致数据库启动失败

ZSphere 升级后 Windows 虚拟机网关丢失

ZSphere 云主机安装 VMTools 失败

ZSphere Windows 虚拟机控制台黑屏

ZSphere 多台 Windows 虚拟机黑屏死机后手动启动恢复

ZSphere 嵌套 Workstation 虚拟机报与 Hyper-V 不兼容

ZSphere HTTPS 443 端口 RSA 密钥交换漏洞处理

ZSphere 自签证书有效期设置边界

ZSphere 普通用户无法修改虚拟机硬盘容量

ZSphere 接管 ZStone 后导入 HCI 授权导致存储页面异常

ZSphere 高可用策略下网卡 down 后虚拟机未迁移

ZSphere/ZStone 环境批量触发 HA 云主机迁移

添加 AD/LDAP 服务器时测试连接失败，并显示“Cannot connect to LDAP/AD server”

备份失败并显示 block jobs not found 或 only found M

删除分布式交换机后，宿主机 bond 被删除

SBLK 厚置备硬盘全量克隆因镜像存储空间不足失败

主机有可用 CPU 和内存但 HA 启动仍提示 not enough capacity

主机添加上行链路后管理网失联

备份或快照请求返回 408 Request Timeout

安装 ZSphere 时管理节点启动失败，并停在 LicenseManager

修改 Linux 云主机主机名后，/etc/hosts 权限变为 0600

ZMigrate 无法获取 ZSphere 资源

更改主机后 UI 一直显示迁移中但底层无任务

NFS 备份服务器备份大文件失败，并显示 only found M block jobs

Vinchin 删除虚拟机快照后 SharedBlock availableCapacity 未恢复

第三方创建单硬盘快照后 ZSphere UI 不显示或删除异常

模板创建的虚拟机跨集群迁移报 No host available

Veeam 备份失败且旧 CBT 任务一直处于 Running

云主机高级监控中不显示内存指标

安装 VMTools 时提示云主机缺少光驱

删除单盘快照或快照组超时，并显示“block job not finished”

Windows 虚拟机已安装 VMTools，但平台显示未安装

Windows 虚拟机热添加 VirtIO 网卡后，首次配置网络失败

Windows Server 2025 虚拟机加入 AD 域并开启 VMX 后重启蓝屏

Windows 虚拟机配置静态 IP 后显示 Duplicate，并保留 APIPA 地址

Windows 虚拟机 VMTools 状态异常，VirtIO 驱动显示黄色感叹号

Windows 虚拟机已安装 VMTools 1.5.9，但仍提示版本较低

ZStack Cloud A100 GPU 透传任务超时排查

ZStack Cloud API 与 SDK 调用异常排查

ZStack Cloud 仲裁报警器周期性误报排查

ZStack Cloud 账单计费 UI 空白页排查

在Ceph 企业版主存储上创建云主机失败，该怎么处理？

ZStack Cloud 跨网段 VNC 远程登录失败排查

人为操作Ctrl+Alt+Del 组合键导致物理机失联，怎么办？

ZStack Cloud 弹性裸金属实例异常排查

ZStack Cloud GPU 与 vGPU 资源异常排查

高频调用云平台 API 导致审计日志增长过快

物理机内存占用过大，怎么办？

物理机异常重启，如何排查？

物理机修改chrony.conf 配置后会重置，怎么办？

物理机连接交换机需要从Access 模式切换为Trunk 模式，在云平台上需要怎么调整？

物理机上执行df -h 卡住，怎么办？

物理机hang 住，如何通过netconsole 排查？

物理机安装操作系统时报错Warning：dracut-initqueue timeout - starting timeoutscript，怎么办？

物理机重启后云主机无法正常启动，怎么办？

物理机SSH 失败，如何解决？

物理机网口状态为down，怎么办？

ZStack Cloud HTTP 通知对象告警内容为空排查

ZStack Cloud 镜像模板与镜像服务器异常排查

安装管理节点服务时数据库安装失败，如何解决？

云平台监控数据不显示，如何排查？

如何将 KVM 平台的云主机迁移至本云平台中？

负载均衡虚拟 IP 地址 ICMP 测试不可达，如何解决？

管理节点与浏览器时间不一致并出现时间漂移

ZStack Cloud 管理节点数据目录使用率误报排查

ZStack Cloud 管理节点数据库与密评插件密码资源异常内部排查

zops 任务卡住后管理节点 CPU 使用率过高

管理节点因 /var/log 目录权限异常导致 UI 服务无法启动

网络无异常但云主机SSH 连接慢，如何解决？

网关节点添加失败，如何解决？

ZStack Cloud 平台访问一直加载中排查

共享块存储因 lvmlock result -28 导致资源操作失败

单管理节点启动后无法打开UI 界面，如何解决？

ZStack Cloud 短信告警内容省略号截断排查

ZStack Cloud 快照克隆与镜像制作异常排查

云主机 SSH 密钥注入未生效

SSH 登录云主机失败，如何解决？

本地存储下云主机一直重启却无法启动，如何排查？

本地存储云盘无法正常访问，如何解决？

对于Ubuntu 系统的云主机，qemu-guest-agent 版本过低导致无法在线修改密码，怎么办？

ZStack Cloud UI 告警对象与实际资源不一致排查

ZStack Cloud UI 白屏且 UI 服务异常排查

ZStack Cloud UI 监控告警与权限显示异常排查

ZStack Cloud UI 任务进度卡住且云主机列表无法加载排查

云平台无法识别 USB 设备，怎么办？

如何卸载Linux 性能优化工具？

ZStack Cloud 升级版本依赖与授权异常排查

云平台升级后物理机失联，如何解决？

通过URL 方式添加镜像失败，怎么办？

ZStack Cloud userdata 注入失败排查

ZStack Cloud V2V 迁移后 Windows 云主机启动失败排查

如何在一个云主机上添加多块网卡？

云主机自动暂停，如何解决？

云主机绑定了 EIP，对外服务端口连接不稳定，经常出现连接异常的情况，怎么解决？

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

云主机创建失败，报错"can't apply global Icelake-Server- x86_64-cpu.pconfig"如何解决？

云主机创建镜像慢，怎么办？

ZStack Cloud 云主机开机 dhcp prepare timeout 排查

云主机克隆失败，怎么办？

物理机假死且存储心跳存活时云主机 HA 未触发

云主机访问对象存储时偶发“Cannot assign requested address”错误排查

云主机启动失败，怎么办？

ZStack Cloud 云主机启动异常与系统故障排查

为什么有的云主机关机时间比较久？

云主机无法ssh，如何解决？

云主机V2V 迁移后网络异常，如何解决？

使用 VMDK 镜像创建云主机时提示“not a bootable device”

对扩容云盘创建快照，恢复快照后云盘无法使用，如何解决？

控制面与数据面快照链不一致导致云盘快照删除失败排查

VyOS VPC 防火墙规则变更或重连后下发不完整

VPC 网络异常，如何解决？

VPC 路由器创建失败，如何解决？

Windows 安装性能优化工具出现“There is a problem with this Windows Installerpackage. A program run as partof the setup did not finish as expected Contact your supportpersonnel or package vendor”提示，怎么办？

ZStack Cloud Windows 根盘存储迁移长时间未完成排查

ZStack Cloud Windows 云主机控制台白屏且远程桌面无法登录排查

Windows 云主机获取不到 IP 地址，如何解决？

Windows 云主机无法识别新添加的硬盘，如何解决？

修改集群时间后 ceph -s 仍持续提示时钟偏移告警，如何消除？

添加主机后 CentOS 变为 Helix 系统导致主机添加失败，如何处理？

初始化添加主机失败且系统盘容量显示为 0，如何排查？

对象存储 bucket 分片过少导致 large omap objects 告警，如何处理？

断电测试后数据盘全部显示为未知状态，存储池出现 stale PG，如何恢复？

HCI 旗舰版 ZStone 页面无法下载请求码，如何处理？

ZStack Cloud 任务队列与 LongJob 异常排查

ZStack Cloud ZStone UI 无法登录与页面异常排查

ZStack Cloud 云主机状态异常排查