img2kvm的使用说明

img2kvm是一个在PVE下将OW固件添加到VM的工具,可以方便地将固件文件(包括gz方式的压缩格式)快速添加到OW虚拟机中,从而简化让人工操作的麻烦。

当前最新版本的img2kvm的下载地址为:http://dl.everun.top/softwares/utilities/img2kvm/img2kvm 。

若是你的PVE主机能访问Internet,可以直接下载到目录“/usr/bin”或“/usr/local/bin”下,下面是将img2kvm下载到目录“/usr/local/bin”以及增加其可执行权限的命令:

wget -P /usr/local/bin http://dl.everun.top/softwares/utilities/img2kvm/img2kvm
chmod +x /usr/local/bin/img2kvm

若是PVE主机不能直接访问Internet,可以先下载到电脑中,然后上传到指定的目录“/usr/bin”或“/usr/local/bin”下,然后再通过chmod命令增加可执行权限。

这样完成后,就可以直接使用img2kvm命令了。

img2kvm详细的帮助信息可以通过命令“img2kvm -h”直接获取,旧版本img2kvm帮助信息的主要内容如下:

A utility that convert OpenWrt firmware to disk image for KVM guest in Proxmox VE.
Copyright (C) 2017-2018 everun.top
usage: img2kvm <img_name> <vm_id> <vmdisk_name> [storage]

 -h or --help display this help.
 -V or --version output img2kvm version informaton.

Command parameters:
 img_name the name of OpenWrt image file, e.g. 'openwrt-x86-kvm64-combined-ext4.img'.
 vm_id the ID of VM for OpenWrt guest, e.g. '200'.
 vmdisk_name the name of disk for OpenWrt guest, e.g. 'vm-200-disk-1'.
 storage Storage pool of Proxmox VE, default is 'local-lvm'.

其中,-h可以获得所有的帮助信息,-V可以获得版本信息。

所用的命令格式为:

img2kvm <img_name> <vm_id> <vmdisk_name> [storage]

其具体参数说明如下:

  • img_name:是OW固件的文件名称。一般为“xxx.img”或“xxx.img.gz”的格式。img2kvm可以直接识别并转换“img.gz”压缩格式的固件文件,对于“xxx.img.gz”来说,只需要输入“xxx.img”作为名称即可,不需要再另外加“.gz”。
  • vm_id:是创建好的OW虚拟机的ID。一般为一组非零开头的数字,如200。
  • vmdisk_name:是OW虚拟机要使用的磁盘名称。建议采用vm-<vm_id>-disk-<disk_id>的命名方式,如vm-200-disk-1。
  • storage:是指导入使用的存储池的ID,默认为“local-lvm”,这是安装PVE时自动创建的。此项为可选项,若不指定则使用默认值。

v0.1.8版之后的img2kvm对所需的选项参数进行了简化,取消了参数“<vmdisk_name>”,简化后的命令格式如下:

img2kvm <img_name> <vm_id> [storage]

即img2kvm命令后面仅需要加加两个参数:固件的文件名称和需要添加磁盘的虚拟机ID。

其中,固件的文件可以是img的映像格式,也可以是.gz的压缩格式。

例如,将文件名为“openwrt-x86-kvm64-combined-squashfs.img.gz”的固件导入到ID为“123”的VM中的命令为:

img2kvm openwrt-x86-kvm64-combined-squashfs.img.gz 123

这里使用了默认的存储池local,故可以省略。

* 增补信息:

当前img2kvm最新的版本为v0.1.10。

v0.2版后将加入将固件文件转换后直接添加到VM的命令及参数选项。

最后更新于2019年3月20日。

发表评论