---
title: "Quickemu 简介"
description: "快速创建并运行经过优化的 Windows、macOS 与 Linux 虚拟机"
---

> Documentation Index
> Fetch the complete documentation index at: https://quickemu.ndjp.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickemu 简介

Quickemu 是对出色的 [QEMU](https://www.qemu.org/) 的一层封装，在创建虚拟机时会自动*“做出正确的选择”*。它不需要繁琐的配置项。你只需决定想运行哪个操作系统，其余的事情 Quickemu 都会替你处理妥当 🤖

> **核心工作方式**
>
> - `quickget` **自动下载上游操作系统镜像**并生成配置文件 📀
> - `quickemu` 会枚举你的硬件，并以**最适合你这台电脑的最优配置**启动虚拟机 ⚡️

## 为什么选择 Quickemu？

- **跨平台支持** — 支持 **Windows**（10/11/Server）、**macOS**（Sequoia 到 Mojave）与 **Linux**（Ubuntu 及所有官方衍生版）。
- **极简工作流** — 仅需两条命令即可完成从下载到启动的全过程，无需深度配置 QEMU。
- **接近原生的性能** — 利用 VirGL、VirtIO、SPICE 等技术提供接近原生的虚拟化体验。
- **海量系统支持** — 支持近 **1000 个**操作系统版本，包括各种 BSD、FreeDOS、Haiku、KolibriOS 等。

## 快速上手

创建并运行一台虚拟机只需两条命令：

```sh
quickget nixos unstable minimal
quickemu --vm nixos-unstable-minimal.conf
```

> **完整步骤**
>
> 分步说明、参数查询与更多示例见[快速上手](https://quickemu.ndjp.net/docs/quick-start)；执行 `quickget`（不带参数）可列出所有支持的系统。

## 主要特性

- 完整的 **SPICE** 支持，包括宿主机与客户机之间的剪贴板共享
- 为 Linux 和 Windows 客户机提供 **VirtIO-webdavd** 文件共享
- 为 Linux 和 macOS 客户机提供 **VirtIO-9p** 文件共享
- 支持 [QEMU Guest Agent](https://wiki.qemu.org/Features/GuestAgent)
- 为 Linux、macOS 和 Windows 客户机提供 **Samba** 文件共享
- **VirGL** 加速
- **USB** 设备直通
- 自动为客户端转发 **SSH** 端口
- 全双工音频
- 盲文支持
- 支持 **EFI**（可启用或不启用 SecureBoot）与传统 BIOS 启动

## 下一步

- **快速上手** — 两条命令创建并运行你的第一台虚拟机。
- **安装指南** — 在 Arch、Debian、Ubuntu、Fedora、macOS、Nix 上安装，或从源码构建。
- **创建 Linux 虚拟机** — 在 Quickemu 中运行各种 Linux 发行版。
- **创建 macOS 虚拟机** — 在 Quickemu 中运行 macOS，含兼容性与音频说明。
- **创建 Windows 虚拟机** — 在 Quickemu 中运行 Windows 10/11 与 Server。
- **高级配置** — 显示后端、文件共享、网络、USB 重定向、TPM 等。

## 完整文档目录

- [快速上手](https://quickemu.ndjp.net/docs/quick-start) —— 两条命令跑通第一台虚拟机
- [安装指南](https://quickemu.ndjp.net/docs/installation) —— 各发行版与从源码安装
- [功能特性](https://quickemu.ndjp.net/docs/features) —— 支持的系统、加速与文件共享能力
- [创建 Linux 虚拟机](https://quickemu.ndjp.net/docs/linux) —— 自动/手动创建，Ubuntu 每日镜像
- [创建 macOS 虚拟机](https://quickemu.ndjp.net/docs/macos) —— 安装步骤、兼容性、音频、TSC 问题
- [创建 Windows 虚拟机](https://quickemu.ndjp.net/docs/windows) —— 系统要求、无人值守安装定制、已知问题
- [高级 quickemu 配置](https://quickemu.ndjp.net/docs/advanced-quickemu) —— 命令行参数与虚拟机配置项
- [高级 quickget 功能](https://quickemu.ndjp.net/docs/advanced-quickget) —— quickget 参数与扩展新系统
- [替代前端](https://quickemu.ndjp.net/docs/frontends) —— Quickgui 图形界面与图标
- [macOS 宿主机的 3D 加速](https://quickemu.ndjp.net/docs/macos-host) —— GL/VirGL 加速构建与排查
- [参考资料](https://quickemu.ndjp.net/docs/references) —— 开发相关的文档与链接

Source: https://quickemu.ndjp.net/docs/index.mdx
