自 8 月 12 日正式开源以来,ZSvirt 开始迎来来自全球各地用户的关注与反馈。从项目本身的定位、功能与技术能力,到安装部署、使用体验以及未来规划,用户在了解和尝试 ZSvirt 的过程中,也提出了许多值得认真回答的问题。
我们将它们归纳为 7 个大类、20 个具有代表性的问题,希望通过这组 FAQ,帮助大家更全面地了解 ZSvirt。由于内容较多,我们将分为上下两篇发布,带你逐一了解。

问题列表一览
-
安全部署与登录
-
问题 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[1],在现有虚拟化环境中部署。
使用 OVA 部署时,CPU、内存和磁盘大小采用官方 OVA 镜像的默认配置。使用 QCOW2 部署时,建议至少分配 8 vCPU、8 GiB 内存和一张管理网卡。
VMware 需启用“向客户机操作系统公开硬件辅助的虚拟化”,业务 VM 需另留资源。
参考:部署指南[2]
最小部署顺序:
-
导入镜像
-
配置管理 IP 并启动管理服务
-
登录平台
-
创建数据中心和集群
-
添加主机、数据存储和镜像存储
-
创建交换机与端口组
-
添加系统镜像并创建 VM
单机部署可用本机管理 IP 添加主机和镜像存储。
参考:最小部署流程[3]
问题 02:初始默认登陆凭据
Web UI 与系统账号分别管理,MN HA 填写对应节点的系统 SSH 凭据。
参考:登录说明[4]、HA 密码答复[5]
| 位置 | 凭据 |
|---|---|
| 初始 Web UI | admin / |
| ISO 安装后的系统终端与 SSH | 安装时设置、或之后修改的 root 密码 |
| 官方预制 OVA/qcow2 系统终端 | 初始 |
| MN HA 的 SSH 认证 | 两台管理节点各自的系统 SSH 账号和密码 |
强烈建议:首次登录后,请分别修改初始密码。
Discussion #10[6] 所述 Trekerlite 镜像的密码为 admin,仅适用于该镜像。
参考:预制镜像说明[7]、Trekerlite 答复[8]
问题 03:预制镜像首次启动后,如何配置管理 IP 并启动服务?
使用官方 OVA 或 qcow2 镜像首次启动后,需配置实际管理 IP 并启动管理服务。
参考:官方步骤[9]
配置静态管理 IP(推荐)
以 root 登录节点控制台,按工具提示选择管理网卡,配置静态地址并启动服务:
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 特性兼容要求;如需修改 VM 的 CPU 模式,应先关机。
参考:主机版本要求[10]、集群设置[11]、CPU 模式配置[12]
Windows、GPU 与 ARM 支持
问题 05:Windows 11 如何配置 vTPM 和安全启动?
ZSvirt 支持 vTPM 和安全启动(Secure Boot)。
使用前需准备可用的密钥提供程序,主机软件栈满足手册要求,VM 使用 UEFI。内置密钥提供程序须先备份;为已有 VM 添加 TPM 前,须先关机。
参考:vTPM 前提[13]、Secure Boot 配置入口[14]
-
在资源树根节点的“密钥提供程序”添加内置提供程序,执行“操作 > 备份”,选择密码保护并保存备份文件和密码。
-
新建 VM 时选择 Windows,在“高级设置 > 引导选项”选择 UEFI 并启用 Secure Boot,在“硬件信息 > 添加硬件 > TPM”添加 TPM。
-
进入 Windows 后,以管理员 PowerShell 检查 TPM 与安全启动状态:
Get-Tpm
Confirm-SecureBootUEFI
TpmPresent、TpmReady 应为 True,安全启动检查应返回 True。已有 Legacy 系统不能直接切换为 UEFI;使用 BitLocker 时,先将恢复密钥保存在 VM 外。
参考:密钥备份说明[15]
问题 06:支持 GPU 直通和 vGPU 吗?直通如何配置?
支持物理 GPU 直通与 vGPU。具体型号、驱动、切分方式及厂商授权需匹配。
参考:GPU 配置入口[16]、项目答复[17]
物理 GPU 直通按以下顺序配置:
-
启用 IOMMU/VT-d
-
确认平台识别 GPU
-
关闭 VM 并添加 GPU 设备
-
启动 VM 并安装客户机驱动
若开启 IOMMU 后尚未重启、平台仍显示不可用,将主机置于维护模式。平台会按维护策略自动迁移或停止 VM;待主机进入维护状态后,再重启主机使配置生效。
参考:IOMMU 生效条件[18]、维护模式处理源码[19]
问题 07:支持 aarch64 吗?后续有支持计划吗?
ZSvirt 暂无提供 aarch64 架构支持的计划。
参考:ARM 镜像答复[20]
网络与存储配置
问题 08:VLAN、DHCP 和 NAT 在哪里配置?支持 VPC/EIP 吗?
VLAN、DHCP 和 IP 地址管理均在分布式端口组配置。
-
进入“资源清单 > 网络资源”,右键目标分布式交换机,新建端口组。
-
选择 VLAN 类型和 VLAN ID,按需开启 IP 地址管理和 DHCP,填写网段、网关、地址池、DHCP 服务 IP 和 DNS。物理上联放行相应 VLAN;地址池避开网关、DHCP 服务 IP 和已用地址。
-
将 VM 网卡接入该端口组,默认网关填写该网段的实际网关。需要 NAT(网络地址转换)出网时,在出口路由器或防火墙上配置。 参考:端口组配置[21]
VPC/EIP
不支持。
问题 09:镜像存储需要独立服务器吗?如何将本地空闲盘或已有本地目录添加为数据存储?
镜像存储需要在平台中单独添加;单机体验时可复用管理节点,无须另备服务器。
镜像存储用于保存系统镜像和硬盘镜像;数据存储用于保存 VM 运行时的磁盘。
添加镜像存储
-
进入“资源清单 > 镜像与模板”,右键目标数据中心,选择“添加镜像存储”,类型选择“单机镜像仓库”。
-
填写存储节点 IP 和 SSH 凭据,测试连通性。复用管理节点时,填写管理节点的 IP 和系统 SSH 凭据。
-
添加方式选择“本地目录”,填写规划好的存储目录绝对路径,确认添加。
参考:单机部署示例[22]、添加单机镜像仓库[23]
使用本地空闲盘或已有目录添加数据存储
进入“资源清单 > 数据存储”,选中目标数据中心,点击“操作 > 添加数据存储”。类型选择“本地存储”并关联目标集群,再选择添加方式:
-
空闲硬盘:选择未挂载的本地空闲盘,填写挂载路径。该方式会格式化所选硬盘并清除全部数据。
-
本地目录:填写已有专用目录的绝对路径,使用其所在磁盘的可用空间。
确认配置无误后,点击“确定”完成添加。
本地存储的挂载路径不能使用 /、/dev、/proc、/sys 等系统目录。
参考:添加本地存储[24]
问题 10:ZSvirt 支持哪些数据存储类型?
ZSvirt 支持以下数据存储类型:
-
本地存储:使用主机上的本地硬盘或目录。
-
NFS 存储:通过 NFS 协议提供共享文件存储。
-
SAN 存储:通过 FC、iSCSI 或 NVMe 接入共享块存储。
-
Ceph 分布式存储:通过 Ceph 集群为虚拟机提供块存储。
参考:存储类型说明[25]、Ceph 存储说明[26]
参考资料
[1] OVA 和 qcow2 下载: https://zsvirt.io/download/
[2] 部署指南: https://docs.zsvirt.io/docs/quick-start/nested-virtualization-management-node
[3] 最小部署流程: https://docs.zsvirt.io/docs/quick-start
[4] 登录说明: https://docs.zsvirt.io/docs/quick-start
[5] HA 密码答复: https://github.com/ZSvirt/zsvirt/discussions/4
[6] Discussion #10: https://github.com/ZSvirt/zsvirt/discussions/10
[7] 预制镜像说明: https://docs.zsvirt.io/docs/quick-start/nested-virtualization-management-node
[8] Trekerlite 答复: https://github.com/ZSvirt/zsvirt/discussions/10
[9] 配置静态管理 IP: https://docs.zsvirt.io/docs/quick-start/nested-virtualization-management-node
[10] 主机版本要求: https://zsvirt.io/docs/faq/resource-inventory/host/host-addition-fails-with-a-libvirt-qemu-version-mismatch-error
[11] 集群设置: https://docs.zsvirt.io/docs/user-guide/compute/cluster/basic-operations
[12] CPU 模式配置: https://zsvirt.io/en/docs/user-guide/compute/vm/performance/cpu-features
[13] vTPM 前提: https://docs.zsvirt.io/docs/user-guide/compute/vm/security/vtpm
[14] Secure Boot 配置入口: https://docs.zsvirt.io/docs/user-guide/compute/vm/basic-operations/create-vm
[15] 密钥备份说明: https://docs.zsvirt.io/docs/user-guide/compute/vm/security/native-key-provider/backup
[16] GPU 配置入口: https://docs.zsvirt.io/docs/user-guide/compute/vm/basic-operations/create-vm
[17] 项目答复: https://github.com/ZSvirt/zsvirt/issues/18
[18] IOMMU 生效条件: https://zsvirt.io/docs/faq/resource-inventory/host/a-host-cannot-recognize-a-gpu-device-what-should-i-do
[20] ARM 镜像答复: https://github.com/ZSvirt/zsvirt/discussions/6
[21] 端口组配置: https://docs.zsvirt.io/docs/user-guide/network/network-resources/port-group/create
[22] 单机部署示例: https://docs.zsvirt.io/docs/quick-start
[23] 添加单机镜像仓库: https://docs.zsvirt.io/docs/user-guide/compute/image-storage/basic-operations/add-standalone-image-storage
[24] 添加本地存储: https://docs.zsvirt.io/docs/user-guide/storage/add-datastore/local-storage
[25] 存储类型说明: https://docs.zsvirt.io/docs/user-guide/getting-started/product-features
[26] Ceph 存储说明: https://zsvirt.io/docs/api-reference/storage-management/data-storage-apis/distributed-storage/add-ceph-primary-storage
加入社区
-
问题反馈:GitHub Issues
-
社区讨论:GitHub Discussions
-
社交媒体:
-
YouTube:https://youtube.com/@ZSvirt
-
X/Twitter:https://x.com/ZSvirt
-
Email:community@zsvirt.io
-
本文整理ZSvirt开源虚拟化平台的20个高频技术问题,涵盖安装部署(OVA/QCOW2体验、管理IP配置、主机添加要求)、Windows 11安全启动与vTPM配置、GPU直通流程、网络(VLAN/DHCP端口组配置)与存储(本地/NFS/SAN/Ceph支持)配置要点,以及API调用、迁移方案和社区参与方式,聚焦其作为轻量级开源虚拟化替代方案的技术能力边界。
348

被折叠的 条评论
为什么被折叠?



