PVE 安装 OpenWrt:镜像转换教程(以 openwrt-23.05.img 为例)

很多人在 Proxmox VE 部署 OpenWrt 时,首先会遇到一个问题:

下载到的是 .img 镜像,如何转换成适合虚拟机使用的格式?

本文只讲 OpenWrt 镜像转换,不涉及虚拟机创建、网卡桥接、网络配置等内容,适合新手快速上手。


📌 目录

  1. 为什么要转换镜像?
  2. 转换前准备
  3. 开始转换(核心命令)
  4. 转换完成后检查
  5. 查看镜像详细信息
  6. 转换回 img/raw 格式
  7. 常见问题
  8. 推荐命名方式
  9. 总结

一、为什么要转换镜像?

以以下文件为例:

openwrt-23.05.img

它属于:

raw 原始磁盘镜像

.img 文件通常就是 raw 格式镜像,可直接使用,但在 Proxmox VE、QEMU、KVM 等虚拟化环境中,更推荐转换为:

qcow2

✅ qcow2 的优势:

  • 支持快照(Snapshot)
  • 节省磁盘空间(按需增长)
  • 更适合长期运行
  • 方便备份与迁移
  • 更适合虚拟机场景使用

二、转换前准备

先确认镜像文件已上传到服务器,并存在当前目录:

ls -lh openwrt-23.05.img

如果能看到文件大小,说明镜像正常。

例如:

-rw-r--r-- 1 root root 128M Apr 28 openwrt-23.05.img

三、开始转换(核心命令)

执行以下命令:

qemu-img convert -f raw -O qcow2 openwrt-23.05.img openwrt.qcow2

参数说明:

参数含义
convert执行格式转换
-f raw原格式为 raw
-O qcow2输出格式为 qcow2
openwrt-23.05.img原镜像文件
openwrt.qcow2输出文件名

四、转换完成后检查

执行:

ls -lh openwrt.qcow2

如果看到新文件,说明转换成功。


五、查看镜像详细信息

执行:

qemu-img info openwrt.qcow2

你会看到类似输出:

image: openwrt.qcow2
file format: qcow2
virtual size: 512 MiB
disk size: 120 MiB
cluster_size: 65536

说明镜像已可正常用于虚拟机。


六、如果想转换回 img/raw 格式

也可以反向转换:

qemu-img convert -f qcow2 -O raw openwrt.qcow2 openwrt-new.img

适用于:

  • 写入 U 盘
  • 物理机安装
  • 转回原始格式备份

七、常见问题

1. 提示:qemu-img: command not found

说明系统未安装工具。

在 Proxmox VE 中通常默认自带,如没有可执行:

apt install qemu-utils -y

2. 提示磁盘空间不足

先检查空间:

df -h

建议预留至少原镜像 2 倍空间。


3. 转换速度慢

通常与以下因素有关:

  • 硬盘读写速度
  • CPU 性能
  • 镜像体积大小
  • 存储位置(机械盘 / SSD)

OpenWrt 镜像一般较小,通常几秒即可完成。


八、推荐命名方式

建议统一命名,方便管理多个版本:

openwrt-23.05.img
openwrt-23.05.qcow2
openwrt-24.10.qcow2

这样后续升级、回滚、备份都更清晰。


九、总结

openwrt-23.05.img 为例,最常用转换命令就是:

qemu-img convert -f raw -O qcow2 openwrt-23.05.img openwrt.qcow2

转换完成后,即可继续导入 Proxmox VE 虚拟机使用。


十、一句话结论

如果你在 PVE 中部署 OpenWrt,建议把 .img 转成 .qcow2,更适合虚拟化环境,后续管理也更方便。


🔖 下篇预告

如果你需要,我还可以继续帮你整理下一篇:

《PVE 安装 OpenWrt 完整教程:创建虚拟机 + 导入镜像 + 网络配置》

上一篇