📚 课程目录第4章 QEMU网络配置

4. QEMU 网络配置：用户模式网络、TAP/TUN 网络桥接、网络性能调优

嵌入式系统仿真中，网络是连接 Guest 与 Host、Guest 与外部世界的核心通道。QEMU 提供了多种网络后端，从零配置的“用户模式”到高性能的“TAP/TUN 桥接”，再到精细化的性能调优参数。本章将系统梳理这三种模式的原理、配置方法与适用场景。

学习目标：掌握 QEMU 用户模式网络的局限性；理解 TAP/TUN 设备与 Linux 网桥的协作机制；能够根据项目需求选择合适的网络模型并进行基础性能调优。

4.1 用户模式网络（User Mode Networking）

用户模式网络是 QEMU 默认的网络后端，无需 Host 特权（root）即可运行。QEMU 内部实现了一个极简的协议栈（SLiRP），为 Guest 提供 NAT 访问能力。

4.1.1 工作原理

NAT 网关：QEMU 进程在用户态模拟 DHCP 服务器和 NAT 路由器，Guest 默认获取 10.0.2.0/24 网段地址。
端口转发：通过 hostfwd 参数将 Host 端口映射到 Guest 端口。
限制：Guest 无法被 Host 外部直接访问；不支持 ICMP（ping）；性能较低，单连接吞吐通常低于 100Mbps。

典型启动命令：

qemu-system-arm -M virt -kernel zImage \
    -netdev user,id=net0,hostfwd=tcp::2222-:22 \
    -device virtio-net-device,netdev=net0

上述命令将 Host 的 2222 端口转发至 Guest 的 SSH 端口（22），实现远程登录。

4.1.2 用户模式网络拓扑

下图展示了用户模式网络内部的数据流路径：Guest 发出的 IP 包经过 QEMU 内置的 SLiRP 协议栈进行 NAT 转换，最终通过 Host 的物理网卡发出。

4.2 TAP/TUN 网络桥接

当需要 Guest 与 Host 处于同一广播域、或需要外部设备直接访问 Guest 时，必须使用 TAP/TUN 设备配合 Linux 网桥。TAP 模拟二层以太网设备，TUN 模拟三层点对点设备。嵌入式调试中，TAP + 网桥是最常用的高性能方案。

4.2.1 核心概念对比

特性	用户模式 (SLiRP)	TAP 模式	TUN 模式
网络层次	三层 (IP)	二层 (以太网)	三层 (IP)
Host 权限	无需 root	需要 root / cap_net_admin	需要 root / cap_net_admin
外部访问 Guest	仅端口转发	直接 IP 可达	直接 IP 可达
性能	低 (~100Mbps)	高 (接近原生)	中
典型场景	快速验证、桌面测试	嵌入式网络调试、NFS 启动	VPN、隧道

4.2.2 网桥搭建步骤

安装依赖：sudo apt install bridge-utils uml-utilities

创建网桥并绑定物理网卡：

sudo brctl addbr br0
sudo brctl addif br0 eth0
sudo ip addr del 192.168.1.100/24 dev eth0
sudo ip addr add 192.168.1.100/24 dev br0
sudo ip link set br0 up

创建 TAP 设备并加入网桥：

sudo ip tuntap add dev tap0 mode tap user $(whoami)
sudo brctl addif br0 tap0
sudo ip link set tap0 up

启动 QEMU 并连接 TAP 设备：

qemu-system-arm -M virt -kernel zImage \
    -netdev tap,id=net0,ifname=tap0,script=no,downscript=no \
    -device virtio-net-device,netdev=net0

权限注意：非 root 用户运行 QEMU 时，需确保 TAP 设备已通过 user 选项授权。若使用 script=no，需手动配置网桥；若使用默认脚本，QEMU 会自动调用 /etc/qemu-ifup，该脚本需具有可执行权限。

4.2.3 TAP 桥接网络拓扑

下图展示了 TAP 设备与 Linux 网桥的协作关系：Guest 的 virtio-net 设备通过 TAP 接口直接连接到 Host 网桥，实现二层透明通信。

4.3 网络性能调优

嵌入式仿真中，网络性能瓶颈通常出现在中断处理、数据拷贝和虚拟化开销三个环节。以下调优手段可显著提升吞吐量并降低延迟。

4.3.1 关键调优参数

参数 / 技术	作用	推荐值 / 用法
`virtio-net`	半虚拟化网卡，减少 VM-Exit 次数	默认启用，替代 e1000/rtl8139
`mq=on`	多队列 virtio-net，利用多核并行	搭配 `vectors=N` 使用
`csum=off,gso=off`	关闭 Guest 校验和卸载，避免 Host 不支持时的回退	Host 网卡不支持 TSO 时使用
`host_mtu=9000`	启用巨型帧，减少包数量	需 Host 和交换机同时支持
`vhost=on`	将数据面卸载到内核 vhost 模块，减少 QEMU 用户态干预	Linux 内核默认支持
CPU pinning	将 QEMU vCPU 线程绑定到物理核	`taskset -c 0-3`

4.3.2 vhost-net 加速原理

vhost-net 是 Linux 内核中的 virtio 后端加速模块。传统模式下，Guest 发送数据需经过：Guest → KVM → QEMU 用户态 → Host 内核。启用 vhost 后，数据面直接从 KVM 进入 vhost 内核模块，绕过 QEMU 用户态，大幅降低延迟。

启用 vhost-net 的 QEMU 命令：

qemu-system-arm -M virt -kernel zImage \
    -netdev tap,id=net0,ifname=tap0,vhost=on \
    -device virtio-net-device,netdev=net0,mq=on,vectors=6

使用 vhost=on 后，可通过 cat /sys/kernel/debug/vhost/vhost_pid 确认 vhost 线程已创建。

4.3.3 性能对比参考

网络模式	吞吐量 (iperf3 TCP)	延迟 (ping RTT)	CPU 占用 (Host)
用户模式 (SLiRP)	~80 Mbps	~2 ms	低
TAP + virtio	~800 Mbps	~0.3 ms	中
TAP + vhost-net	~1.5 Gbps	~0.1 ms	低
TAP + vhost + 多队列	~3.0 Gbps	~0.08 ms	中 (多核分摊)

调优检查清单：

确认 Guest 内核已编译 CONFIG_VIRTIO_NET=y 和 CONFIG_VHOST_NET=y。
Host 网卡开启多队列：ethtool -L eth0 combined 4。
使用 perf top 观察 QEMU 进程热点，若 qemu_sendv 占比高，优先启用 vhost。
对于千兆以下网络，virtio 基本够用；万兆场景必须启用 vhost + 多队列。

4.4 本章小结

用户模式网络适合快速原型验证，零配置但性能受限，仅支持端口转发。
TAP/TUN 桥接是嵌入式调试的标准方案，提供二层透明通信，支持 NFS 启动、TFTP 下载等场景。
性能调优的核心是减少数据拷贝和上下文切换：优先使用 virtio-net 设备，启用 vhost-net 加速，必要时开启多队列和 CPU pinning。
实际项目中，建议从 TAP + virtio 起步，遇到性能瓶颈时逐步启用 vhost 和多队列，避免过度优化。