企业官网建设流程全解析

REA 无桌面 Linux 环境排障指南：从退出码倒查 Hopper 的 5 类启动失败

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

REA（rea-agents）是一个用 AI 智能体驱动 Hopper、Ghidra、IDA 等引擎做逆向分析的 MCP 工具链，能把应用行为一路追到原生二进制。在 headless Linux 服务器上部署时，Hopper 的启动问题往往不报"缺什么"，而是抛出一个退出码。本手册按退出码倒查根因，帮你把 REA Linux 安装流程走通。

先跑范围化自检，把状态摸清楚

一切排障前先执行：

rea doctor --provider hopper --json

这条命令会输出 REA 对当前主机的判断：发行版是否在支持名单（Ubuntu 24.04+、Fedora 41+、64 位 Arch 或 CachyOS）、Node.js 是否满足 22.x（≥22.19）、24.x（≥24.11）或 26+、Hopper 可执行文件是否就位、私有显示是否可用。注意 REA 不依赖你的桌面会话——它在固定 1280×1024 的私有 Xvfb 显示里拉起 Hopper 演示版，显示适配器逻辑在 scripts/hopper-demo-x11.py，受支持的构建版本由 SHA256 精确钉死。

拿到 JSON 后，看failure_code字段定位到下面对应的小节。

退出码 70 / 71 / 78：私有显示起不来，先补 X11 运行库

现象：private_display_unavailable（70）提示 "Install Xvfb, then rerun rea doctor"，或x11_authorization_failed（71）要求安装xauth，或x11_input_failed（78）要求安装 XTEST 运行库。

根因：CI、Docker、headless 虚机这类环境没有虚拟 X 服务端，也就没有 X11 认证与 XTEST 输入能力，Hopper 的演示对话框无法在无界面状态下被驱动。

处理：按发行版把依赖一次装齐。以下是官方安装计划使用的完整清单（源码见 src/application/LinuxHopper.ts）：

• Ubuntu / Debian（deb）：xvfb、xauth、python3、libx11-6、libxtst6
• Fedora / RHEL（rpm）：xorg-x11-server-Xvfb、xorg-x11-xauth、python3、libX11、libXtst
• Arch：xorg-server-xvfb、xorg-xauth、python、libx11、libxtst

不想逐包敲命令的话，直接走官方 setup，它会在校验 Hopper 官方.deb/.rpm/Arch 包哈希后调用系统包管理器：

npx rea-agents setup --yes --install-hopper

一个容易漏掉的边界情况：宿主机若把/tmp/.X11-unix挂成不可变目录，Xvfb 建不了 socket。REA 会先以无特权用户 + mount namespace 挂一块私有 tmpfs 兜底，全程不调用 sudo；rea doctor --provider hopper --json会报告所选策略（direct/user-mount-namespace）与挂载事实，详见 docs/installation.md 的 Hopper 章节。

退出码 75 且进程"消失"：用 ldd 定位缺失的系统库

现象：hopper_exited_during_startup（75），提示 Hopper 在 REA 桥接就绪前退出；文件明明存在，doctor 却找不到健康的分析引擎。

根因：Hopper 是可链接二进制的商业软件，缺任何一个共享库都会加载失败。REA 内部用保守规则判定库完整性（见 src/application/LinuxHopper.ts）：ldd输出里只要出现=> not found或error while loading shared libraries，启动器即判定不健康。

处理：一条命令定位所有缺失库，按输出用 apt/dnf/pacman 补装，再重跑范围化检查：

ldd /opt/hopper/bin/Hopper | grep 'not found'

补齐后若仍是 75，按错误码提示处理：CI 里先完成 Hopper 的 UI 或许可提示（以 runner 用户会话操作），否则清理残留 Hopper 会话后重试。

报"找不到 deep-analysis executable"：用 HOPPER_LAUNCHER_PATH 指向真实位置

现象：doctor 提示 "Optional deep-analysis executable cannot be found"，建议运行 setup 或设置环境变量，错误码清单见 docs/user-visible-errors.csv。

根因：Hopper 装在了 REA 默认搜索路径之外。Linux 上的默认搜索顺序是：

1. /opt/hopper/bin/Hopper（优先）
2. ~/.local/share/rea/hopper/bin/Hopper（自动回退）

处理：用HOPPER_LAUNCHER_PATH覆盖：

export HOPPER_LAUNCHER_PATH=/absolute/path/to/Hopper && rea doctor --provider hopper --json

⚠️ 该变量只接受官方钉死的演示构建版本。指向不受支持的构建会报unsupported_hopper_build（退出码 72），此时应取消该变量并重跑rea setup --yes --install-hopper。另外，curl 安装器报告的执行目录通常是~/.local/bin——忘了把它加进 PATH，是"明明装了却找不到命令"的头号原因。

闭环验证：其余退出码与真实环境参照

剩余退出码速查（对应 src/domain/hopperStartupFailure.ts）：

真实环境验证脚本 scripts/verify-real-hopper-linux.mjs 会先检查/usr/bin/Xvfb是否存在，可作为本机自检的参照。所有修复落地后，用rea doctor --provider hopper --json重新闭环验证一次即可。

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