linuxserver/qemu-static Docker 镜像 - 轩辕镜像
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引擎能够自动识别并运行其他架构容器。
启用与重置命令
bashdocker 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：初始发布
相关资源
- LinuxServer.io 官方网站
- QEMU 官方文档
- LinuxServer.io 社区论坛
- Docker 多架构支持文档
qemux/qemu
by qemux
一个在Docker容器中运行虚拟机的QEMU镜像，提供Web界面控制，支持多种磁盘格式（如.iso、.qcow2、.vmdk等），并具备KVM加速等高性能选项，实现接近原生的运行速度。
810K+ pulls
上次更新：1 个月前
qemux/qemu-arm
by qemux
Docker容器化的ARM架构QEMU模拟器，用于在非ARM环境中模拟ARM硬件并运行ARM架构程序。
110K+ pulls
上次更新：1 个月前
chainguard/static
by Chainguard, Inc.
认证
Chainguard低至零CVE容器镜像，用于构建、交付和运行安全软件。
1100K+ pulls
上次更新：2 天前
docker/for-desktop-qemu
by Docker, Inc.
认证
用于在主机系统上运行QEMU设备模型的Docker镜像，主要用于虚拟化环境中的硬件设备模拟。
10K+ pulls
上次更新：2 年前
netdata/static-builder
by Netdata
认证
用于创建Netdata官方静态构建的基础镜像。
1100K+ pulls
上次更新：2 天前
chainguard/k3s-static
by Chainguard, Inc.
认证
使用Chainguard的低至零CVE容器镜像构建、交付和运行安全软件。
10K+ pulls
上次更新：2 天前
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
登录仓库拉取
通过 Docker 登录认证访问私有仓库
Linux
在 Linux 系统配置镜像服务
Windows/Mac
在 Docker Desktop 配置镜像
Docker Compose
Docker Compose 项目配置
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
宝塔面板
在宝塔面板一键配置镜像
群晖
Synology 群晖 NAS 配置
飞牛
飞牛 fnOS 系统配置镜像
极空间
极空间 NAS 系统配置服务
爱快路由
爱快 iKuai 路由系统配置
绿联
绿联 NAS 系统配置镜像
威联通
QNAP 威联通 NAS 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
专属域名拉取
无需登录使用专属域名
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
轩辕镜像免费版与专业版有什么区别？
免费版仅支持 Docker Hub 访问，不承诺可用性和速度；专业版支持更多镜像源，保证可用性和稳定速度，提供优先客服响应。
轩辕镜像支持哪些镜像仓库？
专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等；免费版仅支持 docker.io。
流量耗尽错误提示
当返回 402 Payment Required 错误时，表示流量已耗尽，需要充值流量包以恢复服务。
410 错误问题
通常由 Docker 版本过低导致，需要升级到 20.x 或更高版本以支持 V2 协议。
manifest unknown 错误
先检查 Docker 版本，版本过低则升级；版本正常则验证镜像信息是否正确。
镜像拉取成功后，如何去掉轩辕镜像域名前缀？
使用 docker tag 命令为镜像打上新标签，去掉域名前缀，使镜像名称更简洁。
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"