使用额外 ext4 磁盘镜像在 QEMU 中传递与加载内核模块

概述

往往需要把自定义的内核模块从宿主机传递到 QEMU 客户机。其实，传统方法要么改装客机内核，要么通过网络共享，既繁琐又不安全。这篇文章介绍一种“磁盘镜像”方式：创建一个 ext4 格式的独立磁盘镜像，把模块放进去。接下来在 QEMU 启动时挂载为第二块磁盘，实现零改装、零网络依赖的模块传递。不过，

操作步骤

1. 在宿主机上创建 ext4 镜像

先准备一个空文件，再格式化为 ext4：

# 创建 64MB 的空文件
dd if=/dev/zero of=driver.img bs=1M count=64
# 格式化为 ext4
mkfs.ext4 driver.img

2. 把驱动模块放入镜像

将镜像挂载到临时目录。接下来拷贝 .ko 文件：

# 创建临时挂载点
mkdir -p /tmp/mnt_driver
# 挂载镜像
sudo mount -o loop driver.img /tmp/mnt_driver
# 复制内核模块
sudo cp simple_demo.ko /tmp/mnt_driver/
# 卸载镜像
sudo umount /tmp/mnt_driver

3. 启动 QEMU 并挂载该镜像作为第二块磁盘

在 QEMU 启动命令行中添加 -drive 参数：

qemu-system-x86_64 \
... 你的原有参数 ... \
-drive file=driver.img,format=raw,if=virtio,index=1

• 若客户机没有 virtio 驱动，可改用 if=ide。
• index=1 表示第二个磁盘。设备名称在客户机中通常为 /dev/vdb 或 /dev/sdb。

4. 在 QEMU 客户机内挂载镜像并加载模块

启动后进入客户机 shell。执行：

lsblk

mkdir -p /mnt/driver

mount /dev/vdb /mnt/driver

cd /mnt/driver && ls -alht

insmod simple_demo.ko

ls -lha /dev/simple_demo

dmesg | tail -n 5

• `insmod` 成功后会生成对应设备节点，如 ``。

5. 卸载与清理

bash rmmod simple_demo # 卸载驱动模块 umount /mnt/driver # 卸载磁盘镜像

此时可以回到宿主机重新挂载 driver.img更新文件后 用于 QEMU。

如何更新镜像中的文件

当需要替换驱动或添加新文件时请按以下顺序操作，避免文件程序损坏：

1. 确保 QEMU 客户机已卸载该镜像。
2. 在宿主机上挂载并更新文件：

sudo mount -o loop driver.img /tmp/mntdriver
sudo cp newdriver.ko /tmp/mntdriver/
sudo umount /tmp/mntdriver

QEMU 客户机 执行 /dev/vdb mount ... ` 即可看到新文件。

注意： 宿主机与 QEMU 客户机不要同时挂载同一镜像，否则可能出现文件程序损坏。

常见问题与方法表格

问题痛点 使用者遇到的困扰	原因分析 技术根源	方法 实用建议
设备 /dev/vdb 未出现？	客户机未装 virtio-pci 驱动；QEMU 未正确指定接口类型。	改用 `if=ide` 或在客机安装 virtio‑pci；或手工修改 `index=` 为合适值。
mount 报错：`already mounted or busy`	同一时间有两个进程尝试访问同一块设备； 未正确卸载前一次挂载，	先运行 `umount`；确认无残留进程，话说回来，重启客机会更保险。
加载模块提示 `Key was rejected`	UEFI Secure Boot 已开启，未签名的模块被拒绝。	`关闭 Secure Boot 或为 .ko 签名`。
无法找到已加载的 device node	未能成功 insmod 或 module 内部错误导致无 device node 创建。	检查 dmesg 日志确认错误信息；确认 kernel 与 module 编译兼容。不过，

优缺点对照表——快速评估是否采用此方法

 不能同时访问——宿主 & 客户端不能同时挂載相同映象。痛点：多进程或脚本同步管理困难，需要串行访问策略.  需要额外磁盘槽位——VM 必须支持多块磁盘。痛点：资源受限或硬件配置有限时需要预留更多虚拟硬件资源.

优点
无需重新编译客机内核。仅需支持 ext* 与 virtio‑blk/IDE。解决实际问题：极大降低维护成本、加速迭代周期。	不依赖网络，可在离线环境下完成所有工作。解决实际问题：满足最小化程序与高安全性需求。
修改简单、可随时更新。解决实际问题：快速迭代测试新版驱动，无需重建 VM 镜像。不过，
缺点

This approach transforms tedious task of module delivery into a lightweight “disk‑share” workflow:

• Create an ext4 image and copy .ko file.
• Add image as a second disk in QEMU command line.
• Mkfs + mount inside guest → insmod → test.
• Edit files on host → remount → repeat.

The method preserves isolation。avoids kernel recompilation,eliminates network dependency,and provides a clean path for rapid kernel module development and testing within virtualized environments.

。

---