REA 安装 Hopper 指南:macOS 与 Linux 双平台 demo 接入
【免费下载链接】reaReverse engineer anything with agents, from app behavior down to native binaries.项目地址: https://gitcode.com/GitHub_Trending/rea2/rea
REA 是一根桥:把你的 AI Agent 接到 Hopper、Ghidra 等逆向引擎,从应用行为一路查到原生二进制。核心只有一条rea setup引导式命令——完成 REA 接入与安装 Hopper,不购买许可证也能用免费 demo 模式跑完函数级分析。
安装前,REA 给自己划的 3 条安全线
- 审批分两段。npm 弹的下载确认只覆盖 REA 包本身;之后 REA 再展示它自己的计划——精确到文件路径、逐项变更内容、网络来源、完整性校验证据——你批准后才写文件、才装引擎。
- Hopper 另走一道审批。它和 Agent 注册是两个独立决策,有自己的确认点,不会混在别的变更里被顺带装上。
- 拒绝就是零改动。任意一步选 No 或按 Ctrl-C,系统不碰任何文件;已有配置在写入前会先备份。
动作锚点:计划出现时,先把里面列的路径和网络来源逐行看完再批准。
环境自检 + 唯一一条核心命令
- 系统:macOS 12+,Ubuntu 24.04+,Fedora 41+,64 位 Arch 或 CachyOS。
- 运行时:Node.js 22 系(≥22.19)、24 系(≥24.11)或 26+ 均可,带 npm 即可;REA 不会升级你的 Node.js、npm 或 Homebrew。
版本达标后,只需敲这一条:
npx rea-agents setup💡 想固定用最新发布版,把命令写成npx rea-agents@latest setup。动作锚点:机器满足条件就现在执行。
macOS 和 Linux 上,这条命令分别做了什么
| macOS | Linux | |
|---|---|---|
| 安装来源 | Hopper 官方 DMG | Hopper 官方.deb/.rpm/ Arch 包(当前验证为 6.4.2 demo 构建) |
| 校验方式 | 比对公开大小与 digest(摘要指纹),再验证应用包完整性 | 先校验官方包,再调系统包管理器安装 |
| 落盘位置 | 原子安装到~/Applications/Hopper Disassembler.app | 由包管理器决定,默认查找/opt/hopper,其次~/.local/share/rea/hopper |
| 管理员权限 | 不需要,不经过 Homebrew,也不用 sudo | 可能弹系统授权提示 |
| demo 怎么跑 | REA 打开 Hopper,你自选 demo 或许可证 | 每次会话挂在一块 Xvfb 私有虚拟显示上,自动点选 demo,不碰你的桌面 |
- macOS:默认启动路径是
/Applications/Hopper Disassembler.app/Contents/MacOS/hopper;Hopper 装在别处时,用HOPPER_LAUNCHER_PATH环境变量显式指向它。 - Linux:Xvfb 相当于给 Hopper 单独开一块你看不见的屏幕,桌面显示器不受影响,服务器和 CI 上同样能跑。Xvfb、Python 3、X11、XTEST 这些依赖由批准的 setup 自动补齐。
- Linux 报"找不到引擎"但文件确实存在时,用
ldd检查该可执行文件缺哪些共享库,装好再重跑rea setup。
动作锚点:安装计划出现时,确认来源一栏是官方 DMG 还是官方包,再往下走。
CI 与脚本里的无人值守组合
rea setup --yes --all-detected --install-hopper --json⚠️ 两条硬边界要记住:
--yes本身不批准安装 Hopper——必须显式带--install-hopper,否则 Hopper 安装会停在待确认状态,实际执行报needs_confirmation。- macOS 的 demo 首启选择必须在与 REA 同一用户会话里手动完成(选 demo 或激活许可证),临时 macOS 运行器需要一次交互式初始化;Linux 靠私有显示机制可以全程无人值守。
动作锚点:把这条组合正式放进流水线前,先在同环境跑一次--dry-run看计划。
出错先体检:rea doctor
rea doctor --provider hopper --json它返回结构化诊断:选中的启动策略、宿主与生效的挂载状态,外加可执行的修复建议。
| 要查什么 | 命令 |
|---|---|
| 只查 Hopper 引擎 | rea doctor --provider hopper --json |
| 只查一个 Agent 的注册 | rea doctor --client codex --json |
| 全量体检(严格只读) | rea doctor --json |
Linux 的 demo 启动失败时,照返回的修复建议修:不杀无关进程、不把 runner 桌面暴露出去、不把授权凭据写进日志。
动作锚点:装完先跑一次这条检查,把输出留在终端历史里备查。
装完即用的 demo 分析流程
- 重启已注册的 Agent——Claude Code、Cursor、Codex、Gemini CLI 都在支持列表里——然后直接描述你的任务。
- 首启时 Hopper 弹出提示,选 demo 模式或填入已有许可证。REA 不读取、不代管任何授权凭据;demo 带厂商定义的限制,但完整函数级分析够用。
- 终端侧可直接验证:
rea analyze /absolute/path/to/binary --json- Hopper 与其他引擎共存时,加
--provider hopper或设REA_ANALYSIS_PROVIDER作为长期偏好,消除多引擎歧义。
动作锚点:拿机器上一个真实二进制跑一遍rea analyze,确认链路通了。
最后记四件事
npx rea-agents setup一条命令完成引导式接入,Hopper 走独立审批,显式批准。- macOS:官方 DMG 加 digest 校验,原子装进
~/Applications,免管理员权限。 - Linux:官方包 + 系统包管理器 + Xvfb 私有显示,demo 自动点选,CI 可直接跑。
- 出错先跑
rea doctor --provider hopper --json看结构化诊断。
安装细节与 CI 边界见 docs/installation.md;环境要求见 README.md 的 What you can analyze 表格(Requirements 列)。
【免费下载链接】reaReverse engineer anything with agents, from app behavior down to native binaries.项目地址: https://gitcode.com/GitHub_Trending/rea2/rea
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考