virt-install -husage: virt-install --name NAME --memory MB STORAGE INSTALL [options]
使用指定安装介质新建虚拟机
optional arguments:
-h, --help 输出帮助信息并退出
--version 输出版本号并退出
--connect URI 通过 libvirt URI 连接到 hypervisor
General Options:
-n NAME, --name NAME 客户端虚拟机名称
--memory MEMORY 指定虚拟机的内存大小(以MB为单位) Ex:
--memory 1024 (in MiB)
--memory 512,maxmemory=1024
--memory 512,maxmemory=1024,hotplugmemorymax=2048,hotplugmemoryslots=2
--vcpus VCPUS 配置虚拟机 vcpus 个数 Ex:
--vcpus 5
--vcpus 5,maxvcpus=10,cpuset=1-4,6,8
--vcpus sockets=2,cores=4,threads=2
--cpu CPU cpu 型号及功能 Ex:
--cpu coreduo,+x2apic
--cpu host-passthrough
--cpu host
--metadata METADATA 配置虚拟机元数据 Ex:
--metadata name=foo,title="My pretty title",uuid=...
--metadata description="My nice long description"
Installation Method Options:
--cdrom CDROM 光驱安装介质
-l LOCATION, --location LOCATION 发行版安装的 url eg. https://host/path.
--pxe 使用 pxe 协议通过网络引导
--import 在存储磁盘镜像中构建虚拟机
--livecd 将光驱介质视为 Live CD
-x EXTRA_ARGS, --extra-args EXTRA_ARGS 传递给从 --location 启动的安装内核的附加参数。
--initrd-inject INITRD_INJECT 将给定文件添加到 --location 的initrd根目录。
--boot BOOT 配置客户机启动设置. Ex:
--boot hd,cdrom,menu=on
--boot init=/sbin/init (for containers)
--idmap IDMAP 为LXC容器启用用户命名空间. Ex:
--idmap uid_start=0,uid_target=1000,uid_count=10
OS options:
--os-variant DISTRO_VARIANT 指定要安装的操作系统变种,以优化相关设置(如 virtio)。例如,--os-variant ubuntu20.04。
Device Options:
--disk DISK 指定存储设备,可以选择新建存储或使用现有存储。 Ex.
--disk size=10 (新建10GiB的镜像)
--disk /my/existing/disk,cache=none
--disk device=cdrom,bus=scsi
--disk=?
-w NETWORK, --network NETWORK
配置虚拟机的网络接口 Ex:
--network bridge=mybr0
--network network=my_libvirt_virtual_net
--network network=mynet,model=virtio,mac=00:11...
--network none
--network help
--graphics GRAPHICS 配置虚拟机的显示设置。 Ex:
--graphics vnc
--graphics spice,port=5901,tlsport=5902
--graphics none
--graphics vnc,password=foobar,port=5910,keymap=ja
--controller CONTROLLER
配置虚拟设备控制器。 Ex:
--controller type=usb,model=qemu-xhci
--controller virtio-scsi
--input INPUT 配置虚拟机的输入设备。 Ex:
--input tablet
--input keyboard,bus=usb
--serial SERIAL 配置串口
--parallel PARALLEL 配置并口设备。
--channel CHANNEL 配置虚拟机与主机之间的通信通道。
--console CONSOLE 配置虚拟机与主机之间的文本控制台连接
--hostdev HOSTDEV 配置物理USB/PCI设备共享给虚拟机。
--filesystem FILESYSTEM
将主机目录传递给虚拟机。 Ex:
--filesystem /my/source/dir,/dir/in/guest
--filesystem template_name,/,type=template
--sound [SOUND] 配置虚拟机的声音设备仿真。
--watchdog WATCHDOG 配置虚拟机的看门狗设备。
--video VIDEO 配置虚拟机的视频硬件。
--smartcard SMARTCARD
配置虚拟机的智能卡设备。 Ex:
--smartcard mode=passthrough
--redirdev REDIRDEV 配置设备重定向。 Ex:
--redirdev usb,type=tcp,server=192.168.1.1:4000
--memballoon MEMBALLOON
配置虚拟机 memballoon 设备. Ex:
--memballoon model=virtio
--tpm TPM 配置虚拟机的TPM设备。. Ex:
--tpm /dev/tpm
--rng RNG 配置虚拟机的随机数生成器。 Ex:
--rng /dev/urandom
--panic PANIC 配置虚拟机的崩溃处理。 Ex:
--panic default
--memdev MEMDEV 配置虚拟机的内存设备。 Ex:
--memdev dimm,target_size=1024
--vsock VSOCK 配置虚拟机的虚拟套接字。 Ex:
--vsock auto_cid=yes
--vsock cid=7
Guest Configuration Options:
--security SECURITY 设置域的安全驱动程序配置。
--cputune CPUTUNE 调整域进程的 CPU 参数。
--numatune NUMATUNE 调整域进程的 NUMA 策略。
--memtune MEMTUNE 调整域进程的内存策略。
--blkiotune BLKIOTUNE
调整域进程的块 I/O 策略。
--memorybacking MEMORYBACKING
设置域进程的内存背书策略。示例:--memorybacking hugepages=on。
--features FEATURES Set domain <features> XML. Ex:
--features acpi=off
--features apic=on,eoi=on
--clock CLOCK Set domain <clock> XML. Ex:
--clock offset=localtime,rtc_tickpolicy=catchup
--pm PM 配置 VM 电源管理功能。
--events EVENTS 配置 VM 生命周期管理策略。
--resource RESOURCE 配置 VM 资源分配(cgroups)。
--sysinfo SYSINFO 配置 SMBIOS 系统信息。 Ex:
--sysinfo host
--sysinfo bios_vendor=MyVendor,bios_version=1.2.3,...
--qemu-commandline QEMU_COMMANDLINE
直接将参数传递给 qemu 仿真器。 Ex:
--qemu-commandline='-display gtk,gl=on'
--qemu-commandline env=DISPLAY=:0.1
Virtualization Platform Options:
-v, --hvm 该客户机应为完全虚拟化的客户机。
-p, --paravirt 该客户机应为半虚拟化的客户机。
--container 该客户机应为容器客户机。
--virt-type VIRT_TYPE
要使用的虚拟化程序名称(如 kvm、qemu、xen 等)。
--arch ARCH 要模拟的 CPU 架构。
--machine MACHINE 要仿真的机器类型。
Miscellaneous Options:
--autostart 开机自启动虚拟机
--transient 创建一个短暂的域。短暂的域在安装完成后不会被保存。
--destroy-on-exit 当控制台查看器关闭时,强制关闭域。
--wait WAIT 等待安装完成的时间(分钟)。
--noautoconsole 不要自动尝试连接到客户机控制台。
--noreboot 完成安装后不要重启客户机。
--print-xml [XMLONLY]
打印生成的域XML,而不是创建客户机。这可以用于查看或调试生成的XML配置。
--dry-run 通过安装过程运行,但不创建设备或定义客户机。这可以用于检查配置是否正确。
--check CHECK 启用或禁用验证检查。例如,--check path_in_use=off 或 --check all=off 可以关闭特定的检查或全部检查。 Example:
--check path_in_use=off
--check all=off
-q, --quiet 禁止无错误输出
-d, --debug Print debugging information
Use '--option=?' or '--option help' to see available suboptions
See man page for examples and full option syntax.
















