syzkaller 环境搭建实战:Ubuntu 宿主机 + QEMU 虚拟机 + x86-64 内核

  • 网络安全
  • 开发工具
  • 质量保障

【免费下载链接】syzkaller

syzkaller is an unsupervised coverage-guided kernel fuzzer

项目地址: https://gitcode.com/gh_mirrors/sy/syzkaller
点击查看 免费下载

本文是一份完整的 syzkaller(无监督的覆盖率引导内核模糊测试工具)实战部署指南,面向 Ubuntu 宿主机、以 QEMU 作为虚拟机层、以 x86-64 Linux 内核作为被测对象的经典组合。按照本文操作,你将依次完成工具链准备、内核检出与覆盖率配置、Debian 虚拟机镜像构建、QEMU 启动验证,以及 syz-manager 配置与启动,最终在浏览器中看到 syzkaller 的实时模糊测试状态页面。

本文对应的官方文档为 docs/linux/setup_ubuntu-host_qemu-vm_x86-64-kernel.md,示例场景为 Ubuntu 宿主机 + QEMU 实例内的 Debian Trixie 系统。文中使用 $VAR 记法(如 $GCC、$KERNEL、$IMAGE)表示目录路径:有些目录会在执行命令时自动创建(例如解压 GCC 归档后产生的新目录),有些需要你预先创建,请在运行前手动替换这些变量的实际值。

前置条件安装

在 Ubuntu 宿主机上首先更新软件源并安装内核编译所必需的软件包:

sudo apt update
sudo apt install make gcc flex bison libncurses-dev libelf-dev libssl-dev

其中 flex、bison 用于解析内核 Kconfig 与 C 源码,libncurses-dev 提供 make menuconfig 所需的文本界面库,libelf-dev 用于生成与读取 ELF 格式的 vmlinux,libssl-dev 是内核构建签名与证书相关工具链的依赖。

GCC 编译器准备

syzkaller 是覆盖率引导型模糊测试器,要求内核以覆盖率支持(KCOV)编译,因此依赖较新的 GCC 版本——覆盖率支持自 GCC 6.1.0 起进入上游(详见 docs/linux/setup.md)。

如果你的发行版自带 GCC 版本过旧,建议从 docs/syzbot.md 中 "crash does not reproduce" 一节给出的列表获取最新 GCC。下载并解压到 $GCC 后,GCC 二进制文件应位于 $GCC/bin/ 下:

ls $GCC/bin/
# 示例输出:
# cpp     gcc-ranlib  x86_64-pc-linux-gnu-gcc        x86_64-pc-linux-gnu-gcc-ranlib
# gcc     gcov        x86_64-pc-linux-gnu-gcc-9.0.0
# gcc-ar  gcov-dump   x86_64-pc-linux-gnu-gcc-ar
# gcc-nm  gcov-tool   x86_64-pc-linux-gnu-gcc-nm

Ubuntu 20.04 LTS:可以跳过本节,系统自带 GCC 已足够新。

后续所有 make 命令都可以通过 CC="$GCC/bin/gcc" 显式指定编译器;如果你的 gcc 已在 PATH 中,也可以省略该参数。

内核准备

检出 Linux 内核源码

git clone --branch v6.2 git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git $KERNEL

建议从最新稳定版本开始,这里的 v6.2 仅作示例。也可以从当前仓库 dashboard/config/linux 下的大量 .config 参考文件(例如 syzbot 使用的 upstream-apparmor-kasan.config)侧面了解官方长期维护的内核配置基线。

生成默认配置

cd $KERNEL
make defconfig
make kvm_guest.config

或指定编译器:

cd $KERNEL
make CC="$GCC/bin/gcc" defconfig
make CC="$GCC/bin/gcc" kvm_guest.config

defconfig 生成面向当前架构的默认配置;kvm_guest.config 是内核提供的增量配置,用于让内核在 KVM/QEMU 虚拟化环境中良好运行(docs/linux/kernel_configs.md 明确说明:在虚拟机中运行一般需要执行 make kvm_guest.config)。

启用 syzkaller 必需的配置项

按 docs/linux/kernel_configs.md 中的建议启用内核配置。不需要全部打开,但至少需要以下选项:

# 覆盖率收集。
CONFIG_KCOV=y

# 用于符号化的调试信息。
CONFIG_DEBUG_INFO_DWARF4=y

# 内存错误检测器
CONFIG_KASAN=y
CONFIG_KASAN_INLINE=y

# Debian Stretch 及之后版本所需
CONFIG_CONFIGFS_FS=y
CONFIG_SECURITYFS=y

可以手动编辑 .config 文件,也可以通过 make menuconfig 界面操作。由于启用上述选项后会解锁更多子选项,需要重新生成配置:

make olddefconfig

或指定编译器:

make CC="$GCC/bin/gcc" olddefconfig

从 docs/linux/kernel_configs.md 的完整清单看,除了上述必选项目,为了获得更好的模糊测试效果还推荐关注以下组:

  • 覆盖率增强:CONFIG_KCOV_INSTRUMENT_ALL=y、CONFIG_KCOV_ENABLE_COMPARISONS=y(后者要求 GCC 8+ 并需老内核回移两个 kcov commit)、CONFIG_DEBUG_FS=y;
  • Web 界面显示代码覆盖率:Linux < 5.12 用 CONFIG_DEBUG_INFO=y,Linux >= 5.12 用 CONFIG_DEBUG_INFO_DWARF_TOOLCHAIN_DEFAULT=y;
  • 检测已启用系统调用与内核位宽:CONFIG_KALLSYMS=y、CONFIG_KALLSYMS_ALL=y;
  • 更好的沙箱支持:CONFIG_NAMESPACES=y 及其下的 CONFIG_UTS_NS、CONFIG_IPC_NS、CONFIG_PID_NS、CONFIG_NET_NS、CONFIG_CGROUP_PIDS、CONFIG_MEMCG,以及使用 namespace 沙箱所需的 CONFIG_USER_NS=y;
  • 其他内存调试器:kmemleak(CONFIG_DEBUG_KMEMLEAK=y)、KTSAN、KMSAN、KUBSAN(CONFIG_UBSAN=y)等;
  • 故障注入:CONFIG_FAULT_INJECTION=y、CONFIG_FAULT_INJECTION_DEBUG_FS=y、CONFIG_FAULT_INJECTION_USERCOPY=y、CONFIG_FAILSLAB=y、CONFIG_FAIL_PAGE_ALLOC=y、CONFIG_FAIL_MAKE_REQUEST=y、CONFIG_FAIL_IO_TIMEOUT=y、CONFIG_FAIL_FUTEX=y;
  • 锁与内存子系统调试:CONFIG_LOCKDEP、CONFIG_PROVE_LOCKING、CONFIG_DEBUG_ATOMIC_SLEEP、CONFIG_PROVE_RCU、CONFIG_DEBUG_VM、CONFIG_REFCOUNT_FULL、CONFIG_FORTIFY_SOURCE、CONFIG_HARDENED_USERCOPY、CONFIG_LOCKUP_DETECTOR、CONFIG_SOFTLOCKUP_DETECTOR、CONFIG_HARDLOCKUP_DETECTOR、CONFIG_BOOTPARAM_HARDLOCKUP_PANIC、CONFIG_DETECT_HUNG_TASK、CONFIG_WQ_WATCHDOG;
  • 降低误报率:CONFIG_DEFAULT_HUNG_TASK_TIMEOUT=140、CONFIG_RCU_CPU_STALL_TIMEOUT=100。

此外建议关闭 KASLR(# CONFIG_RANDOMIZE_BASE is not set,除非你的内核已包含 arm64: setup: introduce kaslr_offset() 与 kcov: make kcov work properly with KASLR enabled 两个 commit),以保证 KCOV 覆盖率与 PC 地址的稳定性。

你还可以考虑禁用 Predictable Network Interface Names(可预测网络接口命名)机制,这既可以在 syzkaller 配置中处理(见 docs/linux/troubleshooting.md),也可以通过内核配置参数实现:

CONFIG_CMDLINE_BOOL=y
CONFIG_CMDLINE="net.ifnames=0"

编译内核

make -j`nproc`

或指定编译器:

make CC="$GCC/bin/gcc" -j`nproc`

编译完成后应得到内核二进制 vmlinux 与打包内核镜像 bzImage:

ls $KERNEL/vmlinux
# 示例输出 - $KERNEL/vmlinux
ls $KERNEL/arch/x86/boot/bzImage
# 示例输出 - $KERNEL/arch/x86/boot/bzImage

vmlinux 将用于崩溃报告符号化(对应 syz-manager 配置中的 kernel_obj),bzImage 则作为 QEMU 的 -kernel 启动镜像。

虚拟机镜像

安装 debootstrap

sudo apt install debootstrap

创建 Debian Trixie 镜像

创建一个包含最小必需软件包集的 Debian Trixie 镜像:

mkdir $IMAGE
cd $IMAGE/
wget https://raw.githubusercontent.com/google/syzkaller/master/tools/create-image.sh -O create-image.sh
chmod +x create-image.sh
./create-image.sh

仓库中的 tools/create-image.sh 与上述下载脚本一致(仓库内直接查看该文件即可,无需联网)。执行完成后,结果应为 $IMAGE/trixie.img 磁盘镜像。

从 tools/create-image.sh 源码可以看到该脚本的关键行为:

  • 使用 debootstrap --arch=$DEBARCH --include=$PREINSTALL_PKGS --components=main,contrib,non-free,non-free-firmware 构建最小 Debian 系统,默认 PREINSTALL_PKGS 为 openssh-server,curl,tar,gcc,libc6-dev,time,strace,sudo,less,psmisc,selinux-utils,policycoreutils,checkpolicy,selinux-policy-default,firmware-atheros,debian-ports-archive-keyring,覆盖了 syzkaller VM 的通用要求(SSH 服务、网络、sudo 等,见 docs/linux/setup.md 的 "VM Setup" 一节);
  • 自动配置免密 root 登录:生成 $DIR.id_rsa SSH 密钥对,并将其公钥写入镜像内 root/.ssh/authorized_keys,同时清空 /etc/passwd 中 root 的密码位;
  • 在 etc/fstab 中挂载 debugfs、securityfs、configfs 等文件系统——这正是 syzkaller 读取 KCOV 覆盖率、访问安全与配置文件的运行前提;
  • 用 dd + mkfs.ext4 构建磁盘镜像,默认镜像大小为 2048 MB(SEEK=2047)。

或创建其他版本的 Debian 镜像

要创建其他 Debian 版本(如 bookworm、bullseye、sid),使用 --distribution 选项:

./create-image.sh --distribution bookworm

镜像附加工具

有时在 VM 中准备一些非 syzkaller 必需但便于调试的额外软件包会很有用:

./create-image.sh --feature full

full 会在默认软件包基础上追加 ADD_PACKAGE(默认为 make,sysbench,git,vim,tmux,usbutils,tcpdump),具体列表可在脚本中自行编辑。

安装 perf(运行 syzkaller 并不必需;需要 $KERNEL 指向内核源码树,脚本会将内核源码拷入 chroot 编译 tools/perf):

./create-image.sh --add-perf

更多 create-image.sh 选项可执行 ./create-image.sh -h 查看,包括:

-a, --arch         设置架构(默认:宿主机架构)
-d, --distribution 设置 Debian 发行版(默认:trixie)
-f, --feature      选择安装的软件包集合:minimal、full(默认:minimal)
-o, --output       设置输出前缀(默认:发行版名)
-p, --add-perf     添加 perf 支持,需要环境变量 $KERNEL
-s, --seek         镜像大小(MB,默认 2048)

镜像默认以 ./<output> 目录作为 chroot、./<output>.img 作为最终镜像、./<output>.id_rsa[.pub] 作为 SSH 密钥。

QEMU

安装 QEMU

sudo apt install qemu-system-x86

验证内核可启动且 sshd 已运行

qemu-system-x86_64 \
	-m 2G \
	-smp 2 \
	-kernel $KERNEL/arch/x86/boot/bzImage \
	-append "console=ttyS0 root=/dev/sda earlyprintk=serial net.ifnames=0" \
	-drive file=$IMAGE/trixie.img,format=raw \
	-net user,host=10.0.2.10,hostfwd=tcp:127.0.0.1:10021-:22 \
	-net nic,model=e1000 \
	-enable-kvm \
	-nographic \
	-pidfile vm.pid \
	2>&1 | tee vm.log
early console in setup code
early console in extract_kernel
input_data: 0x0000000005d9e276
input_len: 0x0000000001da5af3
output: 0x0000000001000000
output_len: 0x00000000058799f8
kernel_total_size: 0x0000000006b63000

Decompressing Linux... Parsing ELF... done.
Booting the kernel.
[    0.000000] Linux version 4.12.0-rc3+ ...
[    0.000000] Command line: console=ttyS0 root=/dev/sda debug earlyprintk=serial
...
[ ok ] Starting enhanced syslogd: rsyslogd.
[ ok ] Starting periodic command scheduler: cron.
[ ok ] Starting OpenBSD Secure Shell server: sshd.

看到日志末尾 sshd 启动成功,说明内核与镜像都已就绪。随后可在另一个终端通过 SSH 连接到该 QEMU 实例:

ssh -i $IMAGE/trixie.id_rsa -p 10021 -o "StrictHostKeyChecking no" root@localhost

排错与收尾

  • 若出现 "too many tries" 错误,可能是 ssh 在显式指定的 -i 密钥之前先尝试了默认密钥,追加 -o "IdentitiesOnly yes" 即可;
  • 杀掉运行中的 QEMU 实例:按 Ctrl+A 再按 X,或执行:
kill $(cat vm.pid)
  • 若 VM 报告 "Failed to start Raise network interfaces"(进而导致 syzkaller 无法连接 VM),通常是可预测网络接口命名机制所致。两种解法见前文内核配置段与下文 syzkaller 配置段(在 VM 配置中加 "cmdline": "net.ifnames=0",但不保证所有虚拟化技术下都有效);

  • 如果 SSH 不通,先确认内核配置包含网络支持,defconfig 有时过于精简而遗漏以下选项(见 docs/linux/troubleshooting.md):

    CONFIG_VIRTIO_NET=y
    CONFIG_E1000=y
    CONFIG_E1000E=y
    
  • 若 QEMU 报 failed to set MSR 0x48b ... 之类的 KVM 错误,可移除 -cpu host,migratable=off,最简单的方式是在 syz-manager 配置中将 qemu_args 设为 -enable-kvm(见 docs/linux/setup.md);

  • 从源码角度看,QEMU 的默认启动参数由 vm/qemu/qemu.go 中的 archConfigs 表按 OS/arch 匹配生成,例如 linux/amd64 默认 QemuArgs 为 -enable-kvm -cpu host,migratable=off、默认 NetDev 为 e1000、默认内核命令行含 root=/dev/sda console=ttyS0,同时还会附带 virtio-rng-pci 随机数设备;Config 结构体(同文件)定义了可在 vm 配置段覆盖的 count、qemu、qemu_args、kernel、cmdline、cpu、mem、image_device、network_device 等参数。

当 QEMU 能正常启动、内核能引导、SSH 能连通后,关闭 QEMU,开始运行 syzkaller。

运行 syzkaller

构建 syzkaller

按 docs/linux/setup.md 中 "Go and syzkaller" 一节构建:syzkaller 使用 Go 编写,需要 Go 1.23+ 工具链,然后 git clone 本项目源码并执行 make,编译产物出现在 bin/ 目录下。

创建 manager 配置

创建如下 manager 配置文件,并将 $GOPATH、$KERNEL、$IMAGE 替换为实际路径:

{
	"target": "linux/amd64",
	"http": "127.0.0.1:56741",
	"workdir": "$GOPATH/src/github.com/google/syzkaller/workdir",
	"kernel_obj": "$KERNEL",
	"image": "$IMAGE/trixie.img",
	"sshkey": "$IMAGE/trixie.id_rsa",
	"syzkaller": "$GOPATH/src/github.com/google/syzkaller",
	"procs": 8,
	"type": "qemu",
	"vm": {
		"count": 4,
		"kernel": "$KERNEL/arch/x86/boot/bzImage",
		"cpu": 2,
		"mem": 2048
	}
}

各字段含义可对照 pkg/mgrconfig/config.go 中的 Config 结构体理解:

  • target:被测目标 OS/架构,此处为 linux/amd64;
  • http:syz-manager 状态页面的监听地址;
  • workdir:工作目录,崩溃输出位于其下 crashes/,语料库位于 corpus.db,各 VM 临时文件位于 instance-x/;
  • kernel_obj:内核对象目录(用于报告符号化与覆盖率报告,即存放 vmlinux 的目录);
  • image:磁盘镜像文件路径;
  • sshkey:宿主机上用于登录 VM 的 root SSH 私钥(对应 create-image.sh 生成的 trixie.id_rsa,syzkaller 会用它向 VM 传输二进制);
  • syzkaller:syzkaller 检出目录,syz-manager 会在其 bin/ 子目录查找各二进制;
  • procs:每个 VM 内并行执行的测试进程数,合法范围为 1–32,推荐约 4–8,默认 6,需在不过度超订 CPU/内存导致 OOM 与虚假挂起之间取舍;
  • type:VM 类型,此处为 qemu;
  • vm:QEMU 专属参数,count 为并行 VM 数量(1 默认,上限 1024),kernel 为 -kernel 启动的内核镜像,cpu 为每 VM CPU 数(默认 1),mem 为每 VM 内存 MiB(默认 1024)。

若网络接口命名问题未在内核侧解决,可在 vm 段追加 "cmdline": "net.ifnames=0"(完整的含该字段配置示例见 docs/linux/troubleshooting.md)。也可以自定义 qemu_args 覆盖架构默认 QEMU 参数,支持 {{INDEX}}、{{TEMPLATE}}、{{TCP_PORT}}、{{FN%8}} 等占位符替换。

启动 syz-manager

mkdir workdir
./bin/syz-manager -config=my.cfg

现在 syzkaller 应该正在运行,用浏览器访问 127.0.0.1:56741 即可查看 manager 状态页面(包括语料库大小、崩溃数量、覆盖率趋势等统计信息)。

如果启动 syz-manager 后遇到问题,可考虑用 -debug 标志运行(该选项会让 syzkaller 只启动一个 VM 实例并打印尽可能多的调试输出,同时打开 -vv N 可提高日志详细程度,详见 docs/troubleshooting.md)。更多排错建议可参考 docs/troubleshooting.md 与 Linux 专属的 docs/linux/troubleshooting.md,例如:

  • 确认 VM 内 CONFIG_KCOV 生效:检查 ls /sys/kernel/debug(debugfs 已挂载)与 ls /sys/kernel/debug/kcov,并运行 Documentation/kcov.txt 中的测试程序;
  • 确认调试信息可用:将 kcov 测试程序的十六进制输出交给 addr2line -a -i -f -e $VMLINUX 验证内核符号可解析;
  • 若日志出现 executor failure,可将 syz-executor 与 syz-execprog 拷入 VM 手动执行 ./syz-execprog -executor ./syz-executor -debug sampleprog(例如仅含 getpid() 的脚本)定位问题;若报告 clone 失败,多半是内核缺少所需命名空间支持,可将配置中的 sandbox 改为 setuid 绕过;
  • 若 VM 启动后不久报 failed to copy binary,且使用 Buildroot 镜像时输出含 subsystem request failed on channel 0,通常与 OpenSSH 9.0 强制使用 SFTP 协议有关,请升级 Buildroot 镜像并确保开启 SFTP。

完成上述全部步骤后,你就拥有了一套可持续运行的 x86-64 Linux 内核模糊测试环境,可以在此基础上按 docs/linux/kernel_configs.md 增补调试选项、按 docs/usage.md 使用 syz-repro、syz-bisect 等周边工具进一步深挖崩溃。

  • 网络安全
  • 开发工具
  • 质量保障

【免费下载链接】syzkaller

syzkaller is an unsupervised coverage-guided kernel fuzzer

项目地址: https://gitcode.com/gh_mirrors/sy/syzkaller
点击查看 免费下载

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值