REA 逆向分析工具快速安装教程:三步装好,让 AI 智能体替你读二进制
【免费下载链接】reaReverse engineer anything with agents, from app behavior down to native binaries.项目地址: https://gitcode.com/GitHub_Trending/rea2/rea
REA(npm 包名rea-agents)是一个终端逆向分析工具:它能检查 App 行为、静态分析 JavaScript/Electron 应用与原生二进制,还可以作为 MCP 服务器,让 Claude Code、Codex 等 AI 智能体直接调用它做分析。本文带你用约 5 分钟完成「装好 → 跑通第一次分析 → 接入 AI 智能体」,并顺手覆盖版本锁定与常见报错处理。
🧭快速导航
- 只想试一条命令,不装环境 → 免安装试用
- 日常在终端里用 → 两步装好全局安装
- 想让 AI 智能体跑逆向 → 连接智能体
- 团队或 CI 环境 → 锁定版本
先选路线:目标不同,装法不同
| 你的目标 | 推荐路线 | 核心命令 |
|---|---|---|
| 跑一次分析,不想污染环境 | npx 试用 | npx -y rea-agents@latest … |
| 日常终端使用(主路线) | npm 全局安装 | npm install --global rea-agents |
| 让 AI 智能体替你逆向 | npm 全局 + 一次 setup | rea setup |
| 团队 / CI,版本不能飘 | npm 带版本号或脚本锁定 | npm install --global rea-agents@6.4.0 |
主路线在 macOS、64 位 Linux、Windows 上都是同一条命令,只有落点略有差异:Linux 装在~/.local/bin/rea,macOS 和 Windows 跟随 npm 全局前缀。
十秒环境自检:Node 版本够不够
| 检查项 | 要求 | 不满足的后果 |
|---|---|---|
| 平台 | macOS、64 位 Linux 或 Windows | 主路线全平台通用 |
| Node.js | 22.x(≥22.23.4)、24.x(≥24.22.1)或 26.12.1+ | 23、25 及预发布版会被直接拒绝 |
| npm | 随 Node.js 附带即可 | 装不了包 |
| 网络 | 能访问 npm registry | 安装和 npx 都依赖它 |
一条命令同时确认版本和前缀路径:
node -v && npm -v && npm config get prefix终端会给出两个版本号和一行全局前缀。最容易出现问题的就是 Node 版本——不在支持列表里就先解决它,再往下走。
两步装好全局安装
第 1 步:装包。为什么跑这条:它把rea可执行文件放进 npm 全局目录,之后任意目录都能调用。
npm install --global rea-agents跑通标志:日志结尾出现added N packages in Xs,且全程没有ERR。
第 2 步:验证。rea --version确认装上了,rea doctor --json给整台机器做严格只读体检,不改任何配置。
rea --version rea doctor --json第一条应返回形如6.8.0的版本号;第二条输出一份 JSON 报告,覆盖运行环境、智能体注册与可选分析引擎的就绪情况。能正常输出 JSON 且无致命错误即代表健康。
跑通第一条分析命令:无需任何分析引擎
这是 REA 的最小真实用例:对一个 JavaScript/Electron 应用做静态分析,不用装反编译器,直接拿到应用结构。
rea analyze-javascript-application /path/to/your-app --json目标可以是解包后的应用目录或 ASAR 文件(Windows 上直接传D:/apps/example这类路径)。预期返回一份 JSON 记录,包含模块、导入关系、Electron 边界等内容。
免安装试用:npx 跑单条命令
npx -y rea-agents@latest analyze-javascript-application /path/to/app --json-y只授权下载包本身,跑完不碰你的任何配置,也不留安装痕迹。行,但只适合试水;日常使用还是装一次省事。
连接智能体:rea setup 一条命令
判断条件:只在终端用就跳过本节;想让 AI 替你跑逆向才需要。
rea setup流程是可控的,不是一股脑改写你的配置:
- 列出客户端候选(Claude Code、Codex、Cursor、Gemini CLI 等二十余种),已有 REA 注册项默认勾选;
- 勾选后先展示精确的配置修改计划,你批准后才写文件,原有配置自动备份;
- Hopper 是独立选项,明确批准才会安装,检测到已有 Hopper 则直接复用;
- 完成后按提示重启对应智能体即可。
注册完成后,直接用自然语言吩咐智能体,例如:「查一下 Notes 应用里搜索是怎么实现的,给我看证据,再帮我在项目里做一个类似功能」。它会自动调用 REA 的工具检查目标、返回带证据的结论。
自动化场景有对应的无交互形态——比如只配一个客户端并先预演:
rea setup --client codex --skill=false --dry-run--dry-run是只读预演,不写任何文件;确认计划无误后去掉它再真装。
团队与 CI:锁定版本、无交互安装
团队机器或 CI 上别飘在最新版。两种方式锁定:
npm 路线——把版本号写进包名:
npm install --global rea-agents@6.4.0脚本路线——支持 macOS 和 64 位 Linux(Windows 走 npm),--no-prompt跳过交互、--dry-run只读预演:
git clone https://gitcode.com/GitHub_Trending/rea2/rea cd rea bash install.sh --version 6.4.0 --no-prompt --dry-run bash install.sh --version 6.4.0 --no-prompt先跑带--dry-run的那条确认无误,再去掉预演标志真正安装。拿不准该锁哪个号,先查一眼当前最新发行版:
npm view rea-agents dist-tags.latest把静态分析接进 GitHub Actions 的话,可直接参考仓库里的示例工作流(examples/github-actions/rea-analysis.yml):它锁定 Node.js、REA 版本与 action 提交,并上传机器可读的分析产物,细节见 docs/ci-analysis.md。
排错速查:最常见的 5 个报错
| 症状 | 原因 | 处理 |
|---|---|---|
rea: command not found | Linux 装在~/.local/bin,PATH 里没有它 | 见下方第 1 条 |
| 安装报 Node.js 版本不支持 | 23、25 及预发布版不在支持列表,或版本过旧 | 切版本重跑,见第 2 条 |
| 想回滚到旧版本 | 回滚只换包,MCP 注册仍钉在原 setup 版本上 | 换包后重跑rea setup对齐 |
不加--global装完敲不出rea | 可执行文件只落在当前项目node_modules/.bin | 加--global重装 |
Linux 上跑分析被拒、提示ps缺失 | 进程归属检查需要 procps 兼容的ps | 装procps再试 |
对应命令:
# 1. PATH 补上安装目录(Linux) echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc # 2. 切换 Node 版本后重装 nvm install 24 && nvm use 24 && npm install --global rea-agents # 3. 回滚到指定版本 npm install --global rea-agents@6.4.0 # 5. 安装 procps(Debian/Ubuntu 系) sudo apt install procpsmacOS / Windows 出现command not found时,用npm config get prefix查前缀,确认它的bin子目录在 PATH 里即可。
收尾速查与延伸阅读
| 维度 | npm 全局(主路线) | 脚本安装 | npx 试用 |
|---|---|---|---|
| 平台 | 含 Windows 全平台 | macOS / 64 位 Linux | 同 npm |
| 版本控制 | 包名带版本号,默认最新 | --version精确锁定 | @latest或指定版本 |
| 安装位置 | npm 全局前缀 | ~/.local | npx 缓存,无安装 |
| 维护方式 | rea update原地升级 | 重跑脚本重装 | 无需维护 |
日常高频命令:
rea --version # 查已装版本 rea doctor --json # 严格只读体检 rea analyze-javascript-application /path/to/app --json # 静态分析 JS/Electron 应用 rea update # 原地升级当前全局安装 rea setup # 重连或修复智能体注册 rea uninstall # 只移除 REA 自有注册,自动备份更多参数与客户端细节,见项目文档:
- 安装指南:docs/installation.md
- CLI 参考:docs/cli.md
- 智能体环境:docs/agent-environments.md
【免费下载链接】reaReverse engineer anything with agents, from app behavior down to native binaries.项目地址: https://gitcode.com/GitHub_Trending/rea2/rea
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考