← retour aux snippets

qemu-nbd: monter une image QCOW2 en lecture seule

Attacher une image QCOW2 comme périphérique bloc et monter ses partitions.

bash filesystem #qemu-nbd#qcow2#loop

objectif

Explorer le contenu d’une VM sans la démarrer en exposant ses partitions au système hôte.

code minimal

sudo modprobe nbd max_part=8
sudo qemu-nbd --connect=/dev/nbd0 --read-only vm.qcow2
sudo partprobe /dev/nbd0

utilisation

# lister les partitions et monter
lsblk /dev/nbd0
sudo mount -o ro /dev/nbd0p1 /mnt/vm

# détacher proprement
sudo umount /mnt/vm
sudo qemu-nbd --disconnect /dev/nbd0

variante(s) utile(s)

# mapper via kpartx (dmsetup)
sudo kpartx -av /dev/nbd0
sudo mount -o ro /dev/mapper/nbd0p1 /mnt/vm

notes

  • ne pas écrire sur l’image si vous voulez la conserver intacte (utilisez —read-only).
  • chargez le module nbd et ajustez max_part selon vos besoins.
  • certains FS nécessitent des modules supplémentaires (ex: xfs, btrfs).