Skip to content
KitploitKITPLOIT
工具漏洞利用博客
Log in
提交
工具漏洞利用博客
提交

黑客、渗透测试和网络安全工具,武装您的安全武器库!

Kitploit 是一个黑客、网络安全和渗透测试工具的目录。发现最新的项目更新,查找漏洞、分析系统、自动化测试并加强你的安全。

订阅源联系隐私© 2026 Kitploit

工具目录

分类

查看所有分类
Loading categories
pbtk — 用于逆向工程和模糊测试基于Protobuf的应用程序的工具集 | Kitploit
工具/GitHubGitHub/marin-m/pbtk
Android安全动态分析 (沙盒)Payload生成逆向工程Web安全模糊测试移动安全二进制分析
GitHubmarin-m/pbtk

pbtk

用于逆向工程和模糊测试基于Protobuf的应用程序的工具集

查看仓库
1.7k200812天前Kitploit 审核通过
分享
网站

pbtk - 逆向工程 Protobuf 应用

Protobuf 是一种序列化格式,由 Google 开发,并被越来越多的 Android、Web、桌面及其他应用程序所使用。它包含一种用于声明数据结构的语言,随后会根据目标实现将其编译为代码或其他类型的结构。

pbtk(Protobuf toolkit)是一套功能完备的脚本集合,可通过统一的 GUI 访问,提供两大主要功能:

  • 从程序中提取 Protobuf 结构,将其转换回可读的 .proto 文件,支持多种实现:

    • 所有主要的 Java 运行时(base、Lite、Nano、Micro、J2ME),并完全支持 Proguard,(2026:这仍然运行良好,但主要适用于旧版 APK)
    • 包含内嵌反射元数据的二进制文件(通常是 C++,有时是 Java 及大多数其他绑定),(2026:这仍然运行良好)
    • 使用 JsProtoUrl 运行时的 Web 应用程序。(2026:这需要更新)
  • 编辑、重放和模糊测试发送到 Protobuf 网络端点的数据,通过便捷的图形界面,你可以实时编辑 Protobuf 消息的字段并查看结果。

pbtk 编辑器 GUI

安装

PBTK 需要 Python ≥ 3.10、GTK 4、Adwaita ≥ 1.8、Python-Protobuf 3,以及若干可执行程序(chromium、jad、dex2jar……)来运行提取脚本。

Ubuntu 用户可以使用 snap 安装:

$ sudo snap install pbtk
$ pbtk

Archlinux 用户可以通过 软件包 直接安装:

$ yay -S pbtk-git
$ pbtk

在大多数其他发行版上,你会希望直接运行它:

# For Ubuntu/Debian derivates:
sudo apt install python3-pip git openjdk-8-jre gir1.2-adw-1 \
    blueprint-compiler gir1.2-gtk-4.0 gir1.2-soup-3.0 python3-gobject

# Then, using UV:
sudo snap install --classic astral-uv
uv tool install pbtk
pbtk

# Or using pipx:
sudo apt install pipx
pipx install pbtk
pbtk

Windows 也受支持。pbtk 2.x 基于 GTK 4 运行,但 pbtk 1.x(最后一个版本为 1.1.5)基于 Qt 5 运行。

运行 GUI 后,它会根据你尝试执行的操作提示你缺少哪些组件。

命令行用法(通过包管理器安装)

可通过主脚本启动 GUI:

pbtk

以下脚本也可独立使用,无需 GUI:

pbtk-jar-extract [-h] input_file [output_dir]
pbtk-from-binary [-h] input_file [output_dir]
pbtk-web-extract [-h] input_url [output_dir] # 截至 2026 年需要更新才能正常工作

通过 snap 安装时,具体命令有所不同:

pbtk.jar-extract [-h] input_file [output_dir]
pbtk.from-binary [-h] input_file [output_dir]
pbtk.web-extract [-h] input_url [output_dir]

命令行用法(本地)

可通过主脚本启动 GUI:

uv sync # Download dependencies to the .venv folder
source .venv/bin/activate # Put the local scripts in $PATH for the current shell session
uv tool install -e . # Put the local scripts in $PATH all time
cp -a .github/hooks/* .git/hooks/ # Needed for contributing to code
pbtk

以下脚本也可以独立使用,无需 GUI:

pbtk-jar-extract [-h] input_file [output_dir]
pbtk-from-binary [-h] input_file [output_dir]
pbtk-web-extract [-h] input_url [output_dir] # 截至 2026 年需要更新才能正常工作

典型工作流程

假设你正在逆向分析一个 Android 应用。你用自己最喜欢的反编译器对应用进行了一番探索,发现它以典型的方式通过 HTTPS 将 Protobuf 作为 POST 数据传输。

你打开 PBTK,会看到一段有意义的欢迎信息:

欢迎界面

第一步是将你的 .proto 文件转换为文本格式。如果你的目标是 Android 应用,拖入一个 APK 并等待,就能完成这项神奇的工作!(除非它是非常特殊的实现)

完成界面

完成之后,你跳转到 ~/.pbtk/protos/<你的 APK 名称>(可以通过命令行,也可以点击欢迎界面底部的按钮打开文件浏览器,随你喜好)。应用的所有 .proto 文件确实都在这里。

回到反编译器,你偶然发现了那个构造发送到你感兴趣的 HTTPS 端点的数据的类。它通过调用一个由生成代码组成的类来序列化 Protobuf 消息。

你的反编译器

后一个类应该在你的 .proto 目录中有完全匹配的对应项(即 com.foo.bar.a.b 会匹配 com/foo/bar/a/b.proto)。无论如何,用 grep 搜索它的名称应该能让你找到它。

很好:接下来就是 第 2 步,选择你想要的输入 .proto,并填写一些关于你端点的信息。

端点创建表单

你还可以提供一些发送到该端点的原始 Protobuf 示例数据,这些数据通过 mitmproxy 或 Wireshark 捕获,并以十六进制编码形式粘贴。

第 3 步 就是点击按钮并观察发生什么的乐趣所在!你会看到一个树形视图,表示 Protobuf 结构中的每个字段(重复字段后缀为“+”,必填字段没有复选框)。

端点创建表单

只需将鼠标悬停在字段上即可聚焦。如果字段是整数类型,使用鼠标滚轮来递增/递减它。悬停时还会显示枚举信息。

就是这样!你可以借此确定每个字段的含义。如果你从压缩混淆的代码中提取了 .proto,你可以根据你注意到的含义,通过点击字段名称来重命名字段。

祝你逆向愉快!👌 🎉

本地数据存储

PBTK 将提取的 .proto 信息存储到 ~/.pbtk/protos/(Windows 上为 %APPDATA%\pbtk\protos)。

你可以直接通过常规的文件浏览器和文本编辑器移入、移出、重命名、编辑或删除此目录中的数据,这是预期的方式,不会干扰 PBTK。

基于 HTTP 的端点以 JSON 对象的形式存储在 ~/.pbtk/endpoints/ 中。这些对象是请求/响应信息对的数组,如下所示:

[{
    "request": {
        "transport": "pburl",
        "proto": "www.google.com/VectorTown.proto",
        "url": "https://www.google.com/VectorTown",
        "pb_param": "pb",
        "samples": [{
            "pb": "!....",
            "hl": "fr"
        }]
    },
    "response": {
        "format": "other"
    }
}]

源代码结构

PBTK 内部使用两种可插拔模块:提取器和传输器。

  • 提取器(extractor)支持从目标 Protobuf 实现或平台中提取 .proto 结构。

提取器定义在 src/pbtk/extractors/*.py 中。它们被定义为一个由装饰器修饰的方法,如下所示:

@register_extractor(
    name='my_extractor',
    readable_name='My Extractor',
    description='Extract Protobuf structures from Foobar code (*.foo, *.bar)',
    depends={'binaries': ['foobar-decompiler']},
)
def my_extractor(path):
    # Load contents of the `path` input file and do your stuff...

    # Then, yield extracted .protos using a generator:
    for i in do_your_extraction_work():
        yield ExtractorOutputFile(proto_name + '.proto', proto_contents)

    # Other kinds of information can be yield, such as endpoint information or progress to display.
  • 传输层(transport) 支持一种通过网络对 Protobuf 数据进行反序列化、重新序列化和发送的方式。例如,最常用的传输层是通过 HTTP 发送的原始 POST 数据。

传输层定义在 src/pbtk/utils/transports.py 中。它们被定义为一个由装饰器修饰的类,如下所示:

@register_transport
class MyTransport(Transport):
    name = 'my_transport'
    description = 'Protobuf as raw POST data'
    ui_data_form = 'hex strings'

    def __init__(self, pb_param: None, url: str):
        self.url = url

    def serialize_sample(self, sample: str) -> str:
        # We got a sample of input data from the user.
        # Verify that it is valid in the form described through "ui_data_form" parameter, fail with an exception or return False otherwise.
        # Optionally modify this data prior to returning it.
        bytes.fromhex(sample)
        return sample

    def load_sample(self, sample: str, pb_msg: Message):
        # Parse input data into the provided Protobuf object.
        pb_msg.ParseFromString(bytes.fromhex(sample))

    def create_request(
        self, pb_data: Message, tab_data: None
    ) -> Soup.Message:
        # Create a HTTP request using the provided URL and Protobuf object,
        # and optionally other transport-specific side data.

        msg = Soup.Message.new('POST', self.url)
        msg.set_request_body_from_bytes(
            None, GLib.Bytes.new(pb_data.SerializeToString())
        )
        return msg

后续改进

以下内容可能会在后续版本中实现:

  • 完成自动模糊测试部分。
  • 支持从 Java 代码中提取扩展。
  • 支持 JSPB(主要 JavaScript)运行时。
  • 如果你希望支持其他任何平台,只需提交一个 issue,我会查看。

我已尽力为大多数模块编写详尽可读且带有注释的代码(除了那些基本自描述的部分,例如连接 GUI 信号),因此你可以参与贡献。

许可

pbtk 在 GNU GPL 许可下发布(我,特此声明,等等)。

关于项目名称的大小写没有正式规定,规则就是遵从你的内心 ❤

下载工具

最受欢迎

查看全部 →

发现我们社区最常用的工具。

暂无热门数据。

探索所有工具

浏览我们的工具集合

查看所有工具 →