meedamian/simple-qemu

meedamian/simple-qemu

!GitHub tag (latest SemVer)

镜像概述

本项目旨在简化跨编译及运行不同CPU架构程序/镜像的过程。目前仅支持amd64（x86_64）作为主机架构，可模拟的目标架构包括：arm（arm32v7）、aarch64（arm64v8/arm64）、riscv32、riscv64。

镜像分类

提供三类镜像满足不同场景需求：

1. 全架构镜像：含所有支持架构的二进制文件，标签为版本号（如:v4.2.0或:latest）。
2. 仅启用模拟镜像：不含qemu二进制，用于启用模拟功能（需自行提供qemu），标签含enable（如:v4.2.0-enable）。
3. 单架构镜像：含单个架构二进制及模拟脚本，标签为架构名（如:v4.2.0-arm）。

核心功能

• 支持多架构模拟：在amd64主机上运行非x86架构的程序/镜像。
• 灵活镜像选择：根据需求选择全架构、单架构或仅启用模拟的镜像。
• 简化跨架构开发：降低跨编译和多架构应用测试的门槛。

使用场景

• 跨架构测试：本地验证arm/aarch64等架构应用的运行效果。
• 多架构镜像构建：通过指定目标架构基础镜像，构建多架构Docker镜像。

配置与使用示例

启用模拟功能

shell
# 在主机启用模拟
docker run --rm --privileged meedamian/simple-qemu -p yes

# 验证模拟生效（运行arm32v7架构的alpine）
docker run --rm arm32v7/alpine uname -m

跨架构镜像构建

1. 先启用模拟（如上步骤）；
2. 编写Dockerfile指定目标架构基础镜像：

Dockerfile
FROM arm32v7/alpine:3.11
# 后续指令将在模拟的arm32v7架构执行

查看镜像支持的架构

shell
docker manifest inspect alpine | jq -r '.manifests[].platform | .os + "/" + .architecture + " " + .variant'

性能说明

模拟运行速度较慢，具体性能因qemu版本和目标架构而异，可参考项目提供的性能对比数据（https://github.com/lncm/docker-***d/issues/9%EF%BC%89%E3%80%82

反馈与问题

若发现bug，请在https://github.com/meeDamian/simple-qemu/issues/new%E6%8F%90%E4%BA%A4%EF%BC%8C%E6%88%96%E9%80%9A%E8%BF%87%E9%82%AE%E4%BB%B6%EF%BC%88***%EF%BC%89%E3%80%81***%EF%BC%88@meeDamian%EF%BC%89%E8%81%94%E7%B3%BB%E4%BD%9C%E8%80%85%E3%80%82

许可证

MIT许可证，作者：Damian Mee