# ZSvirt 开源 FAQ（上）：安装部署、GPU 支持与网络存储 10 问

> ZSvirt 开源后，社区反馈集中在安装部署、GPU 与 ARM 支持、网络与存储配置。本文整理其中 10 个高频问题，覆盖 OVA/qcow2 部署、默认登录凭据、Windows 11 vTPM、GPU 直通、端口组与数据存储配置，并附官方文档链接。

- 发布时间: 2026-10-27
- 更新时间: 2026-10-27
- 作者: [ZSvirt 团队](https://github.com/ZSvirt)
- 分类: 最佳实践
- 标签: ZSvirt, FAQ, 安装部署, GPU 直通, ARM, 存储, 网络, ZSvirt FAQ, ZSvirt 安装部署, ZSvirt 默认密码, ZSvirt GPU 直通, ZSvirt vGPU, ZSvirt aarch64, ZSvirt 数据存储, ZSvirt 镜像存储, ZSvirt VLAN 配置, ZSvirt 嵌套虚拟化

[图片可在规范 HTML 页面中查看: ZSvirt 社区 QA：20 个问题，带你了解 ZSvirt（上篇）](https://zsvirt.io/zh/blog/zsvirt-faq-part-1/)

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 镜像](https://zsvirt.io/zh/download/ "OVA 和 qcow2 下载")，在现有虚拟化环境中部署。**

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

最小部署顺序：

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

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

参考：[部署指南](https://docs.zsvirt.io/docs/quick-start/nested-virtualization-management-node "部署指南")、[最小部署流程](https://docs.zsvirt.io/docs/quick-start "最小部署流程")

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

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

参考：[登录说明](https://docs.zsvirt.io/docs/quick-start "登录说明")、[HA 密码答复](https://github.com/zsvirt/zsvirt/discussions/4 "HA 密码答复")

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

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

社区镜像 Trekerlite 的控制台密码为 `admin`，仅适用于该镜像（[Discussion #10](https://github.com/zsvirt/zsvirt/discussions/10 "Discussion #10")）。

参考：[预制镜像说明](https://docs.zsvirt.io/docs/quick-start/nested-virtualization-management-node "预制镜像说明")、[Trekerlite 答复](https://github.com/zsvirt/zsvirt/discussions/10 "Trekerlite 答复")

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

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

参考：[官方步骤](https://docs.zsvirt.io/docs/quick-start/nested-virtualization-management-node "配置静态管理 IP")

#### 配置静态管理 IP（推荐）

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

```bash
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，再执行：

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

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

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

主机需满足以下条件：

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

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

参考：[主机版本要求](https://docs.zsvirt.io/docs/faq/resource-inventory/host/host-addition-fails-with-a-libvirt-qemu-version-mismatch-error "主机版本要求")、[集群设置](https://docs.zsvirt.io/docs/user-guide/compute/cluster/basic-operations "集群设置")、[CPU 模式配置](https://docs.zsvirt.io/docs/user-guide/compute/vm/performance/cpu-features "CPU 模式配置")

## Windows、GPU 与 ARM 支持

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

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

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

参考：[vTPM 前提](https://docs.zsvirt.io/docs/user-guide/compute/vm/security/vtpm "vTPM 前提")、[Secure Boot 配置入口](https://docs.zsvirt.io/docs/user-guide/compute/vm/basic-operations/create-vm "Secure Boot 配置入口")

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

```powershell
Get-Tpm
Confirm-SecureBootUEFI
```

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

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

参考：[密钥备份说明](https://docs.zsvirt.io/docs/user-guide/compute/vm/security/native-key-provider/backup "密钥备份说明")

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

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

参考：[GPU 配置入口](https://docs.zsvirt.io/docs/user-guide/compute/vm/basic-operations/create-vm "GPU 配置入口")、[项目答复](https://github.com/zsvirt/zsvirt/issues/18 "项目答复")

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

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

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

```bash
virsh list
sync;sync;reboot
```

参考：[IOMMU 生效条件](https://docs.zsvirt.io/docs/faq/resource-inventory/host/a-host-cannot-recognize-a-gpu-device-what-should-i-do "IOMMU 生效条件")

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

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

参考：[ARM 镜像答复](https://github.com/zsvirt/zsvirt/discussions/6 "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（网络地址转换）出网时，在出口路由器或防火墙上配置。

参考：[端口组配置](https://docs.zsvirt.io/docs/user-guide/network/network-resources/port-group/create "端口组配置")

#### 支持 VPC／EIP 吗？

不支持。

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

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

#### 添加镜像存储

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

参考：[单机部署示例](https://docs.zsvirt.io/docs/quick-start "单机部署示例")、[添加单机镜像仓库](https://docs.zsvirt.io/docs/user-guide/compute/image-storage/basic-operations/add-standalone-image-storage "添加单机镜像仓库")

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

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

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

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

参考：[添加本地存储](https://docs.zsvirt.io/docs/user-guide/storage/add-datastore/local-storage "添加本地存储")

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

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

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

参考：[存储类型说明](https://docs.zsvirt.io/docs/user-guide/getting-started/product-features "存储类型说明")、[Ceph 存储说明](https://docs.zsvirt.io/docs/api-reference/storage-management/data-storage-apis/distributed-storage/add-ceph-primary-storage "Ceph 存储说明")

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

---

- 代码仓库：[https://github.com/zsvirt/zsvirt](https://github.com/zsvirt/zsvirt)
- 下载中心：[https://zsvirt.io/zh/download](https://zsvirt.io/zh/download)
- 文档中心：[https://zsvirt.io/docs](https://zsvirt.io/docs)

## 加入社区

- **问题反馈**：[GitHub Issues](https://github.com/zsvirt/zsvirt/issues)
- **社区讨论**：[GitHub Discussions](https://github.com/zsvirt/zsvirt/discussions)
- **社交媒体**：
  - YouTube：[https://youtube.com/@ZSvirt](https://youtube.com/@ZSvirt)
  - LinkedIn：[https://www.linkedin.com/in/zsvirt-community/](https://www.linkedin.com/in/zsvirt-community/)
  - X/Twitter：[https://x.com/ZSvirt](https://x.com/ZSvirt)
  - Discord：[https://discord.com/invite/KHsw63z9xA](https://discord.com/invite/KHsw63z9xA)
  - Email：[community@zsvirt.io](mailto:community@zsvirt.io)

## 官方链接


- [规范 HTML 页面](https://zsvirt.io/zh/blog/zsvirt-faq-part-1/)
- [在 GitHub 讨论](https://github.com/ZSvirt/zsvirt/discussions)