virt-install 从 ISO 安装虚拟机完全指南-开发者社区

前言

在 KVM 虚拟化环境中，virt-install是最常用的命令行虚拟机创建工具。相比图形化的virt-manager，它更适合自动化脚本和批量部署场景。本文将从概念原理到实战操作，系统性地梳理通过 ISO 镜像使用virt-install安装虚拟机的完整流程，并深入解析常见参数的含义与配置要点。

一、什么是 virt-install？

virt-install是一个用于创建新虚拟机的命令行工具，支持 KVM、Xen 以及 Linux 容器等多种虚拟化技术。它通过libvirt虚拟化管理库与底层的 hypervisor 进行交互。

简单来说，virt-install是一个“胶水工具”——它将用户通过命令行参数指定的 CPU、内存、磁盘、网络和安装源等信息转换成 libvirt 能够识别的XML 配置文件，然后调用domainCreateXML接口完成虚拟机的创建。一旦虚拟机创建完成，生命周期管理就交由 libvirt 负责，virt-install随即退出。

virt-install支持的安装方式非常丰富：

本地 ISO 镜像或 CDROM 介质
远程网络安装：HTTP、FTP 或 NFS 协议的网络安装树
PXE 网络引导
导入现有磁盘镜像（跳过安装阶段）

二、工作原理简述

virt-install的工作流程可以概括为以下几个步骤：

参数解析与校验：解析命令行参数，校验必要参数是否完整
生成域 XML：将参数转换为 libvirt 标准的域（domain）XML 配置
调用 libvirt API：通过domainCreateXML接口创建虚拟机
启动安装：虚拟机启动后，从指定的安装源（如 ISO）引导系统，进入操作系统安装界面

整个过程中，libvirt 是核心枢纽，而 QEMU 则在 libvirt 的调度下完成具体的虚拟化工作。

三、准备工作

在执行virt-install之前，需要确认以下先决条件：

3.1 确认虚拟化支持

grep-E'(vmx|svm)'/proc/cpuinfo

如果输出中有vmx（Intel）或svm（AMD）标志，说明 CPU 支持虚拟化。

3.2 安装必要软件包

RHEL/CentOS/Fedora 系：

sudoyuminstallqemu-kvm libvirt virt-install-y

Ubuntu/Debian 系：

sudoaptinstallqemu-kvm libvirt-daemon-system virtinst-y

3.3 启动 libvirtd 服务

sudosystemctlenable--nowlibvirtd

四、核心参数详解

virt-install的参数数量众多，以下重点解析用户特别关注的几个核心参数。

4.1`--name`（虚拟机名称）

--name<guest_name>

指定虚拟机的名称，必须在同一 hypervisor 连接中唯一。如果要重新创建同名虚拟机，需要先用virsh shutdown和virsh undefine清理旧配置。

4.2`--memory`（内存分配）

--memory<size_in_MB>

为虚拟机分配的内存大小，单位为 MiB。例如--memory 2048表示分配 2GB 内存。

4.3`--vcpus`（虚拟 CPU）

--vcpus<number>

分配给虚拟机的虚拟 CPU 数量。可以进一步细化为--vcpus sockets=1,cores=2,threads=1来控制 CPU 拓扑结构。

4.4`--disk`（磁盘配置）

--disksize=<size_in_GB>

指定虚拟磁盘的大小和类型。默认会创建 qcow2 格式的磁盘镜像。也可以指定具体路径：

--diskpath=/var/lib/libvirt/images/myvm.qcow2,size=20

4.5`--cdrom`与`--location`（安装源）

--cdrom<iso_file_path>

从本地 ISO 镜像文件安装。

--location<http/ftp/nfs_url>

从网络安装树安装。

4.6`--osinfo`/`--os-variant`（操作系统类型）⭐

这是最关键但最容易被忽视的参数之一。

--osinfo<os_identifier>

指定客户机操作系统的类型和版本。正确设置该参数可以让virt-install自动配置合适的virtio 驱动、时钟源等优化选项。错误或缺失该参数会导致虚拟机虽然能启动，但性能不佳。

列出所有可用值：

virt-install--osinfolist# 或osinfo-query os

注意：--osinfo是较新版本中的参数，旧版本中对应的是--os-variant。

4.7`--network`（网络配置）⭐

--networknetwork=<network_name>

指定虚拟机使用的网络。常见配置方式：

默认 NAT 网络：
```
--networknetwork=default
```
桥接模式（虚拟机与宿主机同网段）：
```
--networkbridge=br0
```
指定网卡模型：
```
--networknetwork=default,model=virtio
```
virtio是半虚拟化网卡，性能远优于默认的 e1000。

4.8`--graphics`与 VNC 相关参数 ⭐

--graphicsvnc

启用 VNC 图形界面，用于远程查看虚拟机安装界面。

--vnclisten=0.0.0.0

指定 VNC 服务监听的 IP 地址。0.0.0.0表示监听所有网络接口，允许从任何 IP 访问 VNC。

--vncport=<port>

指定 VNC 监听的端口号（默认自动分配）。

完整示例：

--graphicsvnc,listen=0.0.0.0,port=5901

需要注意的是，将--vnclisten设为0.0.0.0会暴露 VNC 服务到网络，生产环境建议配合防火墙或使用 SPICE 加密协议。

4.9`--os-type`（操作系统类型）

--os-type=linux

指定操作系统类型（linux/windows）。在新版virt-install中，--osinfo已涵盖此功能，--os-type逐渐被取代。

五、完整操作示例

以下是一个通过 ISO 安装 Linux 虚拟机的完整命令：

virt-install\--namerhel9-vm\--memory4096\--vcpus2\--disksize=40\--osinforhel9.0\--cdrom/home/user/iso/rhel-9.0.iso\--networknetwork=default,model=virtio\--graphicsvnc,listen=0.0.0.0\--noautoconsole

参数说明：

--name rhel9-vm：虚拟机名称
--memory 4096：4GB 内存
--vcpus 2：2 个 vCPU
--disk size=40：40GB 虚拟磁盘
--osinfo rhel9.0：指定操作系统为 RHEL 9.0
--cdrom /home/user/iso/rhel-9.0.iso：ISO 安装源路径
--network network=default,model=virtio：使用默认 NAT 网络，virtio 网卡
--graphics vnc,listen=0.0.0.0：启用 VNC，监听所有接口
--noautoconsole：不自动打开控制台

六、权限问题深度解析（ERROR: Cannot access storage file）

6.1 问题现象

在执行virt-install时，如果 ISO 镜像或磁盘文件位于用户家目录（如/home/xxx/aarch64.img），可能会遇到以下错误：

ERROR Cannot access storage file '/home/xxx-aarch64.img' (as uid:107, gid:107): 权限不够

6.2 根本原因

这个问题的根本原因是：virt-install在通过libvirt启动 QEMU 进程时，QEMU 会放弃 root 权限，转而以qemu用户（uid:107, gid:107）的身份运行。

而qemu用户对普通用户的家目录（/home/xxx）默认没有访问权限。即使单独chown了 ISO 文件本身，qemu用户仍然无法“穿过”家目录到达该文件。

关键在于：目录的“执行权限”（x）决定了用户能否“穿过”该目录访问其中的内容。

6.3 解决方案汇总

方案一：修改目录和文件权限（推荐）

为qemu用户开放从家目录到镜像文件路径上每一级目录的执行权限：

# 为 /home 和 /home/xxx 添加执行权限sudochmoda+x /homesudochmoda+x /home/xxx# 修改镜像文件权限sudochown$USER:libvirt /home/xxx-aarch64.imgsudochmod660/home/xxx-aarch64.img

同时确保执行virt-install的用户属于libvirt组：

sudousermod-aGlibvirt$USER# 重新登录生效

方案二：切换到用户会话模式（qemu:///session）

使用--connect="qemu:///session"参数，让虚拟机进程以当前用户身份运行，从而避免跨用户权限问题：

virt-install--connect="qemu:///session"...# 其他参数不变

注意：会话模式对网络功能有一定限制，如无法使用桥接网络。

方案三：将镜像移至 libvirt 标准目录

将 ISO 和磁盘镜像移到/var/lib/libvirt/images/，该目录的权限专为虚拟机设计：

sudomv/home/xxx-aarch64.img /var/lib/libvirt/images/

方案四：使用 ACL 权限

使用setfacl为qemu用户授予特定权限：

sudosetfacl-mu:qemu:rx /home/xxxsudosetfacl-mu:qemu:r /home/xxx-aarch64.img

方案五：检查 SELinux

如果系统启用 SELinux，即使权限正确也可能被阻止。可临时测试：

sudosetenforce0

如果问题解决，则需要为镜像文件设置正确的 SELinux 上下文（virt_content_t），而非永久禁用。

七、注意事项与最佳实践

7.1 用户与权限

系统连接（qemu:///system，默认）：需要root 权限或用户属于libvirt组
会话连接（qemu:///session）：以普通用户身份运行，但网络功能受限
生产环境推荐使用系统连接 + libvirt 组成员的方式，兼顾安全与功能

7.2 安装源路径

避免将 ISO 放在家目录：这是权限问题的常见根源
推荐路径：/var/lib/libvirt/images/或专门的存储池目录
如果必须使用家目录，务必按第六节的方法配置权限

7.3 操作系统类型（–osinfo）

务必指定正确的--osinfo：直接影响虚拟机的性能优化
不确定时可用virt-install --osinfo list查询可用值
不同版本参数名可能不同：新版本用--osinfo，旧版本用--os-variant

7.4 网络配置

生产环境推荐使用桥接网络（bridge=br0）以获得更好的网络性能
虚拟网卡模型推荐virtio，性能优于默认的 e1000
会话模式（qemu:///session）不支持桥接网络

7.5 VNC 图形界面

--vnclisten=0.0.0.0会暴露 VNC 到所有网络接口，存在安全风险
生产环境建议：
- 配合防火墙限制访问来源
- 或使用SPICE协议（支持加密）
- 或通过 SSH 隧道转发 VNC 端口

7.6 自动化与无人值守

virt-install支持完全无人值守安装：

结合Kickstart文件（RHEL/CentOS）或preseed文件（Ubuntu）
使用--unattended参数简化自动化配置

7.7 虚拟机管理

虚拟机创建后，可使用virsh工具进行管理（启动、停止、删除等）
删除虚拟机前需先关闭：virsh shutdown <name>然后virsh undefine <name>

八、常见问题速查

问题	可能原因	解决方案
`Cannot access storage file`	qemu 用户无权访问家目录文件	参考第六节权限解决方案
虚拟机性能差	未指定或错误指定`--osinfo`	使用`--osinfo`指定正确的 OS 类型
VNC 无法连接	监听地址或防火墙问题	检查`--vnclisten`和防火墙规则
会话模式下网络不可用	会话模式不支持桥接	改用系统连接`qemu:///system`
`--os-variant`无法识别	参数名过时	改用`--osinfo`

结语

virt-install是 KVM 虚拟化环境中不可或缺的命令行工具，掌握它对于系统管理员和 DevOps 工程师来说至关重要。理解其工作原理、熟悉核心参数的含义、正确处理权限问题，是顺利使用该工具的关键。

在实际使用中，--osinfo的正确设置和镜像文件的权限管理是最容易出错的环节，值得特别关注。希望本文能帮助读者快速上手并规避常见陷阱。

前言