query-pdb 项目下载及安装教程

1. 项目介绍

query-pdb 是一个服务器端软件，用于解析 PDB 文件。PDB 文件是 Windows 平台上可执行程序的调试符号文件，记录了可执行程序的调试信息，包括结构、联合和枚举等。该软件提供 PDB 在线解析服务，客户端只需向服务器发送请求即可获取所需的结构和枚举，无需下载完整的 PDB 文件。

2. 项目下载位置

要下载 query-pdb 项目，请访问项目的 GitHub 仓库。您可以通过以下步骤进行下载：

1. 打开浏览器，访问 https://github.com/zouxianyu/query-pdb.git。
2. 在页面右上角找到并点击绿色的“Code”按钮。
3. 选择“Download ZIP”选项，下载项目的 ZIP 压缩包。
4. 解压下载的 ZIP 文件到您选择的目录。

3. 项目安装环境配置

在安装 query-pdb 项目之前，您需要确保系统满足以下环境配置要求：

• 操作系统：Windows 或 Linux
• 编译器：MSVC（Windows）或 gcc（Linux）
• 构建工具：CMake >= 3.20
• 依赖库：OpenSSL >= 1.1.1

环境配置示例

Windows 环境配置

1. 安装 Visual Studio：

   • 下载并安装 Visual Studio 2019 或更高版本。
   • 确保安装了 C++ 开发工具。

2. 安装 CMake：

   • 下载并安装 CMake 3.20 或更高版本。
   • 将 CMake 添加到系统环境变量 PATH 中。

3. 安装 OpenSSL：

   • 下载并安装 OpenSSL 1.1.1 或更高版本。
   • 将 OpenSSL 的 bin 目录添加到系统环境变量 PATH 中。

Linux 环境配置

1. 安装 gcc：

   • 使用包管理器安装 gcc。例如，在 Ubuntu 上运行：

     sudo apt-get install build-essential
     

2. 安装 CMake：

   • 使用包管理器安装 CMake。例如，在 Ubuntu 上运行：

     sudo apt-get install cmake
     

3. 安装 OpenSSL：

   • 使用包管理器安装 OpenSSL。例如，在 Ubuntu 上运行：

     sudo apt-get install libssl-dev
     

4. 项目安装方式

Windows 安装步骤

1. 打开命令提示符：

   • 按 Win + R，输入 cmd，然后按回车。

2. 导航到项目目录：

   • 使用 cd 命令导航到解压后的项目目录。例如：

     cd C:\path\to\query-pdb
     

3. 生成构建文件：

   • 运行以下命令生成构建文件：

     cmake -B build -DCMAKE_BUILD_TYPE=Release
     

4. 编译项目：

   • 运行以下命令编译项目：

     cmake --build build --target query_pdb_server --config Release
     

Linux 安装步骤

1. 打开终端：

   • 按 Ctrl + Alt + T 打开终端。

2. 导航到项目目录：

   • 使用 cd 命令导航到解压后的项目目录。例如：

     cd /path/to/query-pdb
     

3. 生成构建文件：

   • 运行以下命令生成构建文件：

     cmake -B build -DCMAKE_BUILD_TYPE=Release
     

4. 编译项目：

   • 运行以下命令编译项目：

     cmake --build build --target query_pdb_server --config Release
     

5. 项目处理脚本

在项目安装完成后，您可以使用以下命令启动 query-pdb 服务器：

./build/query_pdb_server --ip 0.0.0.0 --port 8080 --path save --server http://msdl.microsoft.com/download/symbols/ --log 1

该命令将启动服务器，并监听 8080 端口。您可以通过发送 POST 请求到 http://localhost:8080/symbol 或 http://localhost:8080/struct 来测试服务器的功能。

示例请求

以下是一个示例 POST 请求，用于获取符号信息：

{
  "name": "ntkrnlmp.pdb",
  "guid": "8F0F3D677778391600F4EB2301FFC7A5",
  "age": 1,
  "query": ["KdpStub", "MmAccessFault", "xxxxxx"]
}

服务器将返回类似以下的结果：

{
  "KdpStub": 3773768,
  "MmAccessFault": 2454256,
  "xxxxxx": -1
}

通过以上步骤，您可以成功下载、安装并运行 query-pdb 项目。