reverse-engineering-browser

基于自定义 Brave 构建的本地优先 macOS 研究浏览器，可捕获网络流量、指纹、脚本和运行时证据，用于对 Web 应用进行逆向工程。

功能

• 实时网络流量： 在全宽表格中检查请求，包含可读的 路径、主机、方法、状态码和计时；选中某个请求以检查其完整 URL、标头、请求正文和通过 CDP 捕获的响应正文。
• 标签页和域组织： 按浏览器标签页分隔流量，然后将 某个标签页缩小到特定目标域或资源类型。
• 原生浏览器证据： 记录 Canvas、WebGL、Web Audio、设备和布局 API、Permissions、Storage、WebRTC 以及 JavaScript 运行时指纹识别中的调用和属性读取，外加来自 自定义 Brave 构建的请求生命周期元数据。
• 来源追踪： 通过观察到的事件、 脚本、帧、执行上下文和捕获的工件，反向追踪某个请求的 来源。
• 源代码检查和调试： 浏览页面源代码、设置断点、 暂停和单步执行 JavaScript、检查作用域、评估监视表达式，并使用 实时控制台。
• 工件捕获： 保留网络传输和 运行时生成的 JavaScript 和 WebAssembly 的有界副本，附带哈希和来源信息，以及 明确授权的 Canvas 图像输出。
• 内存和回溯工具： 检查堆快照、活动对象、解码后的 堆栈帧，以及 VM 相关发现。
• 研究工作流： 将请求保存到集合、重放隔离 请求、运行受控实验，并保留本地分析师笔记。
• 本地和有界捕获： 证据保留在机器上。敏感的 请求标头会被脱敏，CDP 捕获中的正文上限为 128 KiB， 原生队列和工件传输有明确的限制。
• 原生静默模式： 在不需要请求和响应内容时， 运行原生证据捕获而不附加 DevTools。

如何使用

下载编译好的 macOS 应用

1. 下载 Origin Trace v0.2.1 和 Brave Browser Development 预览版。
2. 解压两个文件，并将应用程序放在彼此旁边，或将 Brave Browser Development 安装到 /Applications。
3. 打开 Origin Trace。它会自动启动捕获服务和隔离的自定义 Brave 会话。

编译好的应用适用于 Apple silicon Mac。链接的 Brave Browser Development 预览版早于当前的探测支持。请从本版本的源代码构建固定版本的 Brave 集成，以使用所有原生探测；下载的预览版无法演示它们。Origin Trace 不包含捆绑的 示例证据。这些应用经过临时签名但未经 Apple 公证，因此 首次启动可能需要按住 Control 键点击应用并选择 打开。v0.2.1 GitHub 发布标签未签名；其合并提交经过 GitHub 验证。

下载编译好的 Brave 应用不需要 100+ GiB 的源代码检出。 下载和解压两个应用大约需要 1 GiB，外加你希望为浏览器配置文件和捕获的会话 保留的空间。

使用现有的自定义 Brave 构建运行实时捕获

从仓库根目录：

Origin Trace 和自定义 Brave 浏览器会一起打开。在该 Brave 窗口中浏览，并在 Traffic 标签页中选择请求。关闭 Brave 以结束 会话。捕获的证据存储在 build/sessions/live/ 下。

CDP 内容捕获是显式启用的，因为它可能保留页面内容。它会脱敏 authorization、cookie、proxy-authorization 和 set-cookie 标头。流式、 缓存、内部或已被逐出的响应正文可能不可用。

指纹操作名称默认会被捕获。若要同时为此单个会话保留 HTMLCanvasElement.toDataURL() 返回的确切图像，请添加 REB_CAPTURE_CANVAS_IMAGES=1。Canvas 图像输出可能包含页面内容，因此 默认禁用，仅保留在本地会话存储中，并限制为 每张图像 2 MiB。

首次构建自定义 Brave 浏览器

这些要求仅在从源代码编译 Brave 时适用。它们不 适用于使用可下载的编译好的 Brave 应用。

源代码构建要求：

• 安装了完整 Xcode 的 macOS；
• Node.js 和 pnpm；
• Python 3、C++20 编译器、zlib 和 Make；
• 至少 150 GiB 可用空间，建议 200 到 250 GiB。

准备固定版本的检出、应用集成、验证它，并构建 Brave：

首次完整构建可能需要数小时。后续构建是增量的，通常 会复用现有的检出和编译对象。完成后， 使用上一节中的命令启动实时捕获。

在不进行 CDP 内容捕获的情况下运行

若要在没有实时 DevTools 附加的情况下进行原生元数据和工件捕获：

在原生静默模式下，源代码、断点、单步执行、监视表达式、控制台、完整 URL、标头和 正文均不可用。

请仅在你拥有或明确获授权检查的系统上使用此项目。