安装指南 | Quickemu 中文文档

Quickemu 已进入以下发行版的软件仓库（打包状态来自 Repology.org）。

Arch Linux

Quickemu 可在 AUR（Arch 用户仓库）中获取，任何 AUR 助手都能安装。以 yay 为例：

yay -Sy quickemu

如果想要包含最新未发布修复（以及 bug）的滚动包：

yay -Sy quickemu.git

Debian 及其衍生版

Quickemu 从 Debian 13（Trixie）起进入官方仓库。

项目的 GitHub Releases 页面也提供了适用于 Debian 及其衍生版的 .deb 包。下载后用 apt-get 安装：

sudo apt-get install ./quickemu_x.y.z-1_all.deb

Ubuntu

Quickemu 从 plucky（25.04）起进入 Universe 仓库。

Ubuntu 用户也可以通过 PPA 安装。在终端执行：

sudo apt-add-repository ppa:flexiondotorg/quickemu
sudo apt update
sudo apt install quickemu

noble（24.04）及更高版本的用户，如果尚未安装 qemu-system-modules-spice，需要补装：

sudo apt install qemu-system-modules-spice

Fedora

从 Fedora 41 起，Quickemu 已原生打包进 Fedora 仓库。

sudo dnf install quickemu

macOS / Homebrew

brew tap quickemu-project/quickemu
brew install quickemu

或安装最新的开发版：

brew install quickemu --HEAD

该 tap 也可配合 nix-homebrew 使用，在 Nix 上以声明式方式管理 Homebrew。

Nix 与 NixOS

Flake

Quickemu 的稳定版本已发布到 FlakeHub：

https://flakehub.com/flake/quickemu-project/quickemu

Nixpkgs

把 Quickemu 加入你的 systemPackages，例如：

systemPackages = with pkgs; [
  quickemu
];

Nix Shell

也可以在 Nix shell 中快速试用 quickemu。

新命令接口：

nix shell nixpkgs#quickemu

旧命令接口：

nix-shell -p quickemu

任意 Linux（从源码安装）

git clone --filter=blob:none https://github.com/quickemu-project/quickemu
cd quickemu/docs
sudo make install

从源码安装时，需要手动安装以下依赖：

QEMU（6.0.0 或更新）需启用 GTK、SDL、SPICE 与 VirtFS 支持
bash（4.0 或更新）
Coreutils
curl
EDK II
gawk
gptfdisk（用于创建 macOS 虚拟机）
grep
glxinfo
jq
mtools（用于创建 macOS 虚拟机）
pciutils
procps
python3
mkisofs
usbutils
util-linux（含 uuidgen）
sed
socat
spicy
swtpm
xdg-user-dirs
xrandr
zsync
unzip

Debian 上安装依赖

Trixie 及之后版本会由依赖自动处理。更早的版本（及其衍生版）：

sudo apt-get install bash coreutils curl gdisk genisoimage grep jq mesa-utils mtools ovmf pciutils procps python3 qemu sed socat spice-client-gtk swtpm-tools unzip usbutils util-linux uuidgen-runtime xdg-user-dirs xrandr zsync

Fedora 上安装依赖

Fedora 41 及之后已原生处理。更早的版本：

# 可能需要添加额外的软件源来获取某些包
# 例如 zsync 已不在 Fedora 仓库中，可从 copr 获取
# sudo dnf copr enable elxreno/zsync -y
sudo dnf install bash coreutils curl edk2-tools gdisk genisoimage grep jq mesa-demos mtools pciutils procps python3 qemu sed socat spice-gtk-tools swtpm unzip usbutils util-linux xdg-user-dirs xrandr zsync

Gentoo 上安装依赖

请注意：视你的系统配置而定，可能需要使用 sys-firmware/edk2-ovmf 而非 sys-firmware/edk2-ovmf-bin。

sudo emerge --ask --noreplace app-emulation/qemu \
 app-shells/bash \
 sys-apps/coreutils \
 net-misc/curl \
 sys-firmware/edk2-ovmf \
 sys-apps/gawk \
 sys-apps/grep \
 sys-apps/gptfdisk \
 x11-apps/mesa-progs \
 app-misc/jq \
 sys-fs/mtools \
 sys-apps/pciutils \
 sys-process/procps \
 app-cdr/cdrtools \
 sys-apps/usbutils \
 sys-apps/util-linux \
 sys-apps/sed \
 net-misc/socat \
 app-emulation/spice \
 app-crypt/swtpm \
 x11-misc/xdg-user-dirs \
 x11-apps/xrandr \
 net-misc/zsync \
 app-arch/unzip

在 macOS 上从源码安装

先用 brew 安装依赖：

brew install bash cdrtools coreutils gptfdisk jq mtools python3 qemu usbutils samba sha3sum socat swtpm zsync

然后克隆项目：

git clone https://github.com/quickemu-project/quickemu
cd quickemu

下一步

安装完成后，请继续阅读快速上手，或直接查看创建 Linux 虚拟机。