【免费下载链接】syzkaller
syzkaller is an unsupervised coverage-guided kernel fuzzer
本文是一份完整的 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_rsaSSH 密钥对,并将其公钥写入镜像内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
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考



