rea 终端逆向分析工具安装指南:从快速试水到接入 AI 智能体
【免费下载链接】reaReverse engineer anything with agents, from app behavior down to native binaries.项目地址: https://gitcode.com/GitHub_Trending/rea2/rea
rea 是一款终端逆向分析工具:在拿不到源码的情况下,它能检查 App 行为、分析 JavaScript/Electron 应用与原生二进制,还可以作为 MCP 服务器接入 AI 智能体。本文按"先跑通、再安装、后接入"的顺序,带你完成一次完整的 rea 安装,并在结尾整理排错与常用命令。装好之后,你的终端里会多出一个rea命令,随时可以发起一次分析。
先跑一条命令,感受下 rea 逆向分析的输出
💡 正式装之前,用 npx 直接借道 npm 缓存跑一遍,零安装就能看到真实效果:
npx -y rea-agents@latest analyze-javascript-application /path/to/your-app --json这条命令会临时拉取rea-agents包并执行其中一条 JS/Electron 静态分析,-y只授权下载包本身,跑完不改动你的任何配置。终端会打印一份 JSON 记录,里面能看到模块清单、导入关系和 Electron 边界;如果回显的是网络错误,多半是访问不了 npm registry,先解决网络再说。
顺手确认一下版本,装好正式版后rea --version输出的就是同一串内容:
npx -y rea-agents@latest --version成功时输出一形如6.5.0的版本号;失败信号是包下载报错,同样指向 registry 连通性问题。
两分钟看到真实输出之后,再决定用哪种方式正式装。
三种安装路径怎么选:先看差异再动手
| 维度 | npm 全局 | curl 脚本(install.sh) | npx |
|---|---|---|---|
| 平台 | 含 Windows 全平台 | macOS / 64 位 Linux | 同 npm |
| 版本控制 | 包名带版本号,默认最新 | --version精确锁定 | @latest或指定版本 |
| 安装位置 | npm 全局前缀 | Linux 固定~/.local | npx 缓存,无安装 |
| 维护方式 | rea update原地升级 | 重跑脚本重装 | 无需维护 |
一句话点选:日常用 npm 全局,CI 锁版本看脚本,只想试一次就用 npx。下文以 npm 全局为主线展开。
安装前自检:确认 Node.js 和 npm 达标
| 检查项 | 要求 | 不满足会怎样 |
|---|---|---|
| 平台 | macOS、64 位 Linux 或 Windows | 主路线全平台通用 |
| Node.js | 22.x(≥22.19)、24.x(≥24.11)或 26+ | 23、25 及预发布版会被拒绝 |
| npm | 随 Node.js 附带即可 | 装不了包 |
| 网络 | 能访问 npm registry | 安装和 npx 都依赖它 |
把这三项信息一次打出来:
node -v && npm -v && npm config get prefix它会依次回显 Node 版本、npm 版本和 npm 全局前缀——前缀决定了全局包装到哪个目录,后面排查command not found时也要用到它。成功标志是三个值都正常打印,且 Node 落在支持区间内;如果版本号是 23.x 或 25.x,先修环境再谈安装。
把包拉下来:rea 全局安装命令
npm install --global rea-agents这一步把rea可执行文件放进 npm 全局目录,全平台同一条命令。装完日志结尾会显示added N packages in Xs,只要结尾没有ERR字样就算成功;最常见的失败信号正是日志里出现ERR或网络超时,按提示修好网络重跑即可。
落盘位置随平台不同:Linux 固定在~/.local/bin/rea,macOS 和 Windows 则跟随 npm 全局前缀,也就是自检命令打出来的那个目录下的bin子目录。
接上你的智能体:rea 连接 Claude Code 等 AI 客户端
只在终端里手动跑分析的话,这一步可以跳过。想让 AI 智能体替你执行逆向任务,执行:
rea setup它会先列出客户端候选清单(Claude Code、Codex、Cursor、Gemini CLI 等十余种),你勾选之后,终端会展示一份精确的配置修改计划——注意,批准前不会动任何文件,原有配置也会自动备份。Hopper 是其中的独立选项,只有你明确批准才会安装。完成之后,按提示重启对应智能体即可生效。
第一次真实分析:JS 应用静态分析与只读体检
对目标应用跑一条最小用例,不需要任何分析引擎:
rea analyze-javascript-application /path/to/your-app --json它对这个 JavaScript/Electron 应用做静态分析,输出里能看到模块、导入关系和 Electron 边界的 JSON 记录。想顺便给整台机器做个体检,再跑一条:
rea doctor --json这是严格只读的自检命令,不修改任何东西,回显一份 JSON 环境清单。两条命令都跑通,说明安装链路已经完整可用。
rea 版本锁定与免安装用法
团队机器或 CI 上别飘在最新版,把版本写进包名:
npm install --global rea-agents@6.4.0curl 脚本路线支持精确锁定加跳过交互,是 CI 友好形态。习惯是先--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拿不准该锁哪个号,先查一眼当前最新:
npm view rea-agents dist-tags.latest回显一个语义化版本号即可。至于 npx 免安装试用,它适合一次性验证某个功能;日常高频使用还是全局装一次更省事。
排错:看到这些报错时怎么处理
⚠️rea: command not found:Linux 把包装进了~/.local/bin,而 PATH 里没有这个目录。一条命令修好:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrcmacOS / Windows 用户改用npm config get prefix查前缀,确认它的bin子目录已加入 PATH。
⚠️安装时报 Node.js 版本不支持:23、25 及预发布版不在支持列表,或版本过旧。切到支持的版本重跑即可:
nvm install 24 && nvm use 24 && npm install --global rea-agents⚠️Linux 上分析被拒,提示缺ps:进程归属检查依赖一个 procps 兼容的ps,Ghidra 与静态 JS 分析都走它。装上再试:
sudo apt install procps💡两个容易忽略的坑:npm install rea-agents不加--global也能装,但可执行文件只落在当前项目的node_modules/.bin,shell 里敲不出rea;回滚旧版本(npm install --global rea-agents@6.4.0)之后,由于 MCP 注册钉死在当初执行 setup 的版本上,建议再跑一次rea setup对齐注册。
rea 常用命令速查
rea --version # 查已装版本 rea doctor --json # 严格只读体检 rea update # 升级当前全局安装 rea setup # 重连或修复智能体注册 rea uninstall # 只移除 REA 自有注册,自动备份更多参数与客户端细节,见 docs/installation.md 与 docs/cli.md。
【免费下载链接】reaReverse engineer anything with agents, from app behavior down to native binaries.项目地址: https://gitcode.com/GitHub_Trending/rea2/rea
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考