BAM 的安装和配置教程

项目基础介绍

BAM（Binary Analysis Metadata）是一款用于收集和分析和Windows更新、二进制文件及符号的开源工具。该工具的目标是提供一个能够扫描Windows更新、存储更新信息、获取二进制文件的符号以及分析这些信息的平台。BAM设计上注重可移植性、效率及与未来Python版本的兼容性，使用SQLite数据库来快速检索补丁和符号信息。

项目主要编程语言

BAM主要使用Python 3.7+版本编写，同时包含了少量的C语言和PowerShell脚本。

项目使用的关键技术和框架

• pefile：用于分析PE（Portable Executable）文件格式的库。
• SQLite3：轻量级的数据库引擎，用于存储和管理数据。
• 7zip：用于解压缩Windows更新文件。
• Windows Debugging Tools：用于获取和验证符号文件。

准备工作

在开始安装BAM之前，请确保您的系统满足以下要求：

• 操作系统：Windows（推荐Windows Server Update Services环境）。
• 硬件：至少32GB内存，10TB磁盘空间用于存储解压缩的内容和下载的符号，5TB磁盘空间用于WSUS下载更新。
• 软件依赖：
  • Python 3.7+ 64位
  • pefile库
  • pyodbc（可选）
  • SQLite3
  • 7zip
  • Windows Debugging Tools（包含在Windows SDK中）
  • WSUS服务

安装步骤

1. 安装Python 3.7+：从Python官方网站下载并安装。
2. 安装依赖库：打开命令提示符，使用pip安装必要的Python库。

   pip install pefile pyodbc
   

3. 配置环境变量：将Microsoft Debugging Tools的路径添加到系统环境变量PATH中。
4. 安装7zip：从7zip官方网站下载并安装。
5. 设置Symbol Connection和Download EULA：确保symsrv.yes文件位于\Windows\System32\目录下，以自动接受EULA。
6. 启用Win32长路径策略：在“管理员模板 > 系统 > 文件系统”下启用“启用Win32长路径”策略。
7. 下载和解压BAM：使用Git克隆项目到本地。

   git clone https://github.com/nsacyber/BAM.git
   

8. 运行BAM：在命令提示符中，导航到BAM目录并执行以下命令来初始化数据库和进行基本的配置。

   python main.py -c -p "<路径到更新文件>" -pd "<路径到解压文件>"
   

   根据需要替换<路径到更新文件>和<路径到解压文件>。

完成以上步骤后，您应该可以成功运行BAM并开始分析和收集Windows更新的元数据。