ZSvirt 社区 QA：20 个问题，带你了解 ZSvirt（上篇）

2026 年 8 月 12 日开源以来，ZSvirt 收到来自全球用户的反馈，问题涉及项目定位、功能与技术能力、安装部署、使用体验和后续规划。以下整理出 7 类共 20 个有代表性的问题，分上下两篇发布。上篇覆盖安装部署与登录、Windows/GPU/ARM 支持、网络与存储配置。

问题列表一览

  • 安装部署与登录
    • 问题 01：没有空闲服务器，怎么体验 ZSvirt？
    • 问题 02：初始默认登录凭据是什么？
    • 问题 03：预制镜像首次启动后，如何配置管理 IP 并启动服务？
    • 问题 04：添加主机有哪些要求？同一集群能用不同型号的 CPU 吗？
  • Windows、GPU 与 ARM 支持
    • 问题 05：Windows 11 如何配置 vTPM 和安全启动？
    • 问题 06：支持 GPU 直通和 vGPU 吗？直通如何配置？
    • 问题 07：支持 aarch64 吗？后续有支持计划吗？
  • 网络与存储配置
    • 问题 08：VLAN、DHCP 和 NAT 在哪里配置？支持 VPC／EIP 吗？
    • 问题 09：镜像存储需要独立服务器吗？如何将本地空闲盘或已有本地目录添加为数据存储？
    • 问题 10：ZSvirt 支持哪些数据存储类型？
  • 迁移与备份恢复
    • 问题 11：从 VMware 迁入 ZSvirt，如何选择迁移方式？
    • 问题 12：OVF 如何导入？数据盘未识别怎么办？
    • 问题 13：Veeam 对接有何计划？内置备份、恢复和异地同步怎么做？
  • API 与 SDK 调用
    • 问题 14：Java SDK 如何初始化？HTTP 202 如何获取最终结果？
    • 问题 15：ZSvirt 支持 API 对接吗？如何认证和调用？
  • 文档与社区反馈
    • 问题 16：官方文档在哪里？为什么保留 ZStack／ZSphere 的历史命名？
    • 问题 17：故障、功能需求和界面翻译问题如何反馈？
    • 问题 18：安全漏洞如何报告和处理？
  • 开源范围与平台选型
    • 问题 19：开源版能免费用于生产吗？和 OpenStack 是什么关系？
    • 问题 20：平台选型与性能如何评估？有哪些自动化对接入口？

安装部署与登录

问题 01：没有空闲服务器，怎么体验 ZSvirt？

可以下载官方 OVA 或 qcow2 镜像，在现有虚拟化环境中部署。

  • 使用 OVA：CPU、内存和磁盘沿用镜像默认配置。
  • 使用 qcow2：至少分配 8 vCPU、8 GiB 内存和一张管理网卡，并准备固定管理 IP。
  • 在 VMware 中部署时，需勾选“向客户机操作系统公开硬件辅助的虚拟化”，并为业务 VM 预留资源。

最小部署顺序：

  1. 导入镜像
  2. 配置管理 IP 并启动管理服务
  3. 登录平台
  4. 创建数据中心和集群
  5. 添加主机、数据存储和镜像存储
  6. 创建分布式交换机和端口组
  7. 添加系统镜像并创建 VM

单机部署时，主机和镜像存储的地址均填本机管理 IP。

参考：部署指南、最小部署流程

问题 02：初始默认登录凭据是什么？

Web UI 与系统账号分别管理；配置管理节点 HA 时，填写两台管理节点各自的 root SSH 密码。

参考：登录说明、HA 密码答复

位置 凭据
初始 Web UI admin／password
ISO 安装后的系统终端与 SSH 安装时设置的 root 密码，或之后修改的密码
官方预制 OVA／qcow2 系统终端 初始 root／zsvirt.123
管理节点 HA（MN HA）的 SSH 认证 两台管理节点各自的 root SSH 密码

首次登录后，应分别修改上述初始密码。

社区镜像 Trekerlite 的控制台密码为 admin，仅适用于该镜像（Discussion #10）。

参考：预制镜像说明、Trekerlite 答复

问题 03：预制镜像首次启动后，如何配置管理 IP 并启动服务？

使用官方 OVA 或 qcow2 镜像首次启动后，需要先配置管理 IP，再启动管理服务。在控制台按 Ctrl+Alt+F2 切换到登录终端，以 root 登录。

参考：官方步骤

配置静态管理 IP（推荐）

以下命令以 bond0 为例。按工具提示选择管理网卡，配置静态地址并启动服务：

zs-bond-ab -c bond0
zs-nic-to-bond -a bond0
zs-network-setting -i bond0 <管理节点IP> <子网掩码> <网关>
zstack-ctl change_ip --ip <管理节点IP>
zstack-ctl start

使用 DHCP 地址（按需）

已有 DHCP 地址时，在节点控制台执行 ip addr 确认实际管理 IP，再执行：

zstack-ctl change_ip --ip <管理节点IP>
zstack-ctl start

服务启动后，访问 https://<管理节点IP>。

问题 04：添加主机有哪些要求？同一集群能用不同型号的 CPU 吗？

主机需满足以下条件：

  • 使用平台支持的操作系统，QEMU／libvirt 版本与集群内其他主机一致；CPU 架构与集群一致，并开启硬件虚拟化。
  • 与管理节点双向连通，网卡匹配集群的分布式交换机。
  • 能够访问数据存储。

同一集群可以加入不同型号 CPU 的主机：集群“修改配置”中的“主机 CPU 型号检测”默认关闭；开启后，CPU 型号不一致会阻止添加主机和热迁移。跨型号热迁移仍需满足 CPU 特性兼容要求；修改 VM 的 CPU 模式前需先关机。

参考：主机版本要求、集群设置、CPU 模式配置

Windows、GPU 与 ARM 支持

问题 05：Windows 11 如何配置 vTPM 和安全启动？

ZSvirt 支持 vTPM 和安全启动（Secure Boot）。

使用前需满足：平台已配置可用的密钥提供程序；主机内核、QEMU、libvirt 版本符合 vTPM 支持要求；虚拟机使用 UEFI 引导；客户机系统支持 TPM 2.0。内置密钥提供程序须先备份；为已有虚拟机添加 vTPM 前，须先关机。

参考：vTPM 前提、Secure Boot 配置入口

  1. 在资源树根节点的“密钥提供程序”中添加内置提供程序，执行“操作 > 备份”，选择密码保护并保存备份文件和密码。
  2. 新建 VM 时选择 Windows，在“高级设置 > 引导选项”中选择 UEFI 并启用 Secure Boot，在“硬件信息 > 添加硬件 > TPM”中添加 vTPM。
  3. 进入 Windows 后，以管理员身份打开 PowerShell，检查 TPM 与安全启动状态：
Get-Tpm
Confirm-SecureBootUEFI

TpmPresent、TpmReady 应为 True，安全启动检查应返回 True。

已有 Legacy 系统不能直接切换为 UEFI；使用 BitLocker 时，先将恢复密钥保存在 VM 外。

参考：密钥备份说明

问题 06：支持 GPU 直通和 vGPU 吗？直通如何配置？

支持物理 GPU 直通与 vGPU。具体型号、驱动、切分方式和厂商授权需匹配。

参考：GPU 配置入口、项目答复

物理 GPU 直通按以下顺序配置：

  1. 启用 IOMMU／VT-d
  2. 确认平台识别 GPU
  3. 关闭 VM 并添加 GPU 设备
  4. 启动 VM 并安装客户机驱动

若开启 IOMMU 后平台仍显示不可用，通常是因为主机尚未重启。先迁移该主机上的 VM，再进入维护模式，确认无运行中的 VM 后重启：

virsh list
sync;sync;reboot

参考：IOMMU 生效条件

问题 07：支持 aarch64 吗？后续有支持计划吗？

目前下载页仅提供 x86_64 镜像，项目暂无提供 aarch64 镜像的计划。

参考：ARM 镜像答复

网络与存储配置

问题 08：VLAN、DHCP 和 NAT 在哪里配置？支持 VPC／EIP 吗？

VLAN、DHCP 和 IP 地址管理均在分布式端口组配置。

  1. 进入“资源清单 > 网络资源”，右键目标分布式交换机，新建端口组。
  2. 选择 VLAN 类型；选择标准 VLAN 时填写 VLAN ID。按需开启 IP 地址管理和 DHCP，填写网段、网关、地址池、DHCP 服务 IP 和 DNS。物理上联需放行对应 VLAN，地址池不要包含网关、广播地址、网络地址和 DHCP 服务 IP。
  3. 将 VM 网卡接入该端口组，默认网关填该网段的实际网关。需要 NAT（网络地址转换）出网时，在出口路由器或防火墙上配置。

参考：端口组配置

支持 VPC／EIP 吗？

不支持。

问题 09：镜像存储需要独立服务器吗？如何将本地空闲盘或已有本地目录添加为数据存储？

镜像存储需要在平台中单独添加；单机体验时可复用管理节点，无须另备服务器。镜像存储用于保存系统镜像和硬盘镜像，数据存储用于存放虚拟机磁盘。

添加镜像存储

  1. 进入“资源清单 > 镜像与模板”，右键目标数据中心，选择“添加镜像存储”，类型选择“单机镜像仓库”。
  2. 填写存储节点 IP 和 SSH 凭据，测试连通性。复用管理节点时，填写管理节点的 IP 和系统 SSH 凭据。
  3. 添加方式选择“本地目录”，填写规划好的存储目录绝对路径，确认添加。

参考：单机部署示例、添加单机镜像仓库

如何将本地空闲盘或已有目录添加为数据存储？

进入“资源清单 > 数据存储”，选中目标数据中心，点击“操作 > 添加数据存储”，类型选择“本地存储”并关联目标集群，再选择添加方式：

  • 空闲硬盘：选择未挂载的本地空闲盘，填写挂载路径。该方式会格式化所选硬盘并清除全部数据。
  • 本地目录：填写已有专用目录的绝对路径，使用其所在磁盘的可用空间。

确认配置无误后，点击“确定”完成添加。本地存储的挂载路径不能使用 /、/dev、/proc、/sys、/usr/bin、/bin 等系统目录。

参考：添加本地存储

问题 10：ZSvirt 支持哪些数据存储类型？

ZSvirt 支持以下数据存储类型：

  • 本地存储：使用主机上的本地硬盘或目录。
  • NFS 存储：通过 NFS 协议提供共享文件存储。
  • SAN 存储：通过 FC、iSCSI 或 NVMe 接入共享块存储。
  • Ceph 分布式存储：通过 Ceph 集群为虚拟机提供块存储。

参考：存储类型说明、Ceph 存储说明

下篇覆盖迁移与备份恢复、API 与 SDK、文档与社区反馈、开源范围与平台选型，共 10 个问题。

加入社区