使用Vagrant-libvirt运行arm64虚拟机报错的排查与方案咨询

问题场景 #

我在ArchLinux（x86_64）环境下，尝试用Vagrant搭配vagrant-libvirt插件创建arm64架构的Debian 12虚拟机，使用的Vagrantfile如下：

Vagrant.configure("2") do |config|
  
  # Disable synced folders
  config.vm.synced_folder ".", "/vagrant", disabled: true
  
  # Machine setup
  config.vm.define "pi4b" do |app|
      
    app.vm.provider "libvirt" do |lv|
      lv.machine_arch = "aarch64"
    end

    app.vm.box = "generic/debian12"
    app.vm.box_architecture = "arm64"
    app.vm.hostname = "athena"
    app.vm.network :private_network, ip: "192.168.58.2"
  end
end

执行命令vagrant up --provider libvirt时，出现如下错误：

Error while creating domain: Error saving the server: Call to virDomainDefineXML failed: invalid argument: could not get preferred machine for /usr/bin/qemu-system-aarch64 type=kvm

环境信息 #

• OS: ArchLinux (x86_64)
• Kernel: 6.9.1
• CPU: 12th Gen Intel i7-12700H (20) @ 4.600GHz

排查步骤 #

1. 修改libvirt驱动配置（核心解决方法） #

x86_64主机的KVM仅支持同架构虚拟机加速，无法直接为arm64虚拟机提供KVM加速，因此需要强制libvirt使用QEMU软件模拟模式：
在Vagrantfile的libvirt配置块中添加lv.driver = "qemu"，修改后的配置如下：

app.vm.provider "libvirt" do |lv|
  lv.machine_arch = "aarch64"
  lv.driver = "qemu" # 添加这一行
end

2. 验证QEMU arm64组件安装 #

检查是否已安装qemu-system-aarch64：

pacman -Q qemu-system-aarch64

若未安装，执行以下命令安装：

sudo pacman -S qemu-system-aarch64

3. 检查libvirt架构支持 #

运行以下命令查看libvirt是否识别aarch64架构：

virsh capabilities | grep -i aarch64

若输出为空，确保已安装完整的libvirt依赖包：

sudo pacman -S libvirt libvirt-dbus

安装完成后重启libvirtd服务：

sudo systemctl restart libvirtd

4. 排除VirtualBox冲突 #

即使没有运行VirtualBox虚拟机，其内核模块可能仍会干扰libvirt：
检查是否加载了VirtualBox模块：

lsmod | grep vbox

若有输出，卸载相关模块：

sudo modprobe -r vboxdrv vboxnetflt vboxnetadp vboxpci

替代方案 #

如果libvirt方案仍有问题，可以尝试以下Vagrant兼容的arm64虚拟机方案：

• 使用vagrant-qemu插件：直接基于QEMU创建arm64虚拟机，无需依赖libvirt，配置更轻量化。安装插件后，修改Vagrantfile使用qemu provider即可。
• 使用Docker转Vagrant box：先通过Docker运行arm64容器（Docker支持跨架构镜像），再将容器导出为Vagrant box使用。

内容的提问来源于stack exchange，提问作者Alessandro