3 条 doctor 报错读懂，一次配好 REA 逆向工程环境

【免费下载链接】reaReverse engineer anything with agents, from app behavior down to native binaries.项目地址: https://gitcode.com/GitHub_Trending/rea2/rea

REA（Reverse Engineer Anything）是一款面向 AI Agent 的逆向工程 CLI 与 MCP 服务器，从应用行为一路追到原生二进制。环境配置是装它时最常见的坎：Node.js 或系统选错，后面跑什么都会报错。本文以三条最常见的 doctor 报错为锚点，逐条给出对应的版本约束和唯一修复路径，帮你一次装对。

坑 1：Runtime version is outside supported ranges，Node 22/24/26 白名单怎么读

你可能以为"Node.js 装 22 以上就行"，其实不是。REA 按受测运行时家族的白名单校验：22.x 要 22.19 起、24.x 要 24.11 起、26 及以上 ✅；23、25 这类奇数实验分支没进测试矩阵，任何 rc/beta 预发布 ❌。这个范围在 runtimeVersion.ts 里被硬性声明，并与 npm 包的 engines 字段保持同步——因为它只对真正测过的版本负责。

还有一条关键规矩：运行时、包管理器和 Homebrew 都不会被 REA 自动升级，版本不对只能你自己切。💡 用 nvm 这类版本管理器在 22、24、26 之间来回切更稳，不会弄脏全局环境。先验一下当前版本：

node -v

落在 23/25 或预发布上，doctor 这一项必红。另外别忽略一个细节：npm install rea-agents不带--global时只装进项目的node_modules/.bin，不在 PATH 里，"找不到命令"十有八九是这个原因。

坑 2：Host OS/distribution is unsupported，Ubuntu 24.04 之外还有哪些系统能跑

出现这条报错，说明系统不在支持范围。限制背后是个现实问题：自动化流程能不能跑通。

• macOS：12 及以上。Hopper 的自动安装会先过官方 DMG 校验，再放进~/Applications，全程用不上 Homebrew，也不要 sudo；低于 12 时 doctor 会直接提示你升级到 macOS 12 或更新版本。
• Linux：自动化只认 Ubuntu 24.04 及以上、Fedora 41 起、64 位 Arch 与 CachyOS。为什么卡这么死？因为 Linux 演示会话依赖 Xvfb、Python 3、X11 与 XTEST，这些依赖要等你批准，setup 才会一起装上。
• Windows：目前只有实验性的 Ghidra P0 边界，而且只读、仅限 x64（本地 NTFS 上的 x86-64 PE 应用），算不上完整支持的平台。

出路有两条：升级到受支持的系统；或者在不受支持的发行版上放弃自动化，手动配置现成的 Ghidra 或 IDA，REA 照样能用。

坑 3：Hopper 文件在却报缺失，Ghidra 路径与 JDK 怎么导对

这条最容易翻车：Hopper 文件明明在，doctor 却说缺失。多数情况不是主程序丢了，而是共享库依赖缺了，一行就能验出来：

ldd /path/to/Hopper | grep 'not found'

把列出来的库装上即可。引擎层的要求顺手交代清楚：Hopper 是独立商业软件，授权后 setup 可以替你装，免费 demo 带厂商限制；Ghidra 要 12.1.x，外加 64 位完整版 JDK（21 起），REA 只连接、绝不替你下载安装，且每个安装都得带本机架构的原生反编译器；IDA Pro 走的是上游 ida-pro-mcp 自带的 MCP 注册，REA 负责适配复用。

Ghidra 的路径别靠猜，下面两个变量都用绝对路径导出来：

export GHIDRA_INSTALL_DIR=/absolute/path/to/ghidra_12.1.4_PUBLIC

不导时 doctor 和 Ghidra provider 也会搜默认位置，但显式导出永远优先（哪怕它无效）。Ghidra 那一串校验——Java 版本上下限、javac 是否就位、启动要卡在 330 秒以内——细节见 docs/installation.md。

全绿验证：doctor 只读自检怎么跑，--json 交给 Agent

环境装完先别急着跑分析，来一遍只读诊断：doctor 把主机、Node 版本、分析引擎、Agent 配置全查一遍，全程不改任何东西。

npx -y rea-agents@latest doctor npx -y rea-agents@latest doctor --json

收工前把清单过一遍：node -v 落在白名单内；确认当前 rea 由对的版本拉起；不受支持的发行版已手动配好引擎；GHIDRA_INSTALL_DIR 与 JAVA_HOME 用绝对路径导出后重跑 doctor；仍失败，就把--json结构化输出直接交给 Agent 分析。全绿后跑一次npx rea-agents setup，REA 就挂进你的 AI Agent 了。

curl 安装器的选项、MCP 注册等完整流程，都写在 docs/installation.md 里。

【免费下载链接】reaReverse engineer anything with agents, from app behavior down to native binaries.项目地址: https://gitcode.com/GitHub_Trending/rea2/rea