该镜像注册 qemu-*-static 二进制到宿主机 binfmt_misc，使 Docker 可直接拉取并执行 foreign arch 镜像层。典型场景为 CI 中 docker buildx build --platform linux/arm64 或在 amd64 服务器测试 arm 镜像。需要 --privileged 或挂载 /proc/sys/fs/binfmt_misc，存在较高权限风险，生产节点应限制使用范围，完成后可卸载 binfmt 规则。

快速启动

docker run --rm --privileged \
  docker.io/xfan1024/qemu-user-static:latest \
  --reset -p yes

推荐实践

docker run --rm --privileged \
  docker.io/xfan1024/qemu-user-static:7.0.0 \
  --reset -p yes -c yes

核心参数说明

• --privileged — 注册 binfmt_misc 规则所必需
• --reset -p yes — 重置并持久化 qemu 处理器映射
• -c yes — 启用 CPU 特性标志传递（部分架构需要）
• --rm — 注册完成后容器可退出
• 安全警告 — 仅在构建机或隔离 CI 节点使用，勿长期在生产业务节点保持 privileged