Protocol Reverse

zhaoxuya520/reverse-skill/skills/protocol-reverse

作者 zhaoxuya520cab634bd855f无许可证40K 个星标收录于 2026年10月9日更新于 2026年10月9日仓库2周前更新

Use for authorized reverse engineering of custom binary protocols, Protobuf/gRPC, WebSocket frames, and PCAP-driven protocol recovery.

仅含说明Security
AI 生成的概览

指导对自定义二进制协议、Protobuf/gRPC、WebSocket 帧和 PCAP 流量进行授权逆向工程。

功能
提供四阶段工作流,从抓包流量中还原线格式结构:采集与分诊、帧布局还原、序列化与加密分析,以及产物输出。要求产出消息类型表、至少一条可复现的解码命令或脚本,以及脱敏的十六进制证据。还列出工具链,包括 tshark/Wireshark、Python 3、blackboxprotobuf、ImHex 或 010 Editor,以及 IDA/r2/Ghidra。
适用场景
适用于对自定义 TCP/UDP 二进制协议、Protobuf、gRPC、FlatBuffers、MessagePack、WebSocket、MQTT 或私有 RPC 进行授权分析,以及从 PCAP/PCAPNG 还原字段与状态机。不适用于纯 HTTP 参数签名或 JS 加密、仅 TLS 证书问题,或固件协议栈深挖。
运行要求
仅为说明文档,不附带脚本。引用外部文件,如 references/protocol-workflow.md、../field-journal/precedent-reverse.md、../tool-index.md 和 ../scripts/case-init.ps1。需要 tshark/Wireshark、Python 3,可选 blackboxprotobuf、ImHex 或 010 Editor、IDA/r2/Ghidra,并在对目标操作前确认授权范围。

Protocol Reverse Engineering

ACTION REQUIRED(读完后立刻执行)

  1. NOW: 读取 ../field-journal/precedent-reverse.md — 确认授权与常规操作边界
  2. NOW: 确认任务是否为协议/流量/序列化格式逆向(非纯 Web 参数签名 → 转 js-reverse/)
  3. NOW: 若有目标网络交互 → ../scripts/case-init.ps1 完成 scope;auth 未 granted 禁止对目标 ACT
  4. NEXT: 读取 ../tool-index.md;缺工具 bootstrap(tshark/wireshark 等可能需手动)
  5. ACT: 进入工作流 Phase 1,产出帧布局或消息字典草稿

适用场景

  • 自定义 TCP/UDP 二进制协议
  • Protobuf / gRPC / FlatBuffers / MessagePack
  • WebSocket / MQTT / 私有 RPC
  • PCAP / PCAPNG 还原字段与状态机
  • 客户端-服务端校验、序列号、加密帧头

不走本 skill

情况去哪
仅 HTTP 参数签名 / JS 加密js-reverse/
仅 TLS 证书问题pentest-tools/ 或浏览器代理
固件内协议栈深挖 + 仿真firmware-pentest/ 后再回本 skill

工作流

Phase 1 — 采集与分诊

text
□ 拿到样本:PCAP / 代理导出 / 客户端日志 / 二进制□ 标记方向:C→S / S→C;是否有握手、心跳、重连□ 固定头?魔数?长度字段?TLV?定长?□ 是否压缩(zlib/gzip/lz4)或加密(AES/ChaCha 帧内)□ tshark -r cap.pcap -T fields -e frame.number -e ip.src -e tcp.payload

Phase 2 — 帧布局还原

text
□ 对齐多个同类消息,找不变字节 / 自增序列号□ 长度字段:大端/小端、含头/不含头□ 校验:CRC16/32、checksum、HMAC 位置□ 画出状态机:Connect → Auth → Ready → Request/Response → Close□ 工具:Wireshark 自定义 dissector 草稿 / ImHex / 010 Editor 模板 / Kaitai Struct

Phase 3 — 序列化与加密

text
□ Protobuf:.proto 恢复(blackboxprotobuf / pbtk / protoc --decode_raw)□ gRPC:HTTP/2 headers + protobuf body□ 加密:找密钥派生(客户端 so/dll/JS)→ 联合 ida-reverse / js-reverse / apk-reverse□ 重放:仅在授权 scope 内;先无害字段再敏感操作

Phase 4 — 产物

text
MUST 产出:- 消息类型表(name / opcode / fields)- 至少 1 条可复现的解码命令或脚本- Evidence:原始 hex 摘录 + 解码结果(脱敏)

工具链

工具必需用途自举
tshark / Wireshark强烈建议PCAP 解析手动 / winget
Python3是解码脚本系统
blackboxprotobuf可选未知 protobufpip
ImHex / 010可选结构模板手动
IDA / r2 / Ghidra按需客户端序列化函数见对应 skill

参考

  • references/protocol-workflow.md — 帧布局与 Protobuf 速查
  • 相关:../ida-reverse/ ../js-reverse/ ../firmware-pentest/ ../pentest-tools/

路由上下文

上游: MASTER-ROUTING R21 · routing.md
下游: 需客户端算法 → ida-reverse/js-reverse;需利用重放 → pentest-tools/api-security
同级: malware-analysis(C2 协议)、digital-forensics(流量取证)

任务完成自检

  • 是否还原了消息布局或状态机(而非只贴 hex)?
  • 是否有可复现解码命令?
  • 是否遵守 scope / 脱敏?
  • 是否回写 field-journal / 报告 Checklist?

来源与署名

来源:zhaoxuya520/reverse-skill位于skills/protocol-reverse提交cab634b

许可证: 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架