【亲测免费】 QEMU Docker 项目技术文档

安装指南

系统要求

• 支持 Docker 的 Linux 发行版（如 Ubuntu, CentOS 等）
• 系统支持 KVM 加速（可通过 sudo kvm-ok 命令检查）

安装步骤

1. 安装 Docker

   sudo apt-get update
   sudo apt-get install docker-ce docker-ce-cli containerd.io
   

2. 安装 Docker Compose

   sudo apt-get install docker-compose
   

3. 验证安装

   docker --version
   docker-compose --version
   

项目使用说明

启动 QEMU 容器

使用 docker-compose.yml

1. 创建 docker-compose.yml 文件，内容如下：

   version: "3"
   services:
     qemu:
       container_name: qemu
       image: qemux/qemu-docker
       environment:
         BOOT: "https://dl-cdn.alpinelinux.org/alpine/v3.19/releases/x86_64/alpine-virt-3.19.1-x86_64.iso"
       devices:
         - /dev/kvm
       cap_add:
         - NET_ADMIN
       ports:
         - 8006:8006
       stop_grace_period: 2m
       restart: on-failure
   

2. 启动容器：

   docker-compose up -d
   

使用 docker run

docker run -it --rm -e "BOOT=http://example.com/image.iso" -p 8006:8006 --device=/dev/kvm --cap-add NET_ADMIN qemux/qemu-docker

访问 QEMU 虚拟机

• 启动容器后，使用浏览器访问 http://localhost:8006，即可看到虚拟机界面。

项目 API 使用文档

环境变量

• BOOT: 设置启动 ISO 镜像的 URL。
• RAM_SIZE: 设置虚拟机内存大小，例如 4G。
• CPU_CORES: 设置虚拟机 CPU 核心数，例如 4。
• DISK_SIZE: 设置虚拟机磁盘大小，例如 128G。
• BOOT_MODE: 设置启动模式，例如 uefi 或 windows。
• DHCP: 设置为 Y 以启用 DHCP 获取 IP 地址。
• DEVICE: 设置要传递的磁盘设备路径，例如 /dev/sda。
• ARGUMENTS: 设置自定义 QEMU 参数，例如 -device usb-tablet。

设备和网络配置

• devices: 添加设备，例如 /dev/kvm。
• cap_add: 添加权限，例如 NET_ADMIN。
• ports: 映射端口，例如 8006:8006。

项目安装方式

Docker Compose

• 创建 docker-compose.yml 文件，配置服务并启动容器。

Docker Run

• 直接使用 docker run 命令启动容器，配置环境变量和设备。

通过以上步骤，您可以轻松安装和使用 QEMU Docker 项目，享受高性能的虚拟机体验。