clickhouse/libfuzzer

OSS Fuzzers 镜像文档

概述

OSS Fuzzers镜像是一个集成多种开源模糊测试（Fuzzing）工具的Docker镜像，旨在为开发者提供便捷、标准化的模糊测试环境，帮助自动化发现开源软件（OSS）中的安全漏洞、内存泄漏及逻辑错误等问题。

主要特性

• 多框架支持：集成主流模糊测试框架，包括AFL/AFL++、libFuzzer、Honggfuzz等，满足不同测试场景需求；
• 即开即用：预配置依赖环境（如编译器、调试工具、测试用例生成器），无需手动安装依赖；
• CI/CD集成：支持与GitHub Actions、GitLab CI等持续集成工具无缝对接，实现自动化测试流程；
• 跨平台兼容：支持x86_64架构，兼容Linux/macOS（需Docker Desktop支持）宿主机环境；
• 资源优化：针对模糊测试任务优化容器资源调度，提升测试效率。

使用场景

1. 开源项目安全审计：为GitHub、GitLab等平台的开源项目提供快速漏洞检测能力；
2. 持续集成测试：嵌入软件开发流程，在代码提交阶段自动触发模糊测试，提前发现潜在风险；
3. 漏洞研究与教育：作为模糊测试学习工具，帮助安全研究者熟悉主流工具的使用方法。

部署示例

基本使用流程

1. 拉取镜像

bash
docker pull ossfuzzers:latest

2. 运行容器并执行模糊测试 假设测试目标为本地/path/to/target目录下的C语言项目（需提前准备符合模糊测试格式的目标函数）：

bash
docker run -it --rm -v /path/to/target:/fuzz/target ossfuzzers:latest \
  /bin/bash -c "cd /fuzz/target && ./configure && make && afl-fuzz -i in -o out ./fuzz_target"

• -v /path/to/target:/fuzz/target：挂载本地测试目标代码至容器内；
• afl-fuzz -i in -o out ./fuzz_target：使用AFL框架对目标程序fuzz_target执行模糊测试，in为初始测试用例目录，out为测试结果输出目录。

注意事项

1. 宿主机资源：模糊测试需较高CPU/内存资源，建议宿主机配置≥4核CPU及8GB内存；
2. 测试目标要求：待测试程序需符合模糊测试工具的输入格式（如libFuzzer需定义LLVMFuzzerTestOneInput函数）；
3. 权限配置：挂载目录时确保容器对宿主机目录有读写权限，避免因权限不足导致测试失败。