1. 产品
  2.   电子邮件
  3.   C++
  4.   libpff

libpff

 
 

用于 Outlook 文件格式的开源 C 库

通过免费开源 C API 读取、解析并提取 PST、OST、PAB 和 OFF 文件中的数据。

什么是 libpff?

libpff 是一个强大的开源 C 库,旨在访问 Microsoft Outlook 使用的个人文件夹文件 (PFF) 和离线文件夹文件 (OFF) 格式。它使开发者能够以编程方式读取、解析并提取存储在 PST、OST、PAB 和 OFF 文件中的电子邮件、联系人、日历项以及其他数据。该库支持 32 位 ANSI 和 64 位 Unicode 字符串编码,以及如 Outlook 2013 引入的 4K 页面 DEFLATE 压缩的 OST 文件等压缩格式。凭借其强大的解析引擎,libpff 在数字取证、电子邮件迁移和数据恢复工作流中尤为有价值。

该库在 LGPL-3.0-or-later 许可证下积极维护,当前处于 alpha 状态,这意味着它可用但可能缺乏完整的功能或生产环境的稳定性。它包括项目恢复工具,能够处理已损坏或加密(加密类型为 none)的文件。libpff 还与诸如 libfmapi 等相关项目集成,以获取 MAPI 定义,并提供详细的取证文档,帮助分析复杂的 Outlook 文件结构。开发者可以从源码构建或使用预编译的二进制文件,项目托管在 GitHub 上,供社区贡献和问题跟踪。

Previous Next

libpff 入门指南

要开始使用 libpff,您可以从其官方 [libpff GitHub](https://github.com/libyal/libpff) 仓库克隆源代码,并使用 CMake 或 autotools 构建。官方未提供预编译的二进制文件,因此推荐从源码构建。项目包含详细的构建说明和诸如 libyal/libcerror、libyal/libcdata 等依赖项。构建完成后,您可以使用提供的命令行工具(例如 `pffexport`、`pffinfo`)来检查和提取 PST/OST 文件中的数据。对于编程使用,您可以在 C/C++ 应用程序中链接已编译的库。该库轻量且外部依赖最少,适用于嵌入式或取证环境。

通过源码构建安装 libpff

git clone https://github.com/libyal/libpff.git
cd libpff
./configure
make
sudo make install

从 PST 文件中提取电子邮件和附件

libpff 提供强大的功能来解析 PST 文件并提取单个电子邮件消息及其附件。开发者可以遍历文件夹层次结构,访问消息属性(例如,主题、发件人、收件人、时间戳),并导出原始 MIME 内容或结构化数据。该库支持 ANSI 和 Unicode 字符串编码,确保兼容从 1990 年代到现代版本的 Outlook。它还处理压缩的 OST 文件(4K 页面 DEFLATE),这些文件在较新的 Outlook 版本中很常见。这使得 libpff 成为电子邮件迁移工具、电子取证平台和法医分析的理想选择,因为在这些场景中准确提取邮件正文和附件至关重要。API 公开对 MAPI 属性的低层访问,允许对数据检索进行细粒度控制。

如何通过 C API 从 PST 文件中提取电子邮件?

pff_file_t *pff_file = NULL;
pff_error_t *error = NULL;

if (pff_file_open(&pff_file, "example.pst", PFF_OPEN_READ, &error) != 1) {
    // handle error
}

pff_item_t *root_item = NULL;
if (pff_file_get_root_item(pff_file, &root_item, &error) != 1) {
    // handle error
}

// Iterate over items and extract messages
pff_item_t *item = NULL;
while (pff_item_get_sub_item(root_item, &item, &error) == 1) {
    // Process each item (e.g., folder or message)
    pff_item_free(&item, NULL);
}
pff_item_free(&root_item, NULL);
pff_file_close(pff_file, &error);

损坏的 Outlook 文件的取证分析

libpff 包含针对受损或部分损坏的 Outlook 文件进行取证分析的专门功能。它可以解析缺少或不一致标题的文件,恢复孤立项目,并在内部索引损坏时重建消息树。该库支持加密类型为 "none" 的文件,并且可以绕过某些结构错误以提取可用数据。这在数字取证调查中尤为有价值,因为证据可能存在于退化的 PST/OST 文件中。libpff 还提供详细的日志记录和错误报告,使分析人员能够跟踪解析决策并识别数据丢失点。结合其 MAPI 属性提取,libpff 成为构建符合合法性和合规性标准的取证工具的可靠基础。

如何从损坏的 PST 文件中恢复项目?

pff_file_t *pff_file = NULL;
pff_error_t *error = NULL;

// Open with recovery mode (if supported)
if (pff_file_open_recover(&pff_file, "corrupted.pst", PFF_OPEN_READ, &error) != 1) {
    // fallback to standard open
    pff_file_open(&pff_file, "corrupted.pst", PFF_OPEN_READ, &error);
}

// Use item recovery functions
pff_item_t *recovered_item = NULL;
if (pff_file_get_recovered_item(pff_file, &recovered_item, &error) == 1) {
    // Process recovered item
    pff_item_free(&recovered_item, NULL);
}
pff_file_close(pff_file, &error);

解析 MAPI 属性和元数据

libpff 使能够深入检查嵌入在 Outlook 项目中的 MAPI 属性。开发者可以检索标准属性,如 `PR_SUBJECT`、`PR_SENDER_NAME`、`PR_MESSAGE_DELIVERY_TIME`,以及应用程序定义的自定义属性。该库提供属性集 API,允许遍历消息、文件夹或附件的所有属性。这对于需要合规审计、元数据提取或与基于 MAPI 的系统集成的应用程序至关重要。libpff 支持命名和数字属性标识符,并处理 32 位和 64 位的值类型(例如,字符串、整数、二进制块)。它与 libfmapi 的紧密集成确保对 MAPI 定义的准确解释,使其适合构建高级 Outlook 数据分析工具。

如何从邮件项目中提取 MAPI 属性?

pff_item_t *message_item = NULL;
pff_property_t *property = NULL;
pff_error_t *error = NULL;

// Assume message_item is obtained from traversal
while (pff_item_get_property(message_item, &property, &error) == 1) {
    uint32_t property_tag = 0;
    uint32_t property_type = 0;
    const uint8_t *value_data = NULL;
    size_t value_data_size = 0;

    pff_property_get_tag(property, &property_tag, &error);
    pff_property_get_type(property, &property_type, &error);
    pff_property_get_value_data(property, &value_data, &value_data_size, &error);

    // Process property (e.g., print subject if PR_SUBJECT)
    if (property_tag == 0x0037001F) { // PR_SUBJECT (Unicode)
        printf("Subject: %ls\n", (wchar_t*)value_data);
    }
    pff_property_free(&property, NULL);
}

将数据导出为标准格式(CSV、JSON、XML)

虽然 libpff 主要是一个用于低层解析的 C 库,但它包含命令行实用程序和 API,能够方便地将 Outlook 数据导出为广泛使用的格式,如 CSV、JSON 和 XML。诸如 `pffexport` 的工具可以将 PST/OST 内容转换为结构化文本文件,保留文件夹层次结构和消息元数据。开发者还可以以编程方式使用该库构建自定义导出器——例如,将 MAPI 属性映射为 JSON 对象,以供搜索引擎或分析平台摄取。此导出功能对于数据迁移、备份以及与需要标准化输入格式的现代云服务的集成至关重要。libpff 灵活的设计使开发者能够根据特定的合规性或工作流需求定制导出逻辑。

如何通过 CLI 将 PST 内容导出为 JSON?

# Export all messages to JSON with metadata
pffexport -f json -o output_dir/ example.pst

# Export only messages with attachments
pffexport -f json -a example.pst

# View help for export options
pffexport --help
 中国人