qemu

QEMU 驱动程序

概述

qemu 驱动程序使用 QEMU（系统）创建 VM。

https://www.qemu.org/

用法

使用 qemu 驱动程序启动 minikube

minikube start --driver=qemu

特殊功能

minikube start 支持一些 qemu 特定标志

  • --qemu-firmware-path: 要使用的固件镜像路径。
    • 注意：虽然该标志应该覆盖配置，但如果该标志未生效，请尝试运行 minikube delete。
    • MacPorts：如果您通过 MacPorts 在装有 M1 芯片的 Mac 上安装 minikube 和 qemu，请使用以下标志：--qemu-firmware-path=/opt/local/share/qemu/edk2-aarch64-code.fd

网络

QEMU 驱动程序有两个网络选项：socket_vmnet 和 builtin。socket_vmnet 将为您提供完整的 minikube 网络功能，例如 service 和 tunnel 命令。另一方面，builtin 网络不是专用网络，因此诸如 service 和 tunnel 之类的命令不可用。socket_vmnet 可以通过 brew 安装或从源代码安装（说明见下文）。

    要求

    需要 macOS 10.15 或更高版本以及 socket_vmnet。

    通过 brew 安装 socket_vmnet

    brew install socket_vmnet
HOMEBREW=$(which brew) && sudo ${HOMEBREW} services start socket_vmnet

    从源代码安装 socket_vmnet（需要 Go）

    git clone https://github.com/lima-vm/socket_vmnet.git && cd socket_vmnet
sudo make install

    用法

    minikube start --driver qemu --network socket_vmnet

    用法

    minikube start --driver qemu --network builtin

    已知问题

      /var/db/dhcpd_leases 错误

      如果您看到与 /var/db/dhcpd_leases 相关的错误，您的防火墙很可能正在阻止 bootpd 进程。

      运行以下命令以在 macOS 内置防火墙中解除对 bootpd 的阻止

      sudo /usr/libexec/ApplicationFirewall/socketfilterfw --add /usr/libexec/bootpd
sudo /usr/libexec/ApplicationFirewall/socketfilterfw --unblock /usr/libexec/bootpd

      在公司机器上或使用自定义 DNS 时启动卡住

      使用 builtin 网络（默认）时，访客机仅使用主机 /etc/resolv.conf 中的第一个 nameserver 条目进行 DNS 查找。如果您的第一个 nameserver 条目是公司/内部 DNS，则很可能会导致问题。如果您在 minikube start 上看到警告 ❗ This VM is having trouble accessing https://registry.k8s.io，您很可能受到了影响。这可能会完全阻止您的集群启动，并且您将无法拉取远程镜像。更多详细信息请参阅：#15021

      解决方法

      1. 如果可能，重新排列您的 /etc/resolv.conf，将一个通用的 nameserver 条目放在首位（例如 8.8.8.8），然后重启您的机器。
      2. 使用 --network=socket_vmnet

      所有已知的 'qemu' 驱动程序问题列表

      故障排除

      • 运行 minikube start --alsologtostderr -v=4 以调试崩溃问题

      上次修改时间：2025 年 5 月 15 日：更新 qemu.md 文档以反映 homebrew/services 退役 (#20685) (b0a069508)