zjuchenyuan/afl

AFL镜像概述

AFL（American Fuzzy Lop）是一款基于变异的模糊测试工具，通过编译时插桩技术追踪代码覆盖率并检测程序漏洞。本镜像包含AFL版本2.52b，基于Ubuntu 16.04环境，支持gcc 5.4和clang 3.8编译器，适用于安全测试与漏洞挖掘场景。

核心功能

• 编译时插桩：通过afl-gcc/afl-clang对目标程序插桩，实现代码覆盖率追踪
• 多编译模式：支持常规编译、Clang快速模式、ASAN（AddressSanitizer）内存检测模式
• 灵活参数配置：可自定义内存限制、超时时间、种子目录及输出目录
• 完整流程指导：覆盖系统配置、目标编译、种子准备到模糊测试的全流程

使用场景

• 软件开发者进行程序漏洞检测与修复
• 安全研究人员开展漏洞挖掘工作
• 学习模糊测试技术的实践环境

配置说明

Step1: 系统配置

执行以下命令（需root/sudo权限）优化测试环境：

bash
echo "" | sudo tee /proc/sys/kernel/core_pattern # 禁用核心转储以减少I/O压力
echo 0 | sudo tee /proc/sys/kernel/core_uses_pid
echo performance | sudo tee /sys/devices/system/cpu/cpu*/cpufreq/scaling_governor
echo 0 | sudo tee /proc/sys/kernel/yama/ptrace_scope
echo 1 | sudo tee /proc/sys/kernel/sched_child_runs_first
echo 0 | sudo tee /proc/sys/kernel/randomize_va_space # 关闭ASLR（建议专用测试机使用）

提示：若出现文件不存在错误，可忽略。

Step2: 编译目标程序（以MP3Gain 1.6.2为例）

bash
# 下载并解压源码
wget https://sourceforge.net/projects/mp3gain/files/mp3gain/1.6.2/mp3gain-1_6_2-src.zip/download -O mp3gain-1_6_2-src.zip
mkdir -p mp3gain1.6.2 && cd mp3gain1.6.2 && unzip ../mp3gain-1_6_2-src.zip

# 使用镜像编译
docker run --rm -w /work -it -v `pwd`:/work --privileged zjuchenyuan/afl \
    sh -c "make clean; make"

镜像默认设置CC/CXX环境变量，直接执行make即可。若需Clang编译：CC=/afl/afl-clang-fast CXX=/afl/afl-clang-fast++ make。

Step3: 准备种子文件

bash
apt install -y subversion # 若未安装
svn export https://github.com/UNIFUZZ/dockerized_fuzzing_examples/trunk/seed/mp3 seed_mp3

Step4: 启动模糊测试

bash
mkdir -p output/afl
docker run -w /work -it -v `pwd`:/work --privileged zjuchenyuan/afl \
    afl-fuzz -i seed_mp3 -o output/afl -m 2048 -t 100+ -- ./mp3gain @@

参数解释

Docker参数

• -w /work: 设置容器工作目录
• -it: 交互式终端模式
• -v pwd:/work: 挂载主机目录到容器
• --privileged: 提升权限简化配置

AFL参数

• -i: 种子目录
• -o: 输出目录（存储崩溃/队列文件）
• -m: 内存限制（2048=2GB）
• -t: 超时时间（100+表示100ms）
• --: 分隔符，后接目标程序及参数
• @@: 变异文件占位符

高级用法

ASAN模式

编译时启用ASAN：

bash
docker run --rm -w /work -it -v `pwd`:/work --privileged zjuchenyuan/afl \
    sh -c "make clean; AFL_USE_ASAN=1 make"

运行时调整参数：

bash
mkdir -p output/aflasan
docker run -w /work -it -v `pwd`:/work --privileged zjuchenyuan/afl \
    afl-fuzz -i seed_mp3 -o output/aflasan -m none -t 500+ -- ./mp3gain @@

自定义文件名

若目标程序要求特定后缀（如.mp3）：

bash
docker run -w /work -it -v `pwd`:/work --privileged zjuchenyuan/afl /bin/bash
cd /afl && sed -i 's/.cur_input/x.mp3/g' afl-fuzz.c && make clean && CC=gcc CXX=g++ make && make install

官方文档

• AFL官方网站
• https://github.com/mirrorer/afl/tree/master/docs