# oletools Office 文档与 OLE 文件分析工具集

> Philippe Lagadec 开发的 Python 工具包，用于分析 Microsoft OLE2（复合文件二进制格式）文件，如 Office 97–2003 文档、MSI 文件和 Outlook 邮件，也支持 RTF 与 OpenXML 文档，主要面向恶意软件分析、取证和调试。其命令行工具可检测并提取 VBA 与 Excel 4（XLM）宏、嵌入的 OLE 和 Flash 对象以及 DDE 链接（olevba、MacroRaptor、oleobj、rtfobj、pyxswf、msodde），用 oleid 和 ftguess 标记恶意文件中常见的特征，并通过 oledir、olemeta、oletimes 和 olemap 查看目录项、元数据、时间戳和扇区布局。它基于同一作者的 olefile 解析器。

- 类型：工具
- 目标：二进制
- 类别：原生分析工具
- 关联：基础工具
- 来源复核于：2026-10-20
- 收录于：2026-11-02
- 原始资源：<https://github.com/decalage2/oletools>
- 一手来源：<https://github.com/decalage2/oletools/blob/ec10260989dbc48b9109e3d05d22beee19cf2333/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/oletools/>
- 记录 JSON：<https://awesomerea.org/resources/oletools/record.json>
- 英文版：[English](https://awesomerea.org/resources/oletools/index.md)

## 使用条件与局限

- 审阅时最新版本为 v0.60.2，于 2024-07-02 在 GitHub 和 PyPI 发布。所审阅的 master 提交（2026-01-26）已将版本设为 0.60.3，README 的更新记录也在 2025-05-22 下列出 0.60.3，其中包括修复 olevba 命令行输出中 ANSI 转义码导致的安全问题；但审阅时并不存在 0.60.3 标签或 PyPI 上传。SECURITY.md 将 0.60.x 及之后版本列为受支持版本。
- 通过 pip 安装 oletools，或安装 oletools[full] 以加入可选的 XLMMacroDeobfuscator。依赖 pyparsing、olefile、easygui、colorclass 和 pcodedmp，并依赖 msoffcrypto-tool 处理加密文档（在 Windows、macOS 或 Python 2 上使用 PyPy 时除外）。setup.py 的分类标签列出 Python 2.7 及 3.4 至 3.12；GitHub 工作流在 Linux、Windows 和 macOS 上用当前 CPython 3 与 PyPy 3.9 运行 pylint -E 和单元测试，较旧的 Travis 配置则针对 Python 2.7 至 3.8 及 PyPy。
- 输入为使用者提供的文档，在恶意软件分析中可能是恶意文件；单元测试使用 tests/test-data 下提交的示例文档。README 称 oleid 用于检测恶意文件中常见的特征、MacroRaptor 用于检测恶意 VBA 宏，因此结果只是需要分析者复核的迹象。
- LICENSE.md 对该工具包采用两条款 BSD 许可证（版权 2012–2025 Philippe Lagadec）；olevba 包含来自 officeparser 的 MIT 许可代码，thirdparty 目录保留各自条款，其中 xxxswf 为 GPL-3.0，oledump 插件代码为公有领域。README 说明 python-oletools 与 BeCubed Software 的 OLETools 无关。

## 一手来源

1. <https://github.com/decalage2/oletools/blob/ec10260989dbc48b9109e3d05d22beee19cf2333/README.md>
2. <https://github.com/decalage2/oletools/blob/ec10260989dbc48b9109e3d05d22beee19cf2333/setup.py>
3. <https://github.com/decalage2/oletools/blob/ec10260989dbc48b9109e3d05d22beee19cf2333/requirements.txt>
4. <https://github.com/decalage2/oletools/blob/ec10260989dbc48b9109e3d05d22beee19cf2333/SECURITY.md>
5. <https://github.com/decalage2/oletools/blob/ec10260989dbc48b9109e3d05d22beee19cf2333/.github/workflows/unittests.yml>
6. <https://github.com/decalage2/oletools/blob/ec10260989dbc48b9109e3d05d22beee19cf2333/.travis.yml>
7. <https://github.com/decalage2/oletools/tree/ec10260989dbc48b9109e3d05d22beee19cf2333/tests/test-data>
8. <https://github.com/decalage2/oletools/blob/ec10260989dbc48b9109e3d05d22beee19cf2333/LICENSE.md>
9. <https://github.com/decalage2/oletools/blob/ec10260989dbc48b9109e3d05d22beee19cf2333/oletools/thirdparty/xxxswf/LICENSE.txt>
10. <https://github.com/decalage2/oletools/releases/tag/v0.60.2>
11. <https://pypi.org/project/oletools/0.60.2/>

## 同分区更多条目：原生二进制

- [MonkeyDev iOS 应用插桩开发工具包](https://awesomerea.org/zh/resources/monkeydev/index.md) · 工具
- [Hollows Hunter 进程内存植入扫描器](https://awesomerea.org/zh/resources/hollows-hunter/index.md) · 工具
- [restore-symbol iOS 符号表恢复工具](https://awesomerea.org/zh/resources/restore-symbol/index.md) · 工具
- [FakeNet-NG 动态网络分析工具](https://awesomerea.org/zh/resources/fakenet-ng/index.md) · 工具
- [Joern 代码属性图分析平台](https://awesomerea.org/zh/resources/joern/index.md) · 工具
- [Speakeasy Windows 恶意软件仿真框架](https://awesomerea.org/zh/resources/speakeasy/index.md) · 工具

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。