Macrome 开源项目安装与使用手册

Macrome 开源项目安装与使用手册

Macrome Excel Macro Document Reader/Writer for Red Teamers & Analysts 项目地址: https://gitcode.com/gh_mirrors/ma/Macrome

1. 项目目录结构及介绍

Macrome 是一个专为红队成员和分析师设计的用于读写Excel宏文档的工具。下面简要介绍其主要目录结构：

• App: 包含应用级别的配置。
• BiffRecordExtensions, CommandLineExtensions, ExcelDocWriter, FormulaHelper, MacroPatterns, Properties, RecordHelper, StringExtensions, UnicodeHelper, VBA: 这些是处理Excel宏文档的核心功能模块，每个类文件对应特定的操作或转换逻辑。
• bin: 编译后存放可执行文件的目录，分为调试(debug)和发布(release)版本。
• config: 存放配置相关文件，比如可能包括应用程序运行所需的环境设置。
• Docs: 示例文档和说明文档所在目录，比如解混淆文档和宏示例。
• Emulation, Encryption: 用于模拟和加密操作的模块。
• Packages: 可能包含了项目的依赖包管理配置。
• PayloadType, UnitTests: 分别定义有效负载类型和单元测试代码。
• Macrome.csproj, Macrome.sln: 分别是项目文件和解决方案文件，用于Visual Studio等IDE编译和管理项目。

2. 项目的启动文件介绍

核心启动逻辑不直接体现在单一的“启动文件”中，而是通过命令行接口实现。用户可以通过命令行工具dotnet run或直接调用编译后的.dll文件来操作Macrome。例如，使用以下命令构建一个带有宏的Excel文档：

dotnet run -- build --decoy-document <路径/至/诱饵文档.xls> --payload <路径/至/有效载荷.bin>

或者在项目编译后：

dotnet Macrome.dll build --decoy-document <路径/至/诱饵文档.xls> --payload <路径/至/有效载荷.bin>

其中build是操作模式之一，表示构建一个新的Excel文档，并嵌入宏。

3. 项目的配置文件介绍

Macrome并未明确指出有一个单独的传统配置文件（如appsettings.json或其他形式的配置文件），配置主要通过命令行参数进行。尽管如此，存在App.config这样的文件用于应用程序级的基本配置。此外，在实际部署和自定义过程中，用户可能会利用环境变量或命令行参数来定制化工具的行为。例如，项目运行时的具体行为调整、安全设置、或指定输出文件名等，都是通过命令行选项完成的。

为了更详细的配置场景，开发者可能需要查阅项目源码或执行带有帮助选项的命令来获取当前版本支持的所有配置项，例如使用dotnet Macrome.dll build -h查看构建模式的帮助信息。

总结，Macrome通过简洁的命令行界面提供了高度灵活性，而具体的配置和初始化逻辑分散在其执行命令之中，而非传统的配置文件中。在实际使用前，深入阅读官方文档和示例以充分利用该项目的各项功能是非常重要的。

Macrome Excel Macro Document Reader/Writer for Red Teamers & Analysts 项目地址: https://gitcode.com/gh_mirrors/ma/Macrome