qm.conf(5)

启用/禁用与虚拟机中运行的 QEMU Guest Agent（QGA）的通信。

备份时冻结/解冻客户机文件系统，以保证一致性。

移动磁盘或迁移虚拟机后运行 fstrim。

选择 agent 类型。

设置策略位以允许 Simultaneous Multi Threading（SMT）（除 SEV-SNP 外会被忽略）。

向客户机固件添加 kernel hashes，用于 measured Linux kernel launch。

设置策略位以禁止调试客户机。

设置策略位以禁止与其他客户机共享密钥（对 SEV-SNP 会被忽略）。

使用 type=std 启用标准 SEV；使用 es 选项启用实验性 SEV-ES；使用 snp 选项启用实验性 SEV-SNP。

配置音频设备。

音频设备的驱动后端。

从软盘 (a)、硬盘 (c)、CD-ROM (d) 或网络 (n) 启动。已弃用，请改用 order=。

客户机会按照此处设备出现的顺序尝试启动。

指定一个自定义文件，其中包含通过 cloud-init 传递给虚拟机的所有元数据。 此内容与 provider 相关，意味着 configdrive2 和 nocloud 的格式不同。

通过 cloud-init 向虚拟机传递包含所有网络数据的自定义文件。

通过 cloud-init 向虚拟机传递包含所有用户数据的自定义文件。

通过 cloud-init 向虚拟机传递包含所有 vendor 数据的自定义文件。

模拟的 CPU 类型。可以是默认名称或自定义名称（自定义模型名称必须以 custom- 为前缀）。

额外 CPU flags 列表，以 ; 分隔。使用 +FLAG 启用 flag，使用 -FLAG 禁用 flag。自定义 CPU 模型可以指定 QEMU/KVM 支持的任意 flag；出于安全原因，虚拟机专用 flag 必须来自以下集合：pcid, spec-ctrl, ibpb, ssbd, virt-ssbd, amd-ssbd, amd-no-ssb, pdpe1gb, md-clear, hv-tlbflush, hv-evmcs, aes

不要将其标识为 KVM 虚拟机。

Hyper-V vendor ID。Windows 客户机内的某些驱动或程序需要特定 ID。

报告给客户机操作系统的物理内存地址位数。应小于或等于主机值。设置为 host 可使用主机 CPU 的值，但请注意，这会破坏到具有其他值的 CPU 的在线迁移。

报告给客户机的 CPU 模型和厂商。必须是 QEMU/KVM 支持的模型。仅对自定义 CPU 模型定义有效，默认模型始终会向客户机操作系统报告其自身。

OVMF EFI vars 的大小和类型。4m 较新且推荐使用，并且 Secure Boot 需要它。为保持向后兼容，如果未另行指定，则使用 2m。对于 arch=aarch64（ARM）的虚拟机会被忽略。

驱动器的后端卷。

驱动器后端文件的数据格式。

在使用 efitype=4m 时，使用已注册发行版特定密钥和 Microsoft Standard keys 的 EFI vars 模板。请注意，这会默认启用 Secure Boot，但仍可在虚拟机内部关闭。

磁盘大小。此项仅供信息展示，没有实际影响。

覆盖客户机可见的 PCI device ID。

主机 PCI 设备直通。主机 PCI 设备的 PCI ID，或主机 PCI virtual functions 列表。HOSTPCIID 语法为：

以 legacy IGD 模式传递此设备，使其成为虚拟机中的主图形设备且为独占图形设备。需要 pc-i440fx 机器类型，并将 VGA 设置为 none。

集群范围 mapping 的 ID。此项和默认键 host 必须至少设置一个。

要使用的 mediated device 类型。 虚拟机启动时会创建此类型的一个实例， 虚拟机停止时会清理该实例。

选择 PCI-express 总线（需要 q35 机器模型）。

指定设备 ROM 是否在客户机内存映射中可见。

自定义 PCI 设备 ROM 文件名（必须位于 /usr/share/kvm/）。

覆盖客户机可见的 PCI subsystem device ID。

覆盖客户机可见的 PCI subsystem vendor ID。

覆盖客户机可见的 PCI vendor ID。

启用 vfio-vga 设备支持。

启用 vfio-pci 设备 ramfb 显示支持。

要使用的 AIO 类型。

进行备份时是否应包含该驱动器。

最大读/写速度，单位为字节每秒。

I/O burst 的最大长度，单位为秒。

最大读取速度，单位为字节每秒。

读取 I/O burst 的最大长度，单位为秒。

最大写入速度，单位为字节每秒。

写入 I/O burst 的最大长度，单位为秒。

驱动器的缓存模式。

强制驱动器物理几何参数使用指定柱面数。

控制是否检测并尝试优化零写入。

控制是否将 discard/trim 请求传递到底层存储。

驱动器的后端卷。

驱动器后端文件的数据格式。

强制驱动器物理几何参数使用指定磁头数。

最大读/写 I/O，单位为操作每秒。

最大未限速读/写 I/O 池，单位为操作每秒。

I/O burst 的最大长度，单位为秒。

最大读取 I/O，单位为操作每秒。

最大未限速读取 I/O 池，单位为操作每秒。

读取 I/O burst 的最大长度，单位为秒。

最大写入 I/O，单位为操作每秒。

最大未限速写入 I/O 池，单位为操作每秒。

写入 I/O burst 的最大长度，单位为秒。

最大读/写速度，单位为兆字节每秒。

最大未限速读/写池，单位为兆字节每秒。

最大读取速度，单位为兆字节每秒。

最大未限速读取池，单位为兆字节每秒。

最大写入速度，单位为兆字节每秒。

最大未限速写入池，单位为兆字节每秒。

驱动器的介质类型。

驱动器报告的型号名称，经过 URL 编码，最长 40 字节。

该驱动器是否应纳入复制任务。

读取错误时的操作。

强制驱动器物理几何参数使用指定扇区数。

驱动器报告的序列号，经过 URL 编码，最长 20 字节。

将此本地管理的卷标记为在所有节点上可用。

此选项不会自动共享该卷，而是假定它已经被共享。

磁盘大小。此项仅供信息展示，没有实际影响。

控制 qemu 的 snapshot mode 功能。如果启用，对磁盘所做的更改是临时的，并会在虚拟机关机时被丢弃。

是否将此驱动器暴露为 SSD，而不是旋转式硬盘。

强制磁盘几何参数 BIOS translation 模式。

写入错误时的操作。

驱动器的 worldwide name，编码为 16 字节十六进制字符串，并以 0x 为前缀。

IPv4 流量的默认网关。

需要选项：ip

IPv6 流量的默认网关。

需要选项：ip6

CIDR 格式的 IPv4 地址。

CIDR 格式的 IPv6 地址。

文件名称。会添加 pve-shm- 前缀。默认为 VMID。虚拟机停止时会删除该文件。

文件大小，单位为 MB。

启用 S3 电源状态。从 machine types 9.2+pve1 开始默认为 false，之前默认为 true。

启用 S4 电源状态。从 machine types 9.2+pve1 开始默认为 false，之前默认为 true。

指定 QEMU machine type。

启用并设置客户机 vIOMMU 变体（Intel vIOMMU 需要将 machine type 设置为 q35）。

虚拟机当前在线 RAM 容量，单位为 MiB。使用 balloon 设备时，这是最大可用内存。

网络设备要连接到的 bridge。Proxmox VE 标准 bridge 名为 vmbr0。

10.0.2.2   Gateway
10.0.2.3   DNS Server
10.0.2.4   SMB Server

此接口是否应受防火墙保护。

此接口是否应断开连接（类似拔掉网线）。

未设置 I/G（Individual/Group）位的普通 MAC 地址。

网卡模型。virtio 模型以很低的 CPU 开销提供最佳性能。如果客户机不支持此驱动，通常最好使用 e1000。

强制 MTU，仅适用于 VirtIO。设置为 1 表示使用 bridge MTU。

设备上使用的数据包队列数量。

速率限制，单位为 mbps（兆字节每秒），使用浮点数表示。

应用到此接口数据包的 VLAN tag。

允许通过此接口的 VLAN trunks。

访问此 NUMA 节点的 CPU。

要使用的主机 NUMA 节点。

此 NUMA 节点提供的内存量。

NUMA 分配策略。

每个 period 毫秒允许注入客户机的最大熵字节数。使用 0 禁用限制（可能有风险）。

每隔 period 毫秒会重置熵注入配额，允许客户机再获取 max_bytes 的熵。

主机上用于收集熵的文件。使用 urandom 在实际意义上*不会*降低安全性，因为它仍由真实熵播种，并且提供的字节很可能也会在客户机上与真实熵混合。/dev/hwrng 可用于从主机直通硬件 RNG。

要使用的 AIO 类型。

进行备份时是否应包含该驱动器。

最大读/写速度，单位为字节每秒。

I/O burst 的最大长度，单位为秒。

最大读取速度，单位为字节每秒。

读取 I/O burst 的最大长度，单位为秒。

最大写入速度，单位为字节每秒。

写入 I/O burst 的最大长度，单位为秒。

驱动器的缓存模式。

强制驱动器物理几何参数使用指定柱面数。

控制是否检测并尝试优化零写入。

控制是否将 discard/trim 请求传递到底层存储。

驱动器的后端卷。

驱动器后端文件的数据格式。

强制驱动器物理几何参数使用指定磁头数。

最大读/写 I/O，单位为操作每秒。

最大未限速读/写 I/O 池，单位为操作每秒。

I/O burst 的最大长度，单位为秒。

最大读取 I/O，单位为操作每秒。

最大未限速读取 I/O 池，单位为操作每秒。

读取 I/O burst 的最大长度，单位为秒。

最大写入 I/O，单位为操作每秒。

最大未限速写入 I/O 池，单位为操作每秒。

写入 I/O burst 的最大长度，单位为秒。

最大读/写速度，单位为兆字节每秒。

最大未限速读/写池，单位为兆字节每秒。

最大读取速度，单位为兆字节每秒。

最大未限速读取池，单位为兆字节每秒。

最大写入速度，单位为兆字节每秒。

最大未限速写入池，单位为兆字节每秒。

驱动器的介质类型。

该驱动器是否应纳入复制任务。

读取错误时的操作。

强制驱动器物理几何参数使用指定扇区数。

驱动器报告的序列号，经过 URL 编码，最长 20 字节。

将此本地管理的卷标记为在所有节点上可用。

此选项不会自动共享该卷，而是假定它已经被共享。

磁盘大小。此项仅供信息展示，没有实际影响。

控制 qemu 的 snapshot mode 功能。如果启用，对磁盘所做的更改是临时的，并会在虚拟机关机时被丢弃。

是否将此驱动器暴露为 SSD，而不是旋转式硬盘。

强制磁盘几何参数 BIOS translation 模式。

写入错误时的操作。

驱动器的 worldwide name，编码为 16 字节十六进制字符串，并以 0x 为前缀。

要使用的 AIO 类型。

进行备份时是否应包含该驱动器。

最大读/写速度，单位为字节每秒。

I/O burst 的最大长度，单位为秒。

最大读取速度，单位为字节每秒。

读取 I/O burst 的最大长度，单位为秒。

最大写入速度，单位为字节每秒。

写入 I/O burst 的最大长度，单位为秒。

驱动器的缓存模式。

强制驱动器物理几何参数使用指定柱面数。

控制是否检测并尝试优化零写入。

控制是否将 discard/trim 请求传递到底层存储。

驱动器的后端卷。

驱动器后端文件的数据格式。

强制驱动器物理几何参数使用指定磁头数。

最大读/写 I/O，单位为操作每秒。

最大未限速读/写 I/O 池，单位为操作每秒。

I/O burst 的最大长度，单位为秒。

最大读取 I/O，单位为操作每秒。

最大未限速读取 I/O 池，单位为操作每秒。

读取 I/O burst 的最大长度，单位为秒。

最大写入 I/O，单位为操作每秒。

最大未限速写入 I/O 池，单位为操作每秒。

写入 I/O burst 的最大长度，单位为秒。

是否为此驱动器使用 iothreads。

最大读/写速度，单位为兆字节每秒。

最大未限速读/写池，单位为兆字节每秒。

最大读取速度，单位为兆字节每秒。

最大未限速读取池，单位为兆字节每秒。

最大写入速度，单位为兆字节每秒。

最大未限速写入池，单位为兆字节每秒。

驱动器的介质类型。

驱动器的 product 名称，最长 16 字节。

队列数量。

该驱动器是否应纳入复制任务。

读取错误时的操作。

驱动器是否为只读。

是否使用 scsi-block 对主机块设备进行完整直通。

与主机低内存或高内存碎片同时出现时，可能导致 I/O 错误。

强制驱动器物理几何参数使用指定扇区数。

驱动器报告的序列号，经过 URL 编码，最长 20 字节。

将此本地管理的卷标记为在所有节点上可用。

此选项不会自动共享该卷，而是假定它已经被共享。

磁盘大小。此项仅供信息展示，没有实际影响。

控制 qemu 的 snapshot mode 功能。如果启用，对磁盘所做的更改是临时的，并会在虚拟机关机时被丢弃。

是否将此驱动器暴露为 SSD，而不是旋转式硬盘。

强制磁盘几何参数 BIOS translation 模式。

驱动器的 vendor 名称，最长 8 字节。

写入错误时的操作。

驱动器的 worldwide name，编码为 16 字节十六进制字符串，并以 0x 为前缀。

用于指示 SMBIOS 值已进行 base64 编码的标志。

设置 SMBIOS1 family 字符串。

设置 SMBIOS1 manufacturer。

设置 SMBIOS1 product ID。

设置 SMBIOS1 serial number。

设置 SMBIOS1 SKU 字符串。

设置 SMBIOS1 UUID。

设置 SMBIOS1 version。

通过 SPICE 启用文件夹共享。需要在虚拟机中安装 Spice-WebDAV 守护进程。

启用视频流。对检测到的视频流使用压缩。

驱动器的后端卷。

磁盘大小。此项仅供信息展示，没有实际影响。

TPM 接口版本。v2.0 较新，应优先使用。请注意，此项之后无法更改。

驱动器的后端卷。

主机 USB 设备、端口，或值 spice。HOSTUSBDEVICE 语法为：

'bus-port(.port)*' (decimal numbers) or
'vendor_id:product_id' (hexadecimal numbers) or
'spice'

此选项允许直接访问主机硬件。因此此类机器将无法再迁移， 请特别谨慎使用。

集群范围 mapping 的 ID。此项和默认键 host 必须至少设置一个。

指定给定的 host 选项是否为 USB3 设备或端口。对于现代客户机（machine version >= 7.1 且 ostype 为 l26 和 windows > 7），此标志无关紧要（所有设备都会插入 xhci 控制器）。

启用特定剪贴板。如果未设置，会根据显示类型添加 SPICE 剪贴板。尚不支持带 VNC 剪贴板的迁移。

设置 VGA 内存（MiB）。对串口显示无效。

选择 VGA 类型。不建议使用类型 cirrus。

要使用的 AIO 类型。

进行备份时是否应包含该驱动器。

最大读/写速度，单位为字节每秒。

I/O burst 的最大长度，单位为秒。

最大读取速度，单位为字节每秒。

读取 I/O burst 的最大长度，单位为秒。

最大写入速度，单位为字节每秒。

写入 I/O burst 的最大长度，单位为秒。

驱动器的缓存模式。

强制驱动器物理几何参数使用指定柱面数。

控制是否检测并尝试优化零写入。

控制是否将 discard/trim 请求传递到底层存储。

驱动器的后端卷。

驱动器后端文件的数据格式。

强制驱动器物理几何参数使用指定磁头数。

最大读/写 I/O，单位为操作每秒。

最大未限速读/写 I/O 池，单位为操作每秒。

I/O burst 的最大长度，单位为秒。

最大读取 I/O，单位为操作每秒。

最大未限速读取 I/O 池，单位为操作每秒。

读取 I/O burst 的最大长度，单位为秒。

最大写入 I/O，单位为操作每秒。

最大未限速写入 I/O 池，单位为操作每秒。

写入 I/O burst 的最大长度，单位为秒。

是否为此驱动器使用 iothreads。

最大读/写速度，单位为兆字节每秒。

最大未限速读/写池，单位为兆字节每秒。

最大读取速度，单位为兆字节每秒。

最大未限速读取池，单位为兆字节每秒。

最大写入速度，单位为兆字节每秒。

最大未限速写入池，单位为兆字节每秒。

驱动器的介质类型。

该驱动器是否应纳入复制任务。

读取错误时的操作。

驱动器是否为只读。

强制驱动器物理几何参数使用指定扇区数。

驱动器报告的序列号，经过 URL 编码，最长 20 字节。

将此本地管理的卷标记为在所有节点上可用。

此选项不会自动共享该卷，而是假定它已经被共享。

磁盘大小。此项仅供信息展示，没有实际影响。

控制 qemu 的 snapshot mode 功能。如果启用，对磁盘所做的更改是临时的，并会在虚拟机关机时被丢弃。

强制磁盘几何参数 BIOS translation 模式。

写入错误时的操作。

文件系统应使用的缓存策略（auto、always、metadata、never）。

遵循客户机应用程序传递下来的 O_DIRECT 标志。

要与客户机共享的目录 mapping 的标识符。也会用作虚拟机内部的 mount tag。

为此挂载启用 POSIX ACL 支持（启用 ACL 意味着启用 xattr）。

为此挂载启用扩展属性支持。

激活后如果客户机未能及时轮询 watchdog，要执行的操作。

要模拟的 watchdog 类型。