自 8 月 12 日正式开源以来，ZSvirt 开始迎来来自全球各地用户的关注与反馈。从项目本身的定位、功能与技术能力，到安装部署、使用体验以及未来规划，用户在了解和尝试 ZSvirt 的过程中，也提出了许多值得认真回答的问题。

我们将它们归纳为 7 个大类、20 个具有代表性的问题，希望通过这组 FAQ，帮助大家更全面地了解 ZSvirt。由于内容较多，我们将分为上下两篇发布，带你逐一了解。

ZSvirt FAQ：来自全球用户的 20 个问题（上）问题列表一览

• 安全部署与登录

• 问题 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：平台选型与性能如何评估？有哪些自动化对接入口？

迁移与备份恢复

问题 11：从 VMware 迁入 ZSvirt，如何选择迁移方式？

可根据停机窗口和现有文件，选择 ZMigrate 在线迁移、OVF 整机导入或 VMDK 磁盘导入。

ZMigrate 在线迁移

适合批量迁移或需要缩短停机时间的场景。无须在源 VM 内安装代理，源 VM 运行时同步数据，最终割接时再停机。

操作顺序：部署 ZMigrate → 上传 VDDK → 配置数据网关 → 添加 VMware 源平台 → 创建迁移任务 → 同步并测试验证 → 停止源 VM 并割接。

在线迁移有并发限制；OVF、VMDK 离线导入不受该在线并发限制。

OVF 整机导入

适合可安排停机导出的场景。关闭源 VM，导出包含 .ovf、关联 VMDK 和 MF 文件的完整文件集，再通过“新建虚拟机 > 导入虚拟机”导入。

VMDK 磁盘导入

适合已有 VMDK、只需迁移磁盘数据的场景。将 VMDK 添加为平台镜像，平台按镜像存储类型自动转换为 qcow2 或 raw，再用镜像创建 VM。CPU、内存和网络需重新配置，BIOS 模式须与源 VM 一致。

参考：三种迁移方式与操作流程[1]、无代理迁移说明[2]、并发范围说明[3]

问题 12：OVF 如何导入？数据盘未识别怎么办？

OVF 导入需准备完整文件集，确保引用匹配，并配置可用的镜像存储。

支持单机及分布式镜像仓库，生成 VM 后默认自动清理对应临时模板。

1. 准备 .ovf、全部关联的 VMDK 和 MF 文件，文件名、个数及配置须与 OVF 描述一致。

2. 进入“新建虚拟机 > 导入虚拟机”，上传文件集，选择镜像存储、运行位置和目标数据存储，提交导入。

3. 导入后的硬盘 1 默认使用 IDE，数据盘使用 Virtio。客户机缺少 Virtio 驱动时，安装 VMTools 并启动后，系统才可识别数据盘。不要初始化原有数据盘。VMTools 安装[4]

参考：导入手册[5]

问题 13：Veeam 对接有何计划？内置备份、恢复和异地同步怎么做？

Veeam 对接所需的 API Proxy 包计划在后续版本提供，具体发布日期以官方发布为准。

当前推荐使用 ZSvirt 内置备份与恢复功能，操作步骤如下：

1. 添加备份存储；复用镜像存储时，选择已启用、已连接的单机镜像仓库，填写备份网络 CIDR。

2. 创建 VM 备份计划，选择对象、备份存储和策略；执行一次备份，等待生成成功的恢复点。

3. 在“数据保护 > 已保护资源”选择 VM 和成功的备份数据，点击“新建虚拟机”，配置运行位置和网络后创建。恢复验证时接入隔离网络，避免与源 VM 冲突。

适用条件

创建备份计划前，确认备份额度可用，VM 处于运行或暂停状态，且未加入其他备份计划。共享盘和 RDM 盘不在备份范围内。

参考：备份计划[6]、复用镜像存储[7]、恢复步骤[8]

提前添加异地备份存储后，可在备份计划中配置异地同步。使用异地备份创建 VM 前，需先将备份同步回本地备份存储。

API 与 SDK 调用

问题 14：Java SDK 如何初始化？HTTP 202 如何获取最终结果？

Java SDK 初始化使用 ZSClient.configure(config)。HTTP 202 表示已受理，仍需获取最终结果。

提示 setConfig() 未调用

使用 Action 的 call() 方法前，先创建并配置 ZSConfig 对象，再调用 ZSClient.configure(config)。报错中的 setConfig() 是提示文字中的错误方法名。

参考：SDK 初始化源码[9]

收到 HTTP 202

Java SDK 默认轮询获取最终结果；配置 WebHook 并接入回调处理后，通过回调获取结果。直接调用 REST API 时，对响应体中的 location 发起 GET 请求；若仍返回 202，则继续轮询，直至获得最终业务结果。失败信息见 error 字段。

参考：SDK 异步结果处理[10]、服务端结果查询

问题 15：ZSvirt 支持 API 对接吗？如何认证和调用？

ZSvirt 提供 RESTful API，支持 Session 和 AccessKey 签名认证。

• Session：账户登录 API 调用成功后，以响应中的 inventory.uuid 作为 Session UUID，请求头使用 Authorization: OAuth <SessionUUID>。

• AccessKey：在 Java SDK 的 Action 对象中填写 accessKeyId、accessKeySecret，由 SDK 签名；直接 REST 调用按文档生成 Authorization: ZStack <AccessKeyID>:<签名>，并携带与签名计算一致的 Date 请求头。

使用有效 Session 查询虚拟机：

curl -H 'Authorization: OAuth <SessionUUID>' \

  'http://<管理节点IP>:8080/zstack/v1/vm-instances'

示例 URL 按实际 API 地址替换；查询成功后，虚拟机列表位于响应的 inventories 字段。

参考：账户登录 API[11]、查询虚拟机 API[12]、AccessKey 认证[13]

文档与社区反馈

问题 16：官方文档在哪里？为什么保留 ZStack／ZSphere 的历史命名？

安装文档、用户手册、API 文档和分类 FAQ 均已开放。

ZSvirt 由 ZStack ZSphere 商业化项目开源并独立发展而来，部分代码、配置和文档仍保留 ZStack/ZSphere 的历史命名（如环境变量、配置项、依赖、路径、命令等）。这些命名仅用于兼容，不影响 ZSvirt 正常使用。

参考：命名说明[14]

问题 17：故障、功能需求和界面翻译问题如何反馈？

故障反馈需附可复现信息，功能请求需说明使用场景。

故障、功能需求和界面翻译问题提交到 Issues[15]，使用交流发布到 Discussions[16]。故障反馈请附：

ZSvirt／SDK 版本与部署方式：

服务器、系统、CPU、网络和存储：

复现步骤、预期结果与实际结果：

失败时间及其时区、任务／资源 ID：

原始错误与对应时段日志：

在 GitHub 提交 Issue 或发布 Discussion 前，请移除日志中的密码、令牌和业务敏感数据；界面翻译问题请附页面路径和原文。

参考：贡献指南[17]

问题 18：安全漏洞如何报告和处理？

疑似漏洞请通过安全邮箱私下报告：首选 security@zsvirt.io，备选 community@zsvirt.io。

不要在公开 Issue 披露漏洞细节。报告附受影响版本、复现条件、影响范围、脱敏证据及回联方式。

参考：项目安全政策

维护者按安全政策接收和验证报告，评估修复或缓解措施，并协调披露。

开源范围与平台选型

问题 19：开源版能免费用于生产吗？和 OpenStack 是什么关系？

ZSvirt 由 ZSphere 开源并独立发展，开源代码采用 GPLv3，可用于生产，无需支付平台许可费。

ZSvirt 采用独立技术路线，不是 OpenStack 衍生项目。

参考：开源范围说明[18]、生产使用与技术路线说明[19]

厂商驱动、第三方软件及商业服务遵循各自的许可和收费规则。

问题 20：平台选型与性能如何评估？有哪些自动化对接入口？

功能与管理方式可参考官方对比文章[20]；性能和兼容性需按 PoC 指南[21]，在目标硬件、存储和业务负载下验证。

自动化对接入口：REST API[22]、SDK[23]、Terraform Provider[24]。

参考资料

[1] 三种迁移方式与操作流程: https://zsvirt.io/zh/blog/zmigrate-workflow-walkthrough/

[2] 无代理迁移说明: https://zsvirt.io/zh/blog/why-we-open-sourced-zsvirt/

[3] 并发范围说明: https://zsvirt.io/zh/blog/two-weeks-after-open-sourcing-zsvirt

[4] VMTools 安装: https://docs.zsvirt.io/docs/user-guide/compute/vm/vmtools/install-windows

[5] 导入手册: https://docs.zsvirt.io/docs/user-guide/compute/vm/basic-operations/import-vm

[6] 备份计划: https://docs.zsvirt.io/docs/user-guide/compute/vm/vmtools/install-windows

[7] 复用镜像存储: https://zsvirt.io/docs/user-guide/backup/backup-storage/local/reuse-image-storage

[8] 恢复步骤: https://zsvirt.io/en/docs/user-guide/backup/restore/create-vm-from-backup

[9] SDK 初始化源码: https://zsvirt.io/en/docs/user-guide/backup/restore/create-vm-from-backup

[10] SDK 异步结果处理: https://github.com/ZSvirt/zsvirt/blob/4a4d3061b123596393ae577b29c0bc7f22627769/sdk/src/main/java/org/zstack/sdk/ZSClient.java#L320

[11] 账户登录 API: https://docs.zsvirt.io/en/docs/api-reference/system-management/user-configuration/log-in-by-account

[12] 查询虚拟机 API: https://docs.zsvirt.io/en/docs/api-reference/compute/vm/query-vm-instance

[13] AccessKey 认证: https://zsvirt.io/docs/api-reference/access-key

[14] 命名说明: https://zsvirt.io/docs/api-reference/access-key

[15] Issues: https://github.com/ZSvirt/zsvirt/issues

[16] Discussions: https://github.com/ZSvirt/zsvirt/discussions

[17] 社区贡献指南: https://github.com/ZSvirt/zsvirt/blob/main/CONTRIBUTING.md

[18] 开源范围说明:C https://github.com/ZSvirt/zsvirt/blob/main/CONTRIBUTING.md

[19] 生产使用与技术路线说明: https://zsvirt.io/zh/blog/two-weeks-after-open-sourcing-zsvirt

[20] ZSvirt vs Proxmox: https://zsvirt.io/blog/zsvirt-vs-proxmox-ve

[21] POC 指南: https://zsvirt.io/blog/evaluate-zsvirt-as-a-vmware-alternative

[22] REST API: https://docs.zsvirt.io/docs/api-reference

[23] SDK: https://zsvirt.io/docs/api-reference/sdk-specifications

[24] Terraform Provider: https://docs.zsvirt.io/docs/terraform-for-zsphere

加入社区

• 问题反馈：GitHub Issues

• 社区讨论：GitHub Discussions

• 社交媒体： 

• YouTube： https://youtube.com/@ZSvirt

• LinkedIn： https://www.linkedin.com/in/zsvirt-community/

• X/Twitter： https://x.com/ZSvirt

• Discord： https://discord.com/invite/KHsw63z9xA

• Email：community@zsvirt.io