linuxserver/qemu-static

提供QEMU静态二进制文件，支持跨架构模拟，适用于Docker环境中实现多平台应用运行。

1 收藏0 次下载activelinuxserver镜像

QEMU Static Docker镜像文档

镜像概述与主要用途

QEMU Static镜像由LinuxServer.io团队开发，基于QEMU静态二进制文件构建，用于在x86_64或aarch64架构主机上运行为其他架构构建的Docker容器。通过QEMU的硬件虚拟化技术，该镜像可实现跨架构容器的透明运行，无需修改主机系统核心配置。

核心功能与特性

定期应用更新：及时同步QEMU上游版本及依赖组件更新
简化用户映射：支持通过PGID/PUID参数轻松配置容器内用户权限
自定义基础镜像：集成s6 overlay进程管理系统，优化容器生命周期管理
高效资源利用：每周统一更新基础操作系统层，减少跨镜像冗余，降低存储空间占用、 downtime及网络带宽消耗
安全更新保障：定期进行安全补丁更新，提升容器运行环境安全性

支持的架构

架构	可用性	镜像标签格式
x86-64	✅	amd64-<version tag>
arm64	✅	arm64v8-<version tag>
armhf (32位)	❌	arm32v7-<version tag>

注：直接拉取 lscr.io/linuxserver/qemu-static:latest 可自动匹配主机架构

使用场景与适用范围

跨架构容器部署：在x86_64主机上运行arm64架构容器，或在aarch64主机上运行x86_64容器
多架构应用测试：开发者无需额外硬件，即可验证应用在不同架构下的兼容性
边缘设备环境：在嵌入式aarch64设备上运行x86_64工具链容器，简化开发流程
混合架构集群：在单一物理机/虚拟机内构建多架构容器运行环境

使用方法与配置说明

基本说明

该镜像为临时工具型镜像，无需长期运行，仅需通过命令行执行一次即可完成主机跨架构支持配置。执行后会在主机上设置QEMU静态二进制文件及binfmt_misc规则，使Docker引擎能够自动识别并运行其他架构容器。

启用与重置命令

bash
docker run --rm -it \
  --privileged \
  linuxserver/qemu-static \
  --reset \
  -p yes

参数说明

--rm：容器退出后自动删除，避免残留
-it：交互式终端支持，便于查看配置过程输出
--privileged：需要特权模式以修改主机binfmt_misc配置
--reset：重置现有QEMU配置，清理旧规则
-p yes：启用持久化支持，确保主机重启后配置仍生效

版本历史

2024.12.09：升级至QEMU 9.1.2，实现构建流程自动化
2024.11.07：升级至QEMU 9.1.1，切换至新Debian软件包及二进制文件命名规范
2024.10.14：初始发布

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

"Docker加速体验非常流畅，大镜像也能快速完成下载。"

常见问题

Q1:轩辕镜像免费版与专业版有什么区别？

免费版仅支持 Docker Hub 加速，不承诺可用性和速度；专业版支持更多镜像源，保证可用性和稳定速度，提供优先客服响应。

Q2:轩辕镜像免费版与专业版有分别支持哪些镜像？

免费版仅支持 docker.io；专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。

Q3:流量耗尽错误提示

当返回 402 Payment Required 错误时，表示流量已耗尽，需要充值流量包以恢复服务。

Q4:410 错误问题

通常由 Docker 版本过低导致，需要升级到 20.x 或更高版本以支持 V2 协议。

Q5:manifest unknown 错误

先检查 Docker 版本，版本过低则升级；版本正常则验证镜像信息是否正确。

Q6:镜像拉取成功后，如何去掉轩辕镜像域名前缀？

使用 docker tag 命令为镜像打上新标签，去掉域名前缀，使镜像名称更简洁。

查看全部问题→

轩辕镜像下载加速使用手册

探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式

登录仓库拉取

通过 Docker 登录认证访问私有仓库

Linux

在 Linux 系统配置镜像加速服务

Windows/Mac

在 Docker Desktop 配置镜像加速

Docker Compose

Docker Compose 项目配置加速

K8s Containerd

Kubernetes 集群配置 Containerd

宝塔面板

在宝塔面板一键配置镜像加速

群晖

Synology 群晖 NAS 配置加速

飞牛

飞牛 fnOS 系统配置镜像加速

极空间

极空间 NAS 系统配置加速服务

爱快路由

爱快 iKuai 路由系统配置加速

绿联

绿联 NAS 系统配置镜像加速

威联通

QNAP 威联通 NAS 配置加速

Podman

Podman 容器引擎配置加速

Singularity/Apptainer

HPC 科学计算容器配置加速

其他仓库配置

ghcr、Quay、nvcr 等镜像仓库

专属域名拉取

无需登录使用专属域名加速

需要其他帮助？请查看我们的常见问题或官方QQ群: 13763429

qemu-static Docker 镜像下载 - 轩辕镜像

qemu-static 镜像详细信息和使用指南

qemu-static 镜像标签列表和版本信息

qemu-static 镜像拉取命令和加速下载

qemu-static 镜像使用说明和配置指南

Docker 镜像加速服务 - 轩辕镜像平台

国内开发者首选的 Docker 镜像加速平台

极速拉取 Docker 镜像服务

相关 Docker 镜像推荐

热门 Docker 镜像下载

qemu-static 镜像详细信息

qemu-static 镜像标签列表

qemu-static 镜像使用说明

qemu-static 镜像拉取命令

Docker 镜像加速服务

轩辕镜像平台优势

镜像下载指南