linuxserver/qemu-static Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务
linuxserver/qemu-staticlinuxserver
提供QEMU静态二进制文件，支持跨架构模拟，适用于Docker环境中实现多平台应用运行。
1 次收藏下载次数: 0状态：社区镜像维护者：linuxserver仓库类型：镜像最近更新：23 天前
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
qemux
一个在Docker容器中运行虚拟机的QEMU镜像，提供Web界面控制，支持多种磁盘格式（如.iso、.qcow2、.vmdk等），并具备KVM加速等高性能选项，实现接近原生的运行速度。
9 次收藏5万+ 次下载
3 个月前更新
qemux/qemu-arm
qemux
Docker容器化的ARM架构QEMU模拟器，用于在非ARM环境中模拟ARM硬件并运行ARM架构程序。
1 次收藏1万+ 次下载
3 个月前更新
chainguard/static
chainguard
Chainguard低至零CVE容器镜像，用于构建、交付和运行安全软件。
1 次收藏10万+ 次下载
25 天前更新
docker/for-desktop-qemu
Docker 官方工具与组件镜像
用于在主机系统上运行QEMU设备模型的Docker镜像，主要用于虚拟化环境中的硬件设备模拟。
1万+ 次下载
2 年前更新
netdata/static-builder
netdata
用于创建Netdata官方静态构建的基础镜像。
2 次收藏10万+ 次下载
1 个月前更新
chainguard/k3s-static
chainguard
使用Chainguard的低至零CVE容器镜像构建、交付和运行安全软件。
1万+ 次下载
25 天前更新
镜像拉取常见问题
使用与功能问题
错误码与失败问题
manifest unknown 错误：镜像不存在或标签错误
manifest unknown 错误
TLS/SSL 证书验证失败：Docker pull 时 HTTPS 证书错误
TLS 证书验证失败
DNS 解析超时：无法解析镜像仓库地址或连接超时
DNS 解析超时
410 Gone 错误：Docker 版本过低导致协议不兼容
410 错误：版本过低
402 Payment Required 错误：流量耗尽错误提示
402 错误：流量耗尽
401 UNAUTHORIZED 错误：身份认证失败或登录信息错误
身份认证失败错误
429 Too Many Requests 错误：请求频率超出专业版限制
429 限流错误
Docker login 凭证保存错误：Cannot autolaunch D-Bus（不影响登录）
凭证保存错误
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"