QEMU 虚拟化完全指南 / 13 - 用户模式

13 - 用户模式

掌握 QEMU 用户模式仿真（qemu-user）、静态翻译、binfmt_misc 配置与跨架构程序运行。

13.1 用户模式概述

QEMU 用户模式（User Mode）允许在宿主操作系统上直接运行其他架构的 Linux 用户态程序，无需启动完整的虚拟机。

用户模式 vs 全系统模式:
  ┌─────────────────────────────┐   ┌──────────────────────────────┐
  │  全系统模式 (System Mode)    │   │  用户模式 (User Mode)        │
  │                             │   │                              │
  │  ┌──────────────────────┐  │   │  ┌────────────────────────┐  │
  │  │  Guest OS             │  │   │  │  ARM64 二进制程序       │  │
  │  │  ┌─────────────────┐ │  │   │  │  (a.out)               │  │
  │  │  │  ARM64 程序      │ │  │   │  └──────────┬───────────┘  │
  │  │  └─────────────────┘ │  │   │             │              │
  │  │  ┌─────────────────┐ │  │   │  ┌──────────┴───────────┐  │
  │  │  │  ARM64 内核      │ │  │   │  │  qemu-aarch64        │  │
  │  │  └─────────────────┘ │  │   │  │  (系统调用翻译)       │  │
  │  └──────────────────────┘  │   │  └──────────┬───────────┘  │
  │  ┌──────────────────────┐  │   │             │              │
  │  │  QEMU + TCG           │  │   │  ┌──────────┴───────────┐  │
  │  └──────────────────────┘  │   │  │  x86_64 Linux 内核    │  │
  │  ┌──────────────────────┐  │   │  └──────────────────────┘  │
  │  │  Host OS              │  │   │  ┌──────────────────────┐  │
  │  └──────────────────────┘  │   │  │  Host OS              │  │
  └─────────────────────────────┘   │  └──────────────────────┘  │
                                    └──────────────────────────────┘

用户模式特点

特性	用户模式	全系统模式
启动速度	毫秒级	秒/分钟级
内存占用	仅程序所需	需要完整 OS 内存
文件系统	共享宿主文件系统	独立虚拟磁盘
网络	共享宿主网络	虚拟网络
系统调用	翻译到宿主内核	虚拟机内核处理
支持平台	仅 Linux	任意 OS

13.2 安装 qemu-user

# Debian/Ubuntu
sudo apt install -y qemu-user qemu-user-static

# Fedora/RHEL
sudo dnf install -y qemu-user

# Arch Linux
sudo pacman -S qemu-user-static

# 验证安装
qemu-aarch64 --version
qemu-riscv64 --version
qemu-arm --version

支持的用户模式目标

# 查看所有已安装的用户模式二进制
ls /usr/bin/qemu-*
# qemu-aarch64          ARM64
# qemu-aarch64-static   ARM64 (静态链接)
# qemu-arm              ARM32
# qemu-riscv64          RISC-V 64 位
# qemu-riscv32          RISC-V 32 位
# qemu-mips64el         MIPS64 小端序
# qemu-ppc64le          PowerPC 64 位小端序
# qemu-s390x            IBM System z
# qemu-x86_64           x86_64 (偶尔用于调试)
# ...

13.3 基本使用

运行交叉编译的二进制

# 准备 ARM64 静态编译的程序
cat > hello.c << 'EOF'
#include <stdio.h>
#include <sys/utsname.h>

int main() {
    struct utsname uts;
    uname(&uts);
    printf("Hello from %s!\n", uts.machine);
    printf("OS: %s %s\n", uts.sysname, uts.release);
    return 0;
}
EOF

# 交叉编译（静态链接）
aarch64-linux-gnu-gcc -o hello-arm64 hello.c -static

# 使用 qemu-user 运行
qemu-aarch64 ./hello-arm64
# 输出: Hello from aarch64!
#       OS: Linux 5.15.0-...

# 对比原生运行
./hello-x86_64
# 输出: Hello from x86_64!
#       OS: Linux 5.15.0-...

运行动态链接程序

# 动态链接程序需要目标架构的共享库
# 方法 1: 使用 -L 指定库路径
qemu-aarch64 -L /usr/aarch64-linux-gnu/ ./hello-arm64-dynamic

# 方法 2: 使用 QEMU_LD_PREFIX 环境变量
export QEMU_LD_PREFIX=/usr/aarch64-linux-gnu
qemu-aarch64 ./hello-arm64-dynamic

# 方法 3: 使用系统 sysroot
sudo apt install libc6-arm64-cross
qemu-aarch64 -L /usr/aarch64-linux-gnu/ ./hello-arm64-dynamic

常用 qemu-user 参数

参数	说明	示例
`-L`	指定库搜索路径	`-L /usr/aarch64-linux-gnu/`
`-E`	设置环境变量	`-E LD_DEBUG=all`
`-cpu`	指定 CPU 类型	`-cpu cortex-a72`
`-strace`	跟踪系统调用
`-d`	调试选项	`-d in_asm,exec`
`-g`	GDB 调试端口	`-g 1234`
`-0`	以 root 身份运行	仅限静态程序

13.4 binfmt_misc 配置

binfmt_misc 是 Linux 内核的二进制格式识别机制，允许内核自动识别并使用 QEMU 运行其他架构的二进制文件。

使用 qemu-user-static

# 安装 qemu-user-static（包含静态链接的 QEMU）
sudo apt install -y qemu-user-static

# 注册 binfmt_misc 条目
# qemu-user-static 安装后通常自动注册
# 手动注册:
sudo update-binfmts --enable qemu-aarch64
sudo update-binfmts --enable qemu-arm
sudo update-binfmts --enable qemu-riscv64

# 查看已注册的 binfmt
ls /proc/sys/fs/binfmt_misc/
cat /proc/sys/fs/binfmt_misc/qemu-aarch64

手动注册 binfmt

# 注册 ARM64 二进制格式
echo ':qemu-aarch64:M::\x7fELF\x02\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\xb7\x00:\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff:/usr/bin/qemu-aarch64-static:' | sudo tee /proc/sys/fs/binfmt_misc/register

# 注册 RISC-V 64 位二进制格式
echo ':qemu-riscv64:M::\x7fELF\x02\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\xf3\x00:\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff:/usr/bin/qemu-riscv64-static:' | sudo tee /proc/sys/fs/binfmt_misc/register

持久化 binfmt 配置

# 创建 systemd 服务或使用 update-binfmts
# Debian/Ubuntu 使用 update-binfmts

# 查看已注册的格式
sudo update-binfmts --display qemu-aarch64

# 启用/禁用
sudo update-binfmts --enable qemu-aarch64
sudo update-binfmts --disable qemu-aarch64

验证 binfmt_misc

# 注册后可以直接执行其他架构的二进制
./hello-arm64
# 输出: Hello from aarch64!

# 注意：必须是静态链接的二进制，或者有对应的动态库
file ./hello-arm64
# hello-arm64: ELF 64-bit LSB executable, ARM aarch64, ...

13.5 系统调用翻译

QEMU 用户模式将目标架构的系统调用翻译为宿主架构的系统调用：

系统调用翻译流程:
  ARM64 程序: write(1, "Hello", 5)
       │
  qemu-aarch64: 翻译 ARM64 syscall 指令
       │
  x86_64 内核: write(1, "Hello", 5)

系统调用跟踪

# 使用 -strace 跟踪系统调用
qemu-aarch64 -strace ./hello-arm64

# 输出示例:
# 12345 openat(AT_FDCWD, "/etc/ld.so.cache", O_RDONLY|O_CLOEXEC) = 3
# 12345 read(3, "\177ELF...", 4096) = 4096
# 12345 write(1, "Hello from aarch64!\n", 20) = 20
# 12345 exit_group(0)

不支持的系统调用

# 某些系统调用可能不被支持或翻译不完全
# 例如: io_uring, certain seccomp filters, eBPF

# 查看支持状态
qemu-aarch64 -strace -E SECCOMP_LOG=1 ./program 2>&1 | grep -i "not supported"

13.6 GDB 调试跨架构程序

# 启动程序并等待 GDB 连接
qemu-aarch64 -g 1234 ./hello-arm64

# 在另一个终端使用 GDB 连接
gdb-multiarch ./hello-arm64
# (gdb) target remote :1234
# (gdb) break main
# (gdb) continue
# (gdb) info registers
# (gdb) stepi

GDB 多架构调试配置

# 安装 gdb-multiarch
sudo apt install gdb-multiarch

# 安装架构特定的 GDB
sudo apt install gdb-aarch64-linux-gnu
sudo apt install gdb-riscv64-linux-gnu

13.7 chroot 环境

使用 qemu-user-static 可以在 x86_64 主机上 chroot 进入其他架构的根文件系统：

# 下载 ARM64 根文件系统
wget https://cdimage.ubuntu.com/ubuntu-base/releases/22.04/release/ubuntu-base-22.04-base-arm64.tar.gz

# 解压
mkdir -p arm64-rootfs
sudo tar -xzf ubuntu-base-22.04-base-arm64.tar.gz -C arm64-rootfs

# 复制 qemu-user-static
sudo cp /usr/bin/qemu-aarch64-static arm64-rootfs/usr/bin/

# 挂载必要的文件系统
sudo mount -t proc proc arm64-rootfs/proc
sudo mount -t sysfs sys arm64-rootfs/sys
sudo mount --bind /dev arm64-rootfs/dev
sudo mount --bind /dev/pts arm64-rootfs/dev/pts

# chroot 进入 ARM64 环境
sudo chroot arm64-rootfs /bin/bash

# 在 chroot 内执行 ARM64 命令
uname -m
# aarch64
apt update
apt install -y gcc
echo 'int main(){return 0;}' | gcc -x c - -o test
file test
# test: ELF 64-bit LSB executable, ARM aarch64, ...

# 退出 chroot
exit

# 清理挂载
sudo umount arm64-rootfs/{dev/pts,dev,sys,proc}

Docker 中使用 binfmt_misc

# 注册多架构 binfmt（Docker 推荐方式）
docker run --privileged --rm tonistiigi/binfmt --install all

# 验证
ls /proc/sys/fs/binfmt_misc/qemu-*

# 运行 ARM64 容器
docker run --rm --platform linux/arm64 arm64v8/ubuntu:22.04 uname -m
# aarch64

13.8 实用场景

场景 1：CI/CD 中的多架构测试

# GitHub Actions 多架构测试
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Set up QEMU
        uses: docker/setup-qemu-action@v3
      
      - name: Run ARM64 tests
        run: |
          docker run --rm --platform linux/arm64 \
            -v ${{ github.workspace }}:/work \
            -w /work \
            arm64v8/ubuntu:22.04 \
            bash -c "apt update && apt install -y gcc && gcc -o test test.c && ./test"

场景 2：跨架构性能测试

#!/bin/bash
# bench-arch.sh - 跨架构基准测试

ARCHS="aarch64 riscv64 arm mips64el"

for arch in $ARCHS; do
    echo "=== Testing $arch ==="
    
    # 获取对应的 qemu-user
    qemu_cmd="qemu-${arch}"
    
    if command -v $qemu_cmd &>/dev/null; then
        # 运行性能测试
        time $qemu_cmd ./bench-${arch} 2>&1 | tail -1
    else
        echo "跳过 $arch (qemu-user 未安装)"
    fi
    echo ""
done

场景 3：文件格式转换

# 使用 qemu-user 运行其他架构的工具
# 例如：运行 ARM64 版本的特定工具

# 查看 ARM64 二进制的信息
qemu-aarch64 -strace /usr/aarch64-linux-gnu/bin/objdump -x binary.o

13.9 故障排查

问题	原因	解决方案
“No such file”	binfmt 未注册	检查 /proc/sys/fs/binfmt_misc/
共享库找不到	LD_PREFIX 未设置	使用 -L 或 QEMU_LD_PREFIX
段错误	内存映射不兼容	更新 QEMU 版本
系统调用失败	不支持的系统调用	检查 strace 输出
性能极差	TCG 纯翻译	这是正常现象，仅用于测试

# 调试 qemu-user 问题
QEMU_LOG=guest_errors qemu-aarch64 ./program 2>&1

# 检查 binfmt 注册状态
cat /proc/sys/fs/binfmt_misc/qemu-aarch64
# enabled
# interpreter /usr/bin/qemu-aarch64-static
# flags: F
# offset 0
# magic 7f454c460201010000000000000000000200b700
# fffffffffffffffffffffffffffffffeffffff

要点回顾

要点	核心内容
用户模式	直接运行跨架构用户态程序，无需启动完整 VM
binfmt_misc	Linux 内核机制，自动识别并执行跨架构二进制
系统调用翻译	qemu-user 将目标架构 syscall 翻译为宿主 syscall
chroot 环境	在 x86_64 主机上运行完整的 ARM64 用户空间
Docker 集成	通过 binfmt_misc 实现多架构容器

注意事项

仅限 Linux: 用户模式仿真只支持运行 Linux 程序，无法运行 Windows 或 macOS 程序。

静态链接: binfmt_misc 方式运行需要静态链接的 qemu-user-static，否则在 chroot 环境中无法找到 QEMU 本身。

安全性: 通过 binfmt_misc 运行的程序拥有与启动用户相同的权限，不要在生产环境中以 root 身份运行不受信任的跨架构程序。

性能: 用户模式的性能仅为原生的 10-30%，仅适用于开发测试，不适合生产工作负载。

扩展阅读

QEMU User Mode 文档
Linux binfmt_misc 文档
tonistiigi/binfmt - Docker 官方推荐的多架构 binfmt 设置

下一步

→ 14 - 虚拟机测试：学习使用 QEMU 进行自动化测试、CI 集成与 libguestfs。