本站支持搜索的镜像仓库：Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com

linuxserver/qemu-static

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

1 收藏0 次下载activelinuxserver镜像

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

中文简介版本下载

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

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引擎能够自动识别并运行其他架构容器。

启用与重置命令

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：初始发布

常见问题

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

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

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

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

流量耗尽错误提示

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

410 错误问题

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

manifest unknown 错误

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

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

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

查看全部问题→

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

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

🔐

登录方式进行 Docker 镜像下载加速教程

通过 Docker 登录方式配置轩辕镜像加速服务，包含7个详细步骤

🐧

Linux Docker 镜像下载加速教程

在 Linux 系统上配置轩辕镜像源，支持主流发行版

🖥️

Windows/Mac Docker 镜像下载加速教程

在 Docker Desktop 中配置轩辕镜像加速，适用于桌面系统

📦

Docker Compose 镜像下载加速教程

在 Docker Compose 中使用轩辕镜像加速，支持容器编排

📋

K8s containerd 镜像下载加速教程

在 k8s 中配置 containerd 使用轩辕镜像加速

🔧

宝塔面板 Docker 镜像下载加速教程

在宝塔面板中配置轩辕镜像加速，提升服务器管理效率

💾

群晖 NAS Docker 镜像下载加速教程

在 Synology 群晖NAS系统中配置轩辕镜像加速

🐂

飞牛fnOS Docker 镜像下载加速教程

在飞牛fnOS系统中配置轩辕镜像加速

📱

极空间 NAS Docker 镜像下载加速教程

在极空间NAS中配置轩辕镜像加速

⚡

爱快路由 ikuai Docker 镜像下载加速教程

在爱快ikuai系统中配置轩辕镜像加速

🔗

绿联 NAS Docker 镜像下载加速教程

在绿联NAS系统中配置轩辕镜像加速

🌐

威联通 NAS Docker 镜像下载加速教程

在威联通NAS系统中配置轩辕镜像加速

📦

Podman Docker 镜像下载加速教程

在 Podman 中配置轩辕镜像加速，支持多系统

📚

ghcr、Quay、nvcr、k8s、gcr 等仓库下载镜像加速教程

配置轩辕镜像加速9大主流镜像仓库，包含详细配置步骤

🚀

专属域名方式进行 Docker 镜像下载加速教程

无需登录即可使用轩辕镜像加速服务，更加便捷高效

需要其他帮助？请查看我们的常见问题或官方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 镜像加速服务

轩辕镜像平台优势

镜像下载指南