这是 virt-install 命令，可以使用我们的多个免费在线工作站之一在 OnWorks 免费托管服务提供商中运行，例如 Ubuntu Online、Fedora Online、Windows 在线模拟器或 MAC OS 在线模拟器
程序：
您的姓名
virt-install - 配置新的虚拟机
概要
安装virt [选项]...
商品描述
安装virt 是用于创建新的 KVM、Xen 或 Linux 容器来宾的命令行工具
使用“libvirt”管理程序管理库。 请参阅末尾的示例部分
本文档快速上手。
安装virt 工具支持使用（例如）VNC 或 SPICE 的图形安装，如
以及通过串行控制台安装的文本模式。 来宾可以配置为使用一个或
更多的虚拟磁盘、网络接口、音频设备、物理 USB 或 PCI 设备，其中
其他。
安装媒体可以在本地或远程保存在 NFS、HTTP、FTP 服务器上。 在里面
后一种情况“virt-install”将获取启动所需的最少文件
安装过程，允许来宾获取操作系统分发的其余部分作为
需要。 PXE 启动，并导入现有的磁盘映像（从而跳过安装
相）也支持。
给定合适的命令行参数，“virt-install”能够完全运行
无人看管，客人也自己“启动”。 这允许轻松自动化
来宾安装。
许多参数都有子选项，指定为 opt1=foo,opt2=bar 等。试试 --option=? 到
查看与该参数关联的子选项的完整列表，例如：virt-install
--磁盘=?
大多数选项不是必需的。 最低要求是--name、--memory、来宾存储
（--disk 或--filesystem），以及一个安装选项。
连接中 TO LIBVIRT
-c 的URI
- 连接 的URI
连接到非默认管理程序。 如果未指定，libvirt 将尝试并
选择最合适的默认值。
这里的一些有效选项是：
qemu:///系统
用于创建由系统 libvirtd 实例运行的 KVM 和 QEMU 来宾。 这个
是 virt-manager 使用的默认模式，也是大多数 KVM 用户想要的。
qemu:///会话
用于为以普通用户身份运行的 libvirtd 创建 KVM 和 QEMU 来宾。
xen:///
用于连接到 Xen。
lxc:///
用于创建 linux 容器
一般 配置
适用于所有类型来宾安装的通用配置参数。
-n 您的姓名
- 姓名 您的姓名
新来宾虚拟机实例的名称。 这在所有客人中必须是独一无二的
连接上的管理程序已知，包括当前未激活的那些。 到
重新定义一个现有的客人，使用 维尔什(1) 关闭它的工具 ('virsh shutdown')
& 在运行“virt-install”之前删除（'virsh undefine'）它。
- 记忆 配置
为来宾分配的内存，以 MiB 为单位。 子选项可用，如“maxmemory”
和“大页面”。 这将弃用 -r/--ram 选项。
使用 --memory=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elementsMemoryAllocation>
--记忆备份 配置
此选项将影响主机页面支持虚拟内存页面的方式。
使用 --memorybacking=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elementsMemoryBacking>
- 拱 拱
为来宾虚拟机请求非本机 CPU 架构。 如果省略，则
主机 CPU 架构将在来宾中使用。
- 机器 机
要模拟的机器类型。 这通常不需要为 Xen 或
KVM，但对于选择更奇特架构的机器类型很有用。
--元数据 选择=VAL，[...]
为来宾指定元数据值。 可能的选项包括名称、uuid、标题和
描述。 此选项弃用 -u/--uuid 和 --description。
使用 --metadata=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elementsMetadata>
--事件 选择=VAL，[...]
指定来宾的事件值。 可能的选项包括 on_poweroff、on_reboot、
和 on_crash。
使用 --events=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elementsEvents>
--资源 选择=VAL，[...]
为来宾指定资源分区。
使用 --resource=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#resPartition>
--vcpu 配置
为来宾配置的虚拟 CPU 数量。 如果指定了“maxvcpus”，则
在来宾运行时，来宾将能够热插拔至 MAX vcpus，但会
使用 VCPUS 启动。
CPU 拓扑可以另外指定为套接字、内核和线程。 如果
值被省略，其余的将自动填充，优先于内核而不是内核
线程。
'cpuset' 设置来宾可以使用的物理 CPU。 “CPUSET”是逗号分隔
数字列表，也可以在要排除的范围或 CPU 中指定。 例子：
0,2,3,5 : 使用处理器 0,2,3 和 5
1-5,^3,8 : 使用处理器 1,2,4,5 和 8
如果传递了值 'auto'，virt-install 会尝试自动确定一个
使用 NUMA 数据的最佳 CPU 固定（如果可用）。
使用 --vcpus=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elementsCPUAllocation>
——沼曲 配置
调整域进程的 NUMA 策略。 示例调用
--沼曲 1,2,3,4-7
--numatune 1-3,5，模式=首选
指定要从中分配内存的 numa 节点。 这与语法相同
“--cpuset”选项。 模式可以是“交错”、“首选”或“严格”之一（
默认）。 有关每种模式的信息，请参阅“man 8 numactl”。
使用 --numatune=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elementsNUMATuning>
--记忆 配置
调整域进程的内存策略。 示例调用
--内存1000
--memtune Hard_limit = 100，soft_limit = 60，swap_hard_limit = 150，min_guarantee = 80
使用 --memtune=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elementsMemoryTuning>
--blkiotune 配置
为域进程调整 blkio 策略。 示例调用
--blkiotune 100
--blkiotune权重=100，device_path=/dev/sdc，device_weight=200
使用 --blkiotune=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elementsBlockTuning>
- 中央处理器 型号[,+特征][,-特征][,匹配=匹配][,供应商=供应商]
配置向来宾公开的 CPU 型号和 CPU 功能。 唯一需要的值
是 MODEL，这是 libvirt 已知的有效 CPU 模型。
Libvirt 的特性策略值 force、require、optional、disable 或 forbid，或 with
速记 '+feature' 和 '-feature'，它们等于 'force=feature' 和
'disable=feature' 分别
一些例子：
- 中央处理器 core2duo,+x2apic,禁用=vmx
暴露core2duo CPU模型，强制启用x2apic，但不暴露vmx
- 中央处理器 主持人
将主机 CPU 配置公开给来宾。 这使客人能够
许多主机 CPU 功能的优势（更好的性能），但可能会导致
如果将来宾迁移到没有相同 CPU 的主机，则会出现问题。
- 中央处理器 仅限主机模型
向来宾公开最近的主机 CPU 模型配置。 这是最好的CPU
可用于任何主机上的访客。
使用 --cpu=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elementsCPU>
- 安全 类型=类型[，标签=标签][，重新标签=是|否]
配置域安全驱动程序设置。 类型可以是“静态”或“动态”。
“静态”配置需要安全标签。 指定没有 TYPE 的 LABEL
意味着静态配置。
要让 libvirt 自动应用您的静态标签，您必须指定 relabel=yes。
否则磁盘映像必须由管理员手动标记，包括
要求创建 virt-install。
使用 --security=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#seclabel>
- 特征 壮举=开|关，...
在客人中设置元素打开或关闭 XML。 示例包括 acpi、apic、eoi、
privnet 和 hyperv 功能。 一些例子：
- 特征 EOI=开
启用 APIC PV EOI
- 特征 hyperv_vapic=开，hyperv_spinlocks=关
启用 hypver VAPIC，但禁用自旋锁
- 特征 kvm_hidden=开
允许对访客隐藏 KVM 管理程序签名
- 特征 pvspinlock=开
通知来宾主机支持半虚拟自旋锁，例如
暴露 pvticketlocks 机制。
使用 --features=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elementsFeatures>
- 时钟 偏移=偏移，TIMER_OPT=VAL，...
配置来宾的XML。 一些支持的选项：
- 时钟 偏移=偏移
设置时钟偏移，例如。 'utc' 或 'localtime'
- 时钟 TIMER_present=否
禁用布尔计时器。 这里的 TIMER 可能是 hpet、kvmclock 等。
- 时钟 TIMER_tickpolicy=VAL
设置计时器的 tickpolicy 值。 这里的 TIMER 可能是 rtc、pit 等。 VAL 可能是
追赶、延迟等。有关所有值，请参阅 libvirt 文档。
使用 --clock=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elementsTime>
- 下午 配置
配置访客电源管理功能。 示例子选项包括
suspend_to_mem=on|off 和 suspend_to_disk=on|off
使用 --pm=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elementsPowerManagement>
安装 配置
- 光盘 配置
用作虚拟 CD-ROM 设备的文件或设备。 它可以是 ISO 映像的路径，也可以是
CDROM 设备。 它也可以是从中获取/访问最小引导 ISO 的 URL
图片。 URL 的格式与“--location”参数所描述的格式相同。 如果一个
cdrom 已通过“--disk”选项指定，“--cdrom”或任何其他
指定安装选项，“--disk”光盘用作安装介质。
-l 地点
- 地点 配置
分发树安装源。 virt-install 可以识别某些发行版
树并获取可引导的内核/initrd 对以启动安装。
使用 libvirt 0.9.4 或更高版本，网络 URL 安装适用于远程连接。 虚拟-
install 将下载 kernel/initrd 到本地机器，然后上传媒体到
远程主机。 此选项要求本地和本地都可以访问该 URL。
远程主机。
--location 允许诸如 --extra-args 之类的内核参数，并使用
--initrd-注入。 如果您想将这些选项用于 CDROM 媒体，您有一些
opţiuni:
* 以 root 身份运行 virt-install 并执行 --location ISO
* 将 ISO 挂载到本地目录，并执行 --location DIRECTORY
* 将 ISO 挂载到本地目录，通过本地 http 导出该目录，然后执行
- 地点 http://localhost/DIRECTORY
“LOCATION”可以采用以下形式之一：
http://host/path
包含可安装分发映像的 HTTP 服务器位置。
ftp://主机/路径
包含可安装分发映像的 FTP 服务器位置。
nfs:host:/path 或 nfs://host/path
包含可安装分发映像的 NFS 服务器位置。 这需要
以 root 身份运行 virt-install。
目录
包含可安装分发映像的本地目录的路径。 注意
初始启动后，来宾将无法访问该目录，因此操作系统
安装程序将需要另一种方式来访问其余的安装媒体。
ISO 挂载 ISO 并探测目录。 这需要以 root 身份运行 virt-install，
并具有与 DIRECTORY 相同的 VM 访问警告。
一些发行版特定的 url 示例：
基于 Fedora/Red Hat
http://download.fedoraproject.org/pub/fedora/linux/releases/21/Server/x86_64/os
Debian
http://ftp.us.debian.org/debian/dists/stable/main/installer-amd64/
Ubuntu
http://us.archive.ubuntu.com/ubuntu/dists/wily/main/installer-amd64/
SUSE
http://download.opensuse.org/distribution/11.0/repo/oss/
的Mandriva
ftp://ftp.uwsg.indiana.edu/linux/mandrake/official/2009.0/i586/
Mageia
ftp://distrib-coffee.ipsl.jussieu.fr/pub/linux/Mageia/distrib/1
--pxe
使用 PXE 启动协议加载初始 ramdisk 和内核以启动
来宾安装过程。
- 进口
跳过操作系统安装过程，并围绕现有磁盘映像构建来宾。 这
用于引导的设备是通过“--disk”或“--filesystem”指定的第一个设备。
--livecd
指定安装介质是 Live CD，因此来宾需要
配置为永久关闭 CDROM 设备。 也可能需要使用
“--disk none”标志的组合。
-x 额外服务
--额外参数 配置
执行执行时要传递给安装程序的其他内核命令行参数
从“--location”来宾安装。 一种常见用法是指定 anaconda kickstart
用于自动安装的文件，例如 --extra-args "ks=http://myserver/my.ks"
--initrd-注入 PATH
将 PATH 添加到使用“--location”获取的 initrd 的根目录。 这可以用来运行
无需网络托管的 kickstart 文件的自动安装：
--initrd-inject=/path/to/my.ks --extra-args "ks=file:/my.ks"
--os-变体 操作系统_VARIANT
优化特定操作系统的来宾配置（例如“fedora18”、
'rhel7'、'winxp'）。 虽然不是必需的，但强烈推荐指定此选项，
因为它可以通过在其他来宾调整中指定 virtio 来大大提高性能。
默认情况下，virt-install 会尝试从安装媒体中自动检测这个值
（目前仅支持 URL 安装）。 可以使用以下命令禁用自动检测
特殊值“无”。 可以使用特殊值“auto”强制自动检测。
使用命令“osinfo-query os”获取已接受的操作系统变体的列表。
--引导 靴子
（可选）指定安装后 VM 引导配置。 此选项允许
指定引导设备顺序，使用选项永久引导内核/initrd
内核参数，并启用 BIOS 启动菜单（需要 libvirt 0.8.3 或更高版本）
除了其他安装选项（例如 --location、
--cdrom 等）或可以单独指定。 在后一种情况下，行为是相似的
到 --import 安装选项：没有“安装”阶段，来宾刚刚创建
并按规定启动。
一些例子：
--引导 cdrom,fd,hd,网络,菜单=on
设置启动设备优先级为先光驱、先软盘、先硬盘、网络
PXE 启动。 另外启用 BIOS 启动菜单提示。
--引导 kernel=KERNEL,initrd=INITRD,kernel_args="console=/dev/ttyS0"
让来宾永久启动本地内核/initrd 对，并使用指定的
内核选项。
--引导 内核=内核，initrd=INITRD，dtb=DTB
让来宾通过外部设备永久启动本地内核/initrd 对
树二进制。 某些非 x86 配置（如 ARM 或 PPC）可能需要 DTB
--引导 加载程序=BIOSPATH
使用 BIOSPATH 作为虚拟机 BIOS。
--引导 菜单=on，useserial=on
启用 bios 启动菜单，并启用通过串口发送 bios 文本输出
安慰。
--引导 初始化=初始化路径
容器来宾将初始化的二进制文件的路径。 如果根“--filesystem”有
已指定，virt-install 将默认为 /sbin/初始化, 否则将默认为
/bin/sh。
--引导 UEFI
将 VM 配置为从 UEFI 引导。 为了让 virt-install 知道正确的
UEFI 参数，libvirt 需要通过以下方式通告已知的 UEFI 二进制文件
domcapabilities XML，所以这可能只有在使用正确配置的情况下才有效
发行版软件包。
--引导
loader=/.../OVMF_CODE.fd,loader_ro=yes,loader_type=pflash,nvram_template=/.../OVMF_VARS.fd
指定虚拟机使用自定义 OVMF 二进制文件作为引导固件，
映射为虚拟闪存芯片。 此外，请求 libvirt 实例化
来自自定义“/.../OVMF_VARS.fd” varstore 模板的 VM 特定 UEFI varstore。
这是推荐的 UEFI 设置，如果 --boot uefi 不知道应该使用
关于您的 UEFI 二进制文件。
使用 --boot=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elementsOS>
--idmap 配置
如果来宾配置声明了 UID 或 GID 映射，则“用户”命名空间将是
能够应用这些。 适当配置的 UID/GID 映射是执行以下操作的先决条件
在没有 sVirt 限制的情况下，使容器安全。
--idmap 可以指定为 LXC 容器启用用户命名空间
示例：
--idmap
uid_start=0,uid_target=1000,uid_count=10,gid_start=0,gid_target=1000,gid_count=10
使用 --idmap=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elementsOSContainer>
储存 配置
--磁盘 配置
使用各种选项指定要用作来宾存储的媒体。 一般
磁盘字符串的格式是
--磁盘 opt1=val1,opt2=val2,...
创建新的 10G 磁盘映像和关联的磁盘设备的最简单调用：
--磁盘大小=10
virt-install 会生成一个路径名，并将它放在默认的镜像位置
管理程序。 要指定媒体，命令可以是：
--磁盘/一些/存储/路径[，opt1 = val1] ...
或明确指定以下参数之一：
径
要使用的某些存储介质的路径，无论是否存在。 现有媒体可以是文件
或块设备。
指定一个不存在的路径意味着尝试创建新的存储，并且
将需要指定一个“大小”值。 即使对于远程主机， virt-install 也会
尝试使用 libvirt 存储 API 来自动创建给定的路径。
如果管理程序支持它， 径 也可以是网络 URL，例如
http://example.com/some-disk.img . 对于网络路径，它们管理程序将
直接访问存储，本地不下载任何内容。
池
要在其上创建新存储的现有 libvirt 存储池名称。 需要
指定“大小”值。
第一卷 要使用的现有 libvirt 存储卷。 这被指定为
'池名/卷名'。
其他可用选项：
设备
磁盘设备类型。 值可以是“cdrom”、“disk”、“lun”或“floppy”。 默认是
“磁盘”。 如果指定了 'cdrom' 并且没有选择安装方法，则该 cdrom 是
用作安装介质。
引导顺序
具有多个磁盘的来宾安装将需要此参数才能正确引导
安装后。 boot_order 参数将取值 1,2,3,... 设备
值越低优先级越高。
总线 磁盘总线类型。 值可以是“ide”、“sata”、“scsi”、“usb”、“virtio”或“xen”。 这
默认值依赖于管理程序，因为并非所有管理程序都支持所有总线类型。
可拆卸
设置可移动标志 (/系统/块/$dev/removable 在 Linux 上）。 仅用于 QEMU
和总线= USB。 值可以是“开”或“关”。
只读
将驱动器设置为只读（“打开”或“关闭”）
可分享的
将驱动器设置为可共享（“打开”或“关闭”）
尺寸
创建新存储时使用的大小（以 GiB 为单位）
疏
是否跳过完全分配新创建的存储。 值为“是”或“否”。
默认为“是”（不完全分配），除非它不受支持
底层存储类型。
完全分配来宾虚拟磁盘所花费的初始时间 (sparse=no)
通常通过来宾内部更快的安装时间来平衡。 因此使用这个
推荐选项以确保始终如一的高性能并避免 I/O
如果主机文件系统填满，来宾中的错误。
支持存储
用作新创建映像的后备存储的磁盘的路径。
缓存
要使用的缓存模式。 主机页面缓存提供缓存内存。 缓存
值可以是“none”、“writethrough”、“directsync”、“unsafe”或“writeback”。
'writethrough' 提供读缓存。 'writeback' 提供读写缓存。
'directsync' 绕过主机页面缓存。 “不安全”可能会缓存所有内容和
忽略来自来宾的刷新请求。
丢弃
是否忽略或传递丢弃（也称为“修剪”或“取消映射”）请求
到文件系统。 该值可以是“unmap”（允许丢弃请求
被传递）或“忽略”（忽略丢弃请求）。 从 1.0.6 (QEMU 和 KVM
只有）
格式
磁盘映像格式。 对于文件卷，这可以是“raw”、“qcow2”、“vmdk”等。请参见
格式输入http://libvirt.org/storage.html> 可能的值。 这是
通常映射到 驱动程序类型 价值也是如此。
如果在创建文件图像时未指定，则默认为“qcow2”。
如果创建存储，这将是新图像的格式。 如果使用一个
现有映像，这会覆盖 libvirt 的格式自动检测。
司机姓名
管理程序在访问指定存储时应使用的驱动程序名称。
通常不需要由用户设置。
驱动程序类型
管理程序在访问指定存储时应使用的驱动程序格式/类型。
通常不需要由用户设置。
io 磁盘 IO 后端。 可以是“线程”或“本机”。
错误策略
如果遇到写入错误，来宾应如何反应。 可以是“停止”之一，
“忽略”或“空间”
串行
模拟磁盘设备的序列号。 这个是在linux来宾中用来设置的
/dev/disk/by-id 符号链接。 示例序列号可能是：WD-WMAP9A966149
启动策略
如果源文件不可访问，它定义了如何处理磁盘。 看
可能的值http://www.libvirt.org/formatdomain.html#elementsDisks>
有关某些用途，请参阅示例部分。 此选项弃用 -f/--file，
-s/--file-size、--nonsparse 和--nodisks。
使用 --disk=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elementsDisks>
- 文件系统
指定主机上要导出到来宾的目录。 最简单的调用
是：
--文件系统/source/on/host,/target/point/in/guest
这适用于最近的 QEMU 和 linux 来宾操作系统或 LXC 容器。 对于 QEMU，
target point只是sysfs中的一个挂载提示，所以不会自动挂载。
可以指定以下显式选项：
类型
类型或源目录。 有效值为 'mount'（默认值）或
OpenVZ 模板的“模板”。
模式
来自来宾操作系统的源目录的访问模式。 仅用于 QEMU
和类型=安装。 有效模式为“passthrough”（默认）、“mapped”或
'壁球'。 有关详细信息，请参阅 libvirt 域 XML 文档。
资源
主机上要共享的目录。
目标
要在来宾中使用的安装位置。
使用 --filesystem=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elements文件系统>
NETWORKING 配置
-w 配置
- 网络 配置
将来宾连接到主机网络。 “NETWORK”的值可以是 4 个之一
格式：
桥=桥
连接到主机中名为“BRIDGE”的桥接设备。 如果
主机具有静态网络配置 & 来宾需要完整的出站和入站
与 LAN 的连接。 如果实时迁移将与
这位客人。
网络=名称
连接到主机中名为“NAME”的虚拟网络。 虚拟网络可以
使用“virsh”命令行工具列出、创建、删除。 在一个未修改的
安装“libvirt”通常会有一个名为“default”的虚拟网络。
如果主机具有动态网络（例如 NetworkManager），则使用虚拟网络，或
使用无线。 来宾将通过任何连接被 NAT 连接到 LAN
积极的。
类型=直接，来源=IFACE[，来源模式=模式]
使用 macvtap 直接连接到主机接口 IFACE。
用户
使用 SLIRP 连接到 LAN。 仅当运行 QEMU 来宾作为
非特权用户。 这提供了一种非常有限的 NAT 形式。
没有
告诉 virt-install 不要添加任何默认网络接口。
如果省略此选项，将在来宾中创建单个 NIC。 如果有一个
主机中具有被奴役的物理接口的桥接设备，将用于
连通性。 否则，将使用名为“default”的虚拟网络。 这个
可以多次指定选项以设置多个 NIC。
其他可用的选项是：
模型
访客看到的网络设备模型。 值可以是任何支持的 nic 模型
管理程序，例如：'e1000'、'rtl8139'、'virtio'、...
MAC 固定来宾的MAC地址； 如果省略此参数，或值
“RANDOM”指定一个合适的地址将随机生成。 对于 Xen
虚拟机要求 MAC 地址中的前 3 对是
序列 '00:16:3e'，而对于 QEMU 或 KVM 虚拟机，它必须是 '52:54:00'。
过滤器引用
在 libvirt 中控制防火墙和网络过滤。 值可以是任何 nwfilter
由“virsh”'nwfilter' 子命令定义。 可用的过滤器可以通过以下方式列出
运行“virsh nwfilter-list”，例如：“clean-traffic”、“no-mac-spoofing”、...
虚拟端口类型
虚拟端口配置文件的类型，以下值之一
“802.Qbg”
接受以下附加参数
虚拟端口管理器
VSI 管理器 ID 标识包含 VSI 类型和
实例定义。 这是一个整数值，值 0 是
保留。
虚拟端口类型ID
VSI 类型 ID 标识表征网络访问的 VSI 类型。
VSI 类型通常由网络管理员管理。 这是一
整数值。
虚拟端口类型 ID 版本
VSI 类型版本允许一个 VSI 类型有多个版本。 这是一
整数值。
虚拟端口实例ID
VSI 实例 ID 标识符是在一个 VSI 实例（即一个
虚拟机的虚拟接口）被创建。 这是一个全球
唯一标识符。
“802.Qbh”
接受以下附加参数
虚拟端口_profileid
配置文件 ID 包含要应用的端口配置文件的名称
到这个界面。 此名称由端口配置文件数据库解析为
端口配置文件中的网络参数，以及那些网络参数
将应用于此接口。
“开放式交换机”
接受以下附加参数
虚拟端口_profileid
接口的 OpenVSwitch 端口配置文件
虚拟端口接口ID
用于唯一标识接口的 UUID。 如果省略一个将是
自动生成
“米多网”
接受以下附加参数
虚拟端口接口ID
一个 UUID 标识网络中接口将连接到的端口
界
使用 --network=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elementsNICS>
此选项弃用 -m/--mac、-b/--bridge 和 --nonetworks
图形 配置
如果没有指定图形选项，“virt-install”将尝试选择合适的
如果设置了 DISPLAY 环境变量，则使用图形，否则使用“--graphics none”。
--图形 类型,opt1=arg1,opt2=arg2,...
指定图形显示配置。 这不会配置任何虚拟
硬件，就是如何访问来宾的图形显示。 通常用户
不需要指定这个选项，virt-install 会尝试选择一个有用的
默认，并启动合适的连接。
图形字符串的一般格式是
--图形类型,opt1=arg1,opt2=arg2,...
例如：
--graphics vnc,密码=foobar
支持的选项是：
类型
显示类型。 这是其中之一：
VNC
在来宾中设置虚拟控制台并将其导出为主机中的 VNC 服务器。
除非还提供了“端口”参数，否则 VNC 服务器将运行在第一个
5900 或以上的空闲端口号。 分配的实际 VNC 显示可以是
使用“vncdisplay”命令“virsh”（或 观看者(1) 可以使用
处理此细节以供使用）。
香料
使用 Spice 协议导出来宾的控制台。 香料允许高级
音频和 USB 设备流等功能，以及改进的图形
性能。
使用 spice 图形类型将像给出这些参数一样工作：
--视频qxl --频道spicevmc
没有
不会为来宾分配图形控制台。 客人可能需要
在来宾的第一个串行端口上配置了一个文本控制台（这可以是
通过 --extra-args 选项完成）。 命令“virsh console NAME”可用于
连接到串行设备。
端口
为访客控制台请求一个永久的、静态分配的端口号。 这个
由 'vnc' 和 'spice' 使用
体育
指定香料 tlsport。
听
用于侦听 VNC/Spice 连接的地址。 默认值通常为 127.0.0.1
（仅限本地主机），但某些虚拟机管理程序允许全局更改此设置（例如，
qemu 驱动程序默认值可以在 /etc/libvirt/qemu.conf 中更改）。 使用 0.0.0.0 到
允许从其他机器访问。 这是由“vnc”和“spice”使用的
键盘映射
请求将虚拟 VNC 控制台配置为使用特定键盘运行
布局。 如果指定了特殊值 'local'，则 virt-install 将尝试
配置为使用与本地系统相同的键盘映射。 'none' 的值
具体遵循管理程序。 默认行为是特定于管理程序的，
但通常与“本地”相同。 这被“vnc”使用
密码
请求一个 VNC 密码，在连接时需要。 请注意，此信息可能会结束
在 virt-install 日志文件中，所以不要使用重要的密码。 这是由
“vnc”和“香料”
使用 --graphics=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elementsGraphics>
这弃用了以下选项：--vnc、--vncport、--vnclisten、-k/--keymap、
--sdl，--ngraphics
--noautoconsole
不要自动尝试连接到访客控制台。 默认行为是
发射 观看者(1) 显示图形控制台，或运行“virsh”
“console”命令显示文本控制台。 使用此参数将禁用此功能
行为。
虚拟化 配置
覆盖默认虚拟化类型选项的选项。
-v
--hvm
请求使用完全虚拟化，如果并行和完全虚拟化都是
主机上可用。 如果连接到 Xen，此参数可能不可用
没有硬件虚拟化支持的机器上的管理程序。 这个参数是
如果连接到基于 QEMU 的虚拟机管理程序，则暗示。
-p
--帕拉韦特
这个客人应该是一个半虚拟化的客人。 如果主机同时支持 para & full
虚拟化，并且既没有指定这个参数也没有指定“--hvm”，这将是
假定。
- 容器
这个客人应该是一个容器类型的客人。 仅在以下情况下才需要此选项
管理程序也支持其他来宾类型（例如，此选项是
LXC 和 OpenVZ 的默认行为，但为了完整性而提供）。
--virt 类型
要安装的管理程序。 示例选项包括 kvm、qemu 或 xen。 可用的
选项通过“virsh 功能”列出标签。
这弃用了 --accelerate 选项，该选项现在是默认行为。 安装
一个普通的 QEMU 来宾，使用“--virt-type qemu”
支持装置 配置
- 控制器 配置
将控制器设备连接到来宾。 TYPE 是以下之一： IDE, 直流电, 科学上网, SATA, 虚拟-
串行或 USB.
控制器还支持特殊值 usb2 和 usb3 指定哪个版本
应使用 USB 控制器（版本 2 或 3）。
模型
控制器模型。 这些可能因管理程序及其版本而异。
最常用的模型是例如 汽车, Virtio-scsi 等加工。为 科学上网 控制器， 爱奇艺
or 没有 等加工。为 USB 控制器。 有关完整列表和更多详细信息
控制器/型号，见
"http://libvirt.org/formatdomain.html#elementsControllers”。
地址
控制器地址，'bus:domain:slot.function' 形式的当前 PCI。
指数
一个十进制整数，描述遇到总线控制器的顺序，以及
引用控制器总线。
主
适用于USB配套控制器，定义主总线启动端口。
例子：
- 控制器 usb,model=ich9-ehci1,address=0:0:4.0,index=0
在 PCI 地址 9:1:0 上添加 ICH0 EHCI4.0 USB 控制器
- 控制器 usb,model=ich9-uhci2,address=0:0:4.7,index=0,master=2
为之前的主控制器添加了一个 ICH9 UHCI2 USB 配套控制器，
端口从端口号 2 开始。
参数 multifunction='on' 将自动添加到适当的设备
（如果需要的话）。 这适用于所有 PCI 设备。
使用 --controller=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elementsControllers>
- 输入 配置
将输入设备连接到来宾。 示例输入设备类型是鼠标、平板电脑或
键盘。
使用 --input=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#元素输入>
--主机开发 配置
--主机设备 配置
将物理主机设备连接到来宾。 HOSTDEV 的一些示例值：
--主机开发 pci_0000_00_1b_0
通过 libvirt 的节点设备名称，如“virsh nodedev-list”所示
--主机开发 001.003
USB 通过总线，设备（通过 lsusb）。
--主机开发 0x1234:0x5678
USB 按供应商、产品（通过 lsusb）。
--主机开发 1f.01.02
PCI 设备（通过 lspci）。
使用 --hostdev=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elementsHostDev>
- 声音 模型
将虚拟音频设备连接到来宾。 MODEL 指定模拟声卡
模型。 可能的值为 ich6、ich9、ac97、es1370、sb16、pcspk 或默认值。
'default' 将尝试选择指定操作系统支持的最佳模型。
这弃用了旧的 --soundhw 选项。
使用 --sound=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elementsSound>
--看门狗 模型[,动作=动作]
将虚拟硬件看门狗设备连接到来宾。 这需要一个守护进程和
来宾中的设备驱动程序。 当虚拟机出现时，看门狗会发出一个信号
似乎挂了。 ACTION 指定当看门狗触发时 libvirt 将做什么。 价值观
，那恭喜你，
重置
强制重置来宾（默认）
断电
强行关闭访客
暂停
暂停客人
没有
什么都不做
关闭
优雅地关闭来宾（不推荐，因为挂起的来宾可能不会
响应正常关机）
MODEL 是模拟设备型号：i6300esb（默认）或 ib700。 一些
例子：
使用推荐的设置：
--看门狗默认
将 i6300esb 与“关机”操作一起使用
--watchdog i6300esb,action=poweroff
使用 --watchdog=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elementsWatchdog>
- 平行线 配置
--串行 配置
使用各种选项指定要连接到来宾的串行设备。 一般
串行字符串的格式是
--串行类型,opt1=val1,opt2=val2,...
--serial 和 --parallel 设备共享所有相同的选项，除非另有说明。
字符设备重定向的一些类型是：
--串行 PTY
伪TTY。 分配的 pty 将列在正在运行的来宾 XML 中
描述。
--串行 开发，路径=主机路径
主机设备。 对于串行设备，这可能是 /dev/ttyS0。 对于并行设备，
这可能是 /dev/parport0。
--串行 文件，路径=文件名
将输出写入 FILENAME。
--串行 管道，路径=管道路径
命名管道（见 管（7））
--串行 tcp,host=HOST:PORT,mode=模式,protocol=协议
TCP网络控制台。 MODE 是“绑定”（等待 HOST:PORT 上的连接）或
'connect'（将输出发送到 HOST:PORT），默认为 'bind'。 主机默认为
'127.0.0.1'，但需要 PORT。 协议可以是 'raw' 或 'telnet'
（默认为“原始”）。 如果是“telnet”，则该端口的作用类似于 telnet 服务器或客户端。 一些
例子：
等待任何地址上的连接，端口 4567：
--serial tcp,主机=0.0.0.0:4567
连接到本地主机，端口 1234：
--串行 TCP，主机=：1234，模式=连接
等待 localhost 上的 telnet 连接，端口 2222。然后用户可以连接
通过 'telnet localhost 2222' 以交互方式访问此控制台：
--串行 TCP，主机 =：2222，模式 = 绑定，协议 = telnet
--串行 udp，主机= CONNECT_HOST：端口，bind_host = BIND_HOST：BIND_PORT
UDP 网络控制台。 HOST:PORT 是将输出发送到的目的地（默认 HOST 是
'127.0.0.1'，需要端口）。 BIND_HOST:BIND_PORT 是可选的本地地址
绑定到（默认 BIND_HOST 为 127.0.0.1，但仅在 BIND_PORT 为
指定的）。 一些例子：
将输出发送到默认的 syslog 端口（可能需要编辑 /etc/rsyslog.conf
因此）：
--串行UDP，主机=：514
将输出发送到远程主机 192.168.10.20，端口 4444（此输出可以在
使用“nc -u -l 4444”的远程主机）：
--serial udp，主机=192.168.10.20:4444
--串行 unix，路径=UNIXPATH，模式=模式
Unix 套接字，见 UNIX(7). MODE 具有与 --serial 类似的行为和默认值
tcp，模式=模式
使用 --serial=? 或 --parallel=? 查看所有可用子选项的列表。 完全的
详情在http://libvirt.org/formatdomain.html#elementsCharSerial> 和
<http://libvirt.org/formatdomain.html#elementsCharParallel>
- 渠道
指定用于连接来宾和主机的通信通道设备。 这个
选项使用与 --serial 和 --parallel 相同的选项来指定主机/源
通道的尽头。 额外的“目标”选项用于指定来宾机器如何
看到频道。
字符设备重定向的一些类型是：
- 渠道 源，target_type=guestfwd，target_address=HOST:PORT
使用 QEMU 用户模式网络堆栈的通信通道。 客人可以连接
到使用指定 HOST:PORT 组合的通道。
- 渠道 源，target_type=virtio[,name=NAME]
使用 virtio 串口的通信通道（需要 2.6.34 或更高版本的主机和
客人）。 virtio --channel 行的每个实例都在来宾中公开为
/dev/vport0p1、/dev/vport0p2 等 NAME 是可选的元数据，可以是任何
字符串，例如 org.linux-kvm.virtioport1。 如果指定，这将在
位于 /sys/class/virtio-ports/vport0p1/NAME 的访客
- 渠道 spicevmc,target_type=virtio[,name=NAME]
QEMU spice 代理的通信通道，使用 virtio 串行（需要 2.6.34
或后来的主人和客人）。 NAME 是可选的元数据，可以是任何字符串，例如
作为默认的 com.redhat.spice.0 指定来宾将如何看到
通道。
使用 --channel=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elementsCharChannel>
- 安慰
在来宾和主机之间连接一个文本控制台。 某些来宾和管理程序
组合可以在guest中自动设置一个getty，所以一个开箱即用的文本
可以提供登录（target_type=xen 用于 xen paravirt 来宾，并且可能
target_type=virtio 未来）。
示例：
- 安慰 pty,target_type=virtio
将 virtio 控制台连接到来宾，重定向到主机上的 PTY。 为了
支持的来宾，这会在来宾中公开 /dev/hvc0。 看
http://fedoraproject.org/wiki/Features/VirtioSerial 了解更多信息。 虚拟控制台
需要 libvirt 0.8.3 或更高版本。
使用 --console=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elementsCharConsole>
- 视频 配置
指定将连接到访客的视频设备型号。 VIDEO 的有效值
特定于管理程序，但最近 kvm 的一些选项是 cirrus、vga、qxl 或
vmvga (vmware)。
使用 --video=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elements视频>
- 智能卡 模式[,选项]
配置虚拟智能卡设备。
模式是其中之一 主持人, 主机证书或 直通. 附加选项是：
类型
要在主机上连接的字符设备类型。 这仅适用于
直通 模式。
一个示例调用：
- 智能卡 直通，类型=spicevmc
使用 SPICE 图形设备的智能卡通道将智能卡信息传递给
客人
使用 --smartcard=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elementsSmartcard>
--redirdev 总线[,选项]
添加重定向设备。
类型
目前支持的重定向类型是 TCP or 香料.
服务器
TCP 服务器连接详细信息，格式为“server:port”。
调用示例：
--redirdev USB，类型= TCP，服务器=本地主机：4000
在“localhost”端口 4000 上添加 TCP 服务器提供的 USB 重定向设备。
--redirdev USB，类型=spicevmc
添加通过专用 Spice 通道重定向的 USB 设备。
使用 --redirdev=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elementsRedir>
--记忆气球 模型
将虚拟内存气球设备连接到来宾。 如果 memballoon 设备需要
被明确禁用，使用 MODEL='none'。
MODEL 是提供的 memballoon 设备类型。 该值可以是“virtio”、“xen”或
'没有任何'。 一些例子：
使用推荐的设置：
-- memballoon virtio
不要使用 memballoon 设备：
--memballoon 无
使用 --memballoon=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elementsMemBalloon>
--tpm 类型[,选项]
配置虚拟 TPM 设备。
类型必须是 直通. 附加选项是：
模型
要呈现给来宾操作系统的设备模型。 模型必须是 tpm-tis.
一个示例调用：
--tpm 直通，型号=tpm-tis
使主机的 TPM 可供单个来宾访问。
--tpm /开发/tpm
通过主机 TPM 的便捷选项。
使用 --tpm=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elementsTpm>
--rng 类型[,选项]
配置虚拟 RNG 设备。
类型可以 随机 or 爱德.
如果指定的类型是 随机 那么必须指定这些值：
后端设备
用作熵源的设备。
而当类型是 爱德，必须提供这些值：
后端主机
指定要连接的熵收集守护程序的主机。
后端服务
指定要连接的熵收集守护程序的端口。
后端类型
指定连接类型： TCP or UDP.
后端模式
指定连接模式。 它要么是“绑定”（等待连接
HOST:PORT) 或“connect”（将输出发送到 HOST:PORT）。
后端连接主机
当指定的 backend_type 为时，指定要连接的远程主机 UDP 和
backend_mode 是 绑定.
后端连接服务
当指定的 backend_type 为时，指定要连接的远程服务 UDP
和 backend_mode 是 绑定.
一个示例调用：
--rng 例如，backend_host = localhost，backend_service = 8000，backend_type = tcp
将本地主机连接到 TCP 端口 8000 以获取熵数据。
--rng / dev /随机
使用 /dev/random 设备获取熵数据，这种形式隐式使用
“随机”模型。
使用 --rng=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elementsRng>
- 恐慌 选择
将紧急通知设备连接到来宾。 对于推荐的设置，请使用：
--panic 默认
使用 --panic=? 查看所有可用子选项的列表。 完整的细节在
<http://libvirt.org/formatdomain.html#elementsPanic>
其他条款 配置
-h
- 帮帮我
显示帮助信息并退出
- 版
显示程序的版本号并退出
- 自动开启
为域设置自动启动标志。 这会导致域在主机引导时启动
向上。
--打印-xml [步]
打印生成的来宾 XML，而不是定义它。 默认情况下，这会做
存储创建（可以使用 --dry-run 禁用）。 此选项意味着 --quiet。
如果 VM 安装有多个阶段，默认情况下这将打印所有生成的 XML。
如果要打印特定步骤，请使用 --print-xml 2（用于第二阶段 XML）。
--noreboot
防止域在安装完成后自动重新启动。
- 等待 等待
等待 VM 完成安装的时间（以分钟为单位）。 没有这个
选项，virt-install 将等待控制台关闭（不一定表示
来宾已关闭），或者在 --noautoconsole 的情况下，只需启动
安装并退出。 任何负值都会使 virt-install 无限期等待，一个值
0 触发与 noautoconsole 相同的结果。 如果超过时间限制，virt-
install 只是退出，让虚拟机处于当前状态。
--试运行
继续来宾创建过程，但不要创建存储设备，更改
主机设备配置，或者实际上教 libvirt 关于来宾。 虚拟安装
可能仍会获取安装媒体，因为这是正确检测操作系统所必需的
安装。
- 查看
启用或禁用某些验证检查。 一些示例是关于使用磁盘的警告
已分配给另一个 VM（--check path_in_use=on|off），或警告
磁盘分配期间可能空间不足（--check disk_size=on|off）。
大多数检查是默认执行的。
-q
- 安静的
仅打印致命错误消息。
-d
-调试
运行安装过程时将调试信息打印到终端。 这
调试信息也存储在“~/.cache/virt-manager/virt-install.log“ 甚至
如果省略此参数。
示例
安装带有 virtio 加速磁盘/网络的 Fedora 20 KVM 来宾，创建一个新的 10GiB
qcow2 文件，从主机 CDROM 驱动器中的媒体安装。 这将使用 Spice 图形
默认情况下，启动自动启动图形客户端。
# 虚拟安装 \
--connect qemu:///系统\
--virt 类型 kvm \
--name 演示 \
--内存 500 \
--磁盘大小=10 \
--光驱/开发/光驱\
--操作系统变体 fedora13
安装 Fedora 9 普通 QEMU 来宾，使用 LVM 分区，虚拟网络，从
PXE，使用 VNC 服务器/查看器，带有 virtio-scsi 磁盘
# 虚拟安装 \
--connect qemu:///系统\
--name 演示 \
--内存 500 \
--磁盘路径=/dev/HostVG/DemoVM,bus=scsi \
--控制器 virtio-scsi \
--network网络=默认\
--virt 型 qemu
--图形vnc \
--操作系统变体 fedora9
在无盘环境中，在 Xenfullyvirt 下运行 Live CD 映像
# 虚拟安装 \
--hvm\
--name 演示 \
--内存 500 \
--磁盘无\
--livecd\
--图形vnc \
--cdrom /root/fedora7live.iso
在 linux 容器来宾 (LXC) 中运行 /usr/bin/httpd。 资源使用上限为 512 MiB
ram 和 2 个主机 cpu：
# 虚拟安装 \
--connect lxc:///\
--name httpd_guest \
--内存 512 \
--vcpus 2\
--init /usr/bin/httpd
使用私有根文件系统启动 linux 容器来宾（LXC），使用 / bin / sh的 作为初始化。
容器的根将位于主机目录 /home/LXC 下。 主机目录“/home/test”将是
安装在“到/ mnt" 容器内的目录：
# 虚拟安装 \
--connect lxc:///\
--name 容器 \
--内存 128 \
--文件系统/home/LXC,/\
--文件系统/home/test,到/ mnt \
- 在里面 / bin / sh的
安装半虚拟化 Xen 来宾、500 MiB 内存、5 GiB 磁盘和 Fedora Core 6
从 web 服务器，在纯文本模式下，使用旧样式 --file 选项：
# 虚拟安装 \
--帕拉韦特\
--name 演示 \
--内存 500 \
--磁盘 /var/lib/xen/images/demo.img,size=6 \
--图形无\
- 地点 http://download.fedora.redhat.com/pub/fedora/linux/core/6/x86_64/os/
使用其余磁盘映像的默认值从现有磁盘映像“mydisk.img”创建来宾
选项。
# 虚拟安装 \
--name 演示 \
--内存 512 \
--disk /home/user/VMs/mydisk.img \
- 进口
启动串行 QEMU ARM VM，这需要指定手动内核。
# 虚拟安装 \
--名称手臂测试\
--内存 1024 \
--arch armv7l --machine vexpress-a9 \
--disk /home/user/VMs/myarmdisk.img \
--boot kernel=/tmp/my-arm-kernel,initrd=/tmp/my-arm-initrd,dtb=/tmp/my-arm-dtb,kernel_args="console=ttyAMA0 rw root=/dev/mmcblk0p3" \
--图形 无
使用 onworks.net 服务在线使用 virt-install
