
新发布Aug 13, 2026
speakeasy v2.0.0b6
Windows恶意软件仿真框架,可在建模运行时环境中执行二进制文件、驱动程序和Shellcode,模拟API、进程/线程行为、文件系统、注册表和网络活动,生成结构化JSON报告。
Speakeasy
Speakeasy 是一个 Windows 恶意软件模拟框架,它在建模的 Windows 运行时中执行二进制文件、驱动程序和 shellcode,而不是在完整的虚拟机中运行。它模拟样本所使用的 Windows API、进程、线程、文件系统、注册表和网络,因此样本能比在裸 CPU 模拟器中运行得更深入。speakeasy CLI 将报告以 JSON 格式写出,用于分类分析,Python 库则将同一份报告返回给你的代码。
有关背景信息,请参阅 Mandiant 的 Speakeasy 简介。
快速开始
从 PyPI 安装:
python3 -m pip install speakeasy-emulator
模拟一个样本并打印报告中的部分字段。将 sample.dll 替换为你的文件:
speakeasy -t sample.dll --no-mp -o report.json 2>/dev/null
jq '{sha256, arch, file_type, runs: (.runs | length)}' report.json
这些值取决于样本:
{
"sha256": "…",
"arch": "x86",
"file_type": "dll",
"runs": 3
}
默认情况下,Speakeasy 会开启所有功能:它会运行导出函数和子进程,报告中包含覆盖率、内存访问计数以及最终内存内容。每个功能都有一个 --no- 标志用于关闭它,例如 --no-code-coverage。开启较少功能的运行速度更快,生成的报告也更小。CLI 参考列出了所有标志。
文档
请从安装、Python 库用法和 CLI 参考开始阅读。文档索引列出了所有页面。
如需帮助,请参阅 doc/help.md,或在 github.com/mandiant/speakeasy/issues 提交 issue。