OSS-Fuzz 与 ClusterFuzz分布式模糊测试基础设施的完整使用指南【免费下载链接】oss-fuzzOSS-Fuzz - continuous fuzzing for open source software.项目地址: https://gitcode.com/gh_mirrors/os/oss-fuzz导读本文聚焦于 OSS-Fuzz 项目背后的分布式模糊测试基础设施 ClusterFuzz系统讲解项目开发者接入 OSS-Fuzz 后如何使用 ClusterFuzz 提供的 Web 界面、测试用例testcase报告、Fuzzer 统计、覆盖率报告、性能分析与崩溃统计等功能并结合本仓库中的架构文档、术语表与复现指南说明崩溃报告从产生到关闭的完整链路。读完本文你将掌握 ClusterFuzz 各功能模块的定位与使用方法能够在收到崩溃报告后快速定位问题、复现 bug并借助覆盖率与性能分析持续改进自己的 fuzz target。ClusterFuzz 在 OSS-Fuzz 中的角色ClusterFuzz将其定义为 A scalable fuzzing infrastructure that is used for OSS-Fuzz backend并指出它同样被用于 Chrome 及其他众多项目的模糊测试。从本仓库的 架构文档 可以清晰地看到 ClusterFuzz 在整个 OSS-Fuzz 工作流中的位置项目维护者创建 fuzz target 并与项目的构建/测试系统集成项目被 接受进入 OSS-Fuzz开发者提交构建配置OSS-Fuzz 的 builder 根据提交的配置构建项目builder 将 fuzz target 上传到 OSS-Fuzz 的 GCS bucketClusterFuzz 下载 fuzz target 并开始模糊测试项目当 ClusterFuzz 发现 bug 时自动将问题报告到 OSS-Fuzz 的 issue tracker项目所有者被 CC 到 bug 报告中开发者修复 bug 并注明Credit to OSS-Fuzz。修复提交后ClusterFuzz 会自动验证修复是否生效、添加评论并关闭 issue。如果修复验证通过或在报告 90 天后以先到者为准该 issue 会转为公开。从源码结构看ClusterFuzz 的部署与交互逻辑也在仓库中留有痕迹例如 infra/cifuzz/clusterfuzz_deployment.py 负责 cifuzz 与 ClusterFuzz 后端的部署对接infra/utils.py 中包含与其交互的工具函数。对于普通项目开发者而言日常与 ClusterFuzz 的接触点主要是本文接下来要介绍的 Web 界面及其各功能面板。Web 界面ClusterFuzz 为项目开发者提供了一个 Web 界面用于查看 fuzz target 的统计信息以及当前存在的崩溃。访问权限说明该界面的访问权限仅限于被自动 CC 到新 bug 报告中的项目开发者。也就是说只有收到过崩溃报告 CC 的开发者才能登录查看对应项目的完整信息。在界面上你可以按项目查看各 fuzz target 的当前状态与崩溃情况fuzzer 运行速度、覆盖率、内存占用等统计覆盖率报告与性能分析入口。该 Web 界面的入口在 useful_links.md 中也有记载是 OSS-Fuzz 使用者的首要信息入口。测试用例报告Testcase reportsClusterFuzz 会自动对可复现的崩溃进行去重de-duplicate并将结果提交到 OSS-Fuzz 的 bug tracker。每个崩溃报告页面提供以下关键信息堆栈跟踪stack trace崩溃发生时的调用栈帮助定位出错代码位置崩溃测试用例链接触发崩溃的输入文件testcase可直接下载回归范围regression range该 bug 最可能被引入的版本/提交区间。在收到崩溃报告后开发者可以在本地复现。依据本仓库的 复现指南如果已经将 fuzz target 集成到项目的构建和测试系统中复现只需一条命令$ ./fuzz_target_binary testcase_path针对特殊类型的崩溃需要附加参数超时timeout类 bug加-timeout65参数内存耗尽OOM类 bug加-rss_limit_mb2560参数。复现时还需根据报告中Sanitizer列的值选择对应的 sanitizer 构建 fuzz target如缓冲区溢出需要 AddressSanitizer。如果尚未将 fuzz target 集成到项目构建系统也可以使用 Docker 复现 OSS-Fuzz 的精确构建步骤$ python3 infra/helper.py pull_images $ python3 infra/helper.py build_image $PROJECT_NAME $ python3 infra/helper.py build_fuzzers --sanitizer address/memory/undefined $PROJECT_NAME $ python3 infra/helper.py reproduce $PROJECT_NAME fuzz_target_name testcase_path修复提交到上游后ClusterFuzz 会在一天内自动拾取变更、重新检查测试用例并关闭 issue。Fuzzer 统计面板Fuzzer statsClusterFuzz 的 fuzzer statistics dashboard 提供关于 fuzz target 的统计信息包括速度speedfuzz target 每秒执行的测试输入数量反映运行效率覆盖率信息coverage information代码覆盖情况内存使用memory usage运行过程中的内存占用。这些统计指标的价值在于它们是判断 fuzz target 是否健康的量化依据。速度过慢或内存占用过高都会影响 bug 的发现效率这也是后续性能分析模块存在的原因。覆盖率报告Coverage reportsClusterFuzz 提供覆盖率报告以高亮方式展示 fuzz target 实际到达的源代码区域绿色/高亮部分fuzz target 已经覆盖到达的代码红色部分未被覆盖的代码。文档明确建议务必关注标记为红色的未覆盖代码并添加合适的 fuzz target 去覆盖这些用例。从 架构文档 的闭环来看覆盖率报告是持续改进 fuzz target 的关键反馈环节——只有覆盖到更多代码路径ClusterFuzz 才更有可能发现新的 bug。需要注意的是覆盖率能否正确反映源码与运行时依赖的处理方式密切相关。根据 fuzzer_environment.md运行环境bot中并不包含 Dockerfile 或 build.sh 中安装的依赖包因此依赖必须静态链接进 fuzz target且其源码应位于$SRC目录下这样覆盖率报告才能正确定位到这些代码。性能分析器Performance analyzer在 fuzzer statistics dashboard 上点击Performance链接可以查看 fuzz target 正在遇到的性能问题例如泄漏leaks内存泄漏超时timeouts单次执行超时。文档建议修复报告中列出的所有性能问题以保证 fuzz target 高效运行、持续发现新 bug。这与 fuzzer_environment.md 中对运行环境的约束相呼应执行环境仅/tmp可写、其余只读因此 fuzz target 的稳定性与效率直接决定了其能否在长时间运行中持续产出有效结果。崩溃统计Crash statsClusterFuzz 的 crash statistics dashboard 提供随时间变化的崩溃统计帮助开发者了解项目崩溃的分布与趋势。崩溃统计的价值在于宏观视角开发者可以据此判断崩溃是否在修复后回落、某个 fuzz target 是否持续产生新的崩溃以及崩溃类型如 ASan 报告的越界读写、UBSan 报告的未定义行为等的分布情况从而决定下一步的修复与 fuzz target 优化优先级。从报告到关闭ClusterFuzz 的自动化闭环综合 架构文档 与 复现指南可以归纳出 ClusterFuzz 处理一个 bug 的完整闭环发现ClusterFuzz 在持续模糊测试中发现崩溃输入去重与归档自动去重将可复现的崩溃归档为 testcase报告提交到 issue tracker附上堆栈跟踪、testcase 链接与回归范围并 CC 项目开发者复现与修复开发者下载 testcase用本地 fuzz target 或 Docker 复现修复后提交上游commit message 包含Credit to OSS-Fuzz自动验证与关闭ClusterFuzz 自动拾取上游变更、重新运行 testcase 验证修复验证通过后添加评论并关闭 issue在修复验证通过或报告 90 天后以先到者为准issue 转为公开。对项目开发者来说这个闭环意味着保持 fuzz target 高效运行性能分析器、不断扩大代码覆盖覆盖率报告、及时处理崩溃测试用例报告三者配合才能让 ClusterFuzz 持续为你发现真实、可复现、可修复的 bug。如需更多背景可进一步阅读本仓库的 架构文档、术语表、复现指南 与 fuzzer 运行环境说明。【免费下载链接】oss-fuzzOSS-Fuzz - continuous fuzzing for open source software.项目地址: https://gitcode.com/gh_mirrors/os/oss-fuzz创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
