说明：

• Hex-Rays 支持始终被编译进来并在运行时检测。若 Hex-Rays 不可用，基于反编译器的表/函数将不会被注册。
• HTTP REST 支持始终被编译进来；可在 CLI 中使用 --http，或在 REPL/插件 CLI 中使用 .http start。
• IDAPython SQL 执行已编译进来，但默认在运行时禁用。可通过 PRAGMA idasql.enable_idapython = 1; 按会话启用。
• IDASQL_WITH_MCP=ON 会获取 fastmcpp；OFF 则移除 MCP 支持以及 --mcp / .mcp 命令。
• XSQL_WITH_THINCLIENT 被强制为 ON，HTTPLIB_USE_OPENSSL_IF_AVAILABLE 被强制为 OFF，因为 IDASQL 使用本地明文 HTTP。

可用表

30+ 个虚拟表，涵盖函数、字符串、类型、交叉引用、反汇编、反编译等。

核心

字符串与字节

反编译器

类型

标注

搜索

数据库信息

存储

分析

SQL 函数

统一实体搜索

使用 grep 表对命名函数、标签、段、类型和成员进行可组合的 SQL 搜索。```sql -- Search anything starting with "Create" SELECT name, kind, printf('0x%X', addr) as addr FROM grep WHERE pattern = 'Create%' LIMIT 20;

-- Search anywhere in name (plain text performs a contains search) SELECT name, kind, full_name FROM grep WHERE pattern = 'File' AND kind IN ('function', 'import') LIMIT 20;

-- Find struct members SELECT name, parent_name, full_name FROM grep WHERE pattern = 'dw%' AND kind = 'member';

-- Pagination SELECT name, kind, full_name FROM grep WHERE pattern = 'Create%' ORDER BY kind, name LIMIT 20 OFFSET 20;

输入内容为空，没有可翻译的文本。请提供 chunk 33 的实际 Markdown 内容。```bash curl http://localhost:8080/status curl -X POST http://localhost:8080/query -d "SELECT name FROM funcs LIMIT 5" curl -X POST http://localhost:8080/query -d "SELECT * FROM binary; SELECT COUNT(*) FROM funcs;"

默认情况下是快速失败（fail-fast）；传入 continue_on_error=true（例如 ?continue_on_error=1）即可忽略之前的失败，运行每一条语句。results[i].error 是每条语句失败的权威信息；first_error_index 指向最早失败的索引，若没有失败则为 null。当切分器失败时（例如未闭合的引号），响应为 success:false、statement_count:0、results:[]，并附带顶层 parse_error。

对于多个数据库，请分别运行独立的实例：```bash idasql -s malware.i64 --http 8080 idasql -s kernel.i64 --http 8082

在 IDA 插件中（非阻塞）：``` idasql> .http start HTTP server started on port 8142 idasql> .http stop HTTP server stopped

固定后，重新打开数据库会自动启动服务器——你会在加载时于 IDA 输出窗口中看到此信息：``` IDASQL v0.0.18: Query engine initialized IDASQL CLI: Installed IDASQL: autostart -> IDASQL HTTP server: http://127.0.0.1:8099 Type '.http stop' to stop the server.

• 加载时自动启动仅在 IDA 插件中生效。 .pin 命令本身 在 CLI 和插件中均可用（CLI 仅读取/写入 pin）。
• .http start / .mcp start 在未显式指定端口时复用已固定的主机/端口。
• 从 CLI 中，.pin 更改仅在以 -w/--write 启动时持久保存 （与任何其他 IDB 编辑一样）。

MCP 服务器

对于支持 MCP 的客户端（Model Context Protocol，一种 AI 工具集成标准）：

--mcp 和 .mcp 在使用 -DIDASQL_WITH_MCP=ON 构建时可用，该选项默认开启。使用 -DIDASQL_WITH_MCP=OFF 构建可省略 MCP 支持。```bash

Standalone mode

idasql -s database.i64 --mcp idasql -s database.i64 --mcp 9500 # specific port

Or in interactive mode

idasql -s database.i64 -i .mcp start

工具：idasql_query（直接 SQL 查询或分号分隔的脚本）

xsql 工具家族

IDASQL 是一个工具家族的一员，该家族通过相同的 SQL 接口暴露不同的二进制分析和调试信息平台，所有工具都构建在共享的 libxsql 虚拟表框架之上。你在一个工具上学会的查询在很大程度上可以沿用到其他工具——例如，相同的 SELECT name, size FROM funcs ORDER BY size DESC LIMIT 10 在任何地方都能运行。

逆向工程平台

• bnsql — 将 Binary Ninja 数据库以 SQL 形式呈现。
• ghidrasql — 将 Ghidra 数据库以 SQL 形式呈现。

调试信息与编译器数据

• pdbsql — 将 Windows PDB 符号文件以 SQL 形式呈现。
• dwarfsql — 将 DWARF 调试信息以 SQL 形式呈现。
• clangsql — 将 Clang AST 以 SQL 形式呈现。

核心

• libxsql — 上述所有工具所基于的 C++ SQLite 虚拟表框架。

构建工具

• libxsql - 仅头文件的 C++17 库，用于将 C++ 数据结构暴露为 SQLite 虚拟表。提供用于定义表的流畅构建器 API、约束下推以及 HTTP 瘦客户端支持。

• fastmcpp - 可选的 MCP 服务器实现，在使用 -DIDASQL_WITH_MCP=ON 构建时使用。

许可证与使用条款

简而言之：只要你保留声明并遵守许可证条款，你就可以阅读、构建、评估、基准测试、打包和使用未经修改的 idasql，包括商业用途。你可以在许可证的贡献用途规则范围内分叉或修补它，以准备错误修复、优化、功能、测试或文档改进，以便回馈上游。

未经 Elias Bachaalany 事先书面许可，你不得维护偏离原版的私有分支、移植、重新命名、克隆、API 兼容替代品、竞争性实现，或将 idasql 用作 AI 输入来重建或改进衍生实现。在许可证定义的范围内，并非从 idasql 复制、实质性衍生或大量借鉴的独立实现不受禁止。

许可请求：请在 allthingsida/idasql/issues 打开 GitHub issue。

如果 idasql 对某个分发的项目有实质性影响，请保留人类来源：在 README/文档中以及适用时的“关于/致谢”UI 中显著标注 idasql 和 Elias Bachaalany。许可证包含一个示例/FAQ 部分，介绍常见的允许用途和需要许可的用途。第三方依赖（libxsql、IDA SDK 及其传递依赖）仍受其各自许可证的约束。

请参阅完整的 Human-Origin Source License v1.0。