Quickpassthrough 项目使用教程

Quickpassthrough 项目使用教程

quickpassthroughA project to remove the complexity of setting up GPU passthrough for qemu项目地址:https://gitcode.com/gh_mirrors/qu/quickpassthrough

1. 项目的目录结构及介绍

Quickpassthrough 项目的目录结构如下：

quickpassthrough/
├── internal/
├── pkg/
├── .gitignore
├── .goreleaser.yaml
├── LICENSE
├── README.md
├── go.mod
├── go.sum
├── quickpassthrough_preview.gif

目录介绍

• internal/: 包含项目的内部代码。
• pkg/: 包含项目的公共代码。
• .gitignore: 指定 Git 版本控制系统忽略的文件和目录。
• .goreleaser.yaml: Goreleaser 配置文件，用于自动化发布。
• LICENSE: 项目许可证。
• README.md: 项目说明文档。
• go.mod: Go 模块文件，定义项目的依赖。
• go.sum: Go 模块文件的校验和。
• quickpassthrough_preview.gif: 项目预览图。

2. 项目的启动文件介绍

Quickpassthrough 项目的启动文件是 quickpassthrough 可执行文件。用户可以通过以下命令下载并运行：

# 下载最新版本
wget https://github.com/HikariKnight/quickpassthrough/releases/latest/download/quickpassthrough

# 赋予执行权限
chmod +x quickpassthrough

# 运行
./quickpassthrough

3. 项目的配置文件介绍

Quickpassthrough 项目没有固定的配置文件，用户在运行时需要根据提示进行配置。以下是一些常见的配置步骤：

配置步骤

1. 检测系统环境：

   • 检测用户是否拥有 AMD 或 Intel CPU，并提供相应的 IOMMU 内核参数。

2. 配置第二块 GPU：

   • 使用 ls-iommu 查找 PCI 设备，如显卡、USB 控制器等，并查看它们所属的 IOMMU 组。

3. 启用和配置 vfio 模块：

   • 使用 initramfs-tools、dracut、modprobe 和 mkinitcpio 配置 vfio 模块。

4. 生成内核参数：

   • 生成适用于 grub 和 systemd-boot 的正确内核参数。

5. 生成脚本：

   • 生成用于转储配置的脚本。

通过以上步骤，用户可以完成 Quickpassthrough 项目的配置和启动。

quickpassthroughA project to remove the complexity of setting up GPU passthrough for qemu项目地址:https://gitcode.com/gh_mirrors/qu/quickpassthrough