节点手册NODE HANDBOOK
Hiddify Linux 故障

Hiddify Linux 开启 VPN/TUN 报 exit status 127 怎么排查?

Hiddify Linux VPN/TUN 启动报 Bad state: exit status 127,按授权进程、共享库路径和安装包分层排查。

资料核验:2026-11-06 · 已发布

资料核验:2026-11-06 北京时间。本文只处理 Linux 桌面版 Hiddify 在点击连接、授权启动 VPN/TUN 后出现 Unexpected failure: Bad state: exit status 127 的情形。这个状态表示被调用的进程没有正常启动,但不能仅凭数字 127 认定是节点、订阅或某一个文件损坏。普通订阅更新后没有节点,请看Hiddify 订阅排查;连接成功但网页打不开,请看连接检查表。

先确认失败发生在哪一步

观察到的证据 优先检查 此时不能推断
配置中没有任何节点,尚未点击连接 订阅获取、解析和当前配置 不能套用 TUN 启动故障
点击 VPN/TUN 连接后没有出现授权提示 桌面环境的提权帮助进程是否存在、应用日志 不能直接认定缺少 hiddify-core.so
已出现授权提示,随后报 exit status 127 帮助进程、动态库路径和启动日志 不能凭 127 判断节点失效
日志明确出现 ./lib/hiddify-core.so: cannot open shared object file 安装包与相对库路径 不能用改订阅或换节点解决该启动阶段
VPN/TUN 成功启动,只有网页无法访问 出口、DNS、路由与接管范围 不属于本文的启动错误

Hiddify 官方仓库 Issue #2411 报告了 Debian 上的同名错误。维护者最初建议核对 pkexec 和桌面环境,因为 127 也可能来自提权命令找不到;这是一条诊断分支,不是对所有设备的定论。关联的 Issue #2423 则给出了更具体的 Debian 5.2.1 个案:授权窗口出现,但 HiddifyCli 引用的 ./lib/hiddify-core.so 在该启动工作目录下找不到。#2423 被并入仍开放的 #2411;截至本次核验,没有官方结论证明所有发行版或新版安装包都受同一原因影响。

按顺序检查,不先改系统文件

  1. 保存恢复点。 记录发行版、桌面环境、Hiddify 版本、安装包类型(.deb、AppImage 等)、触发时间和最早一条错误。保留原配置,先关闭 VPN/TUN,确认普通直连网络恢复。日志或截图中的订阅 URL、密钥、节点地址和账户资料必须遮盖。
  2. 核对授权阶段。 如果根本没有弹出授权提示,检查系统是否安装了 pkexec,以及桌面环境能否正常显示权限对话框。可以在自己设备的终端执行 command -v pkexec;它只检查可执行文件是否存在,不会授予权限。若授权提示已经出现并完成,则继续看帮助进程与库文件,不要反复输入密码。
  3. 读出最早的启动错误。 在应用日志中找 HiddifyCli、exit status 127 和 hiddify-core.so。只有日志明确出现共享库打不开,才进入下一步;“连接超时”或“DNS失败”应走通用连接检查。
  4. 只读核对安装文件。 仅当日志明确指向 ./lib/hiddify-core.so 时,先查自己的安装包类型、实际启动文件位置和对应库文件是否存在。相对路径还取决于进程的工作目录,不能从 Issue 中的路径推定本机路径。AppImage 与 .deb 的文件组织可能不同,不要照抄其他用户的绝对路径,也不要先修改二进制或系统目录。
  5. 从官方发布渠道核对安装包。 Hiddify 官方 Releases 按系统提供 .deb 与 AppImage 等不同包;记录当前版本与安装包,再核对是否有适合自己系统的新版或同版本重新安装说明。不要从陌生网盘下载所谓修复版,也不要在没有证据时直接删除整个应用数据目录。
  6. 复测同一动作。 一次只改变安装包或启动方式中的一个变量。记录授权是否出现、127 是否消失、核心是否启动以及普通 HTTPS 网页能否打开。127 消失仅表示这一启动阶段通过,不能证明节点长期可用。

为什么不直接照抄 Issue 里的命令

Issue #2423 的报告人曾用 patchelf 修改二进制引用,并提及修改权限或创建 /root/lib 链接。这些是单一环境下的临时做法,涉及系统文件、可执行程序能力及更新后被覆盖的问题;本文不把它们作为通用修复步骤。先保存证据并走官方安装包与维护者反馈渠道。若维护者发布针对你版本的修复说明,再按该说明操作。

提交问题时带什么证据

请写清发行版与版本、桌面环境、安装包名称、Hiddify 版本、是否出现授权提示、command -v pkexec 的结果、实际安装位置,以及最早的脱敏错误。若日志提到 hiddify-core.so,只附相关错误行。不要上传完整订阅、节点配置、系统用户名或未处理的日志。这样可以把“提权帮助进程未启动”和“帮助进程启动后找不到共享库”分开。

来源与限制

  • Hiddify Issue #2411:仍开放的 Linux exit status 127 主问题及维护者对 pkexec 的排查建议;个案不能代表所有系统。
  • Hiddify Issue #2423:Debian 5.2.1 .deb 环境中相对库路径的报告,被维护者归并到 #2411;报告人的临时修改没有被写成官方通用方案。
  • Hiddify 官方 Releases:核对当前系统对应的安装包与版本,不据此推断 127 已修复。

本站没有在全部 Linux 发行版上复现该错误,也没有验证最新发行包是否修复这个特定路径。本文提供的是按公开证据缩小故障阶段的办法。

常见问题

1. exit status 127 就说明订阅链接坏了吗?

不能。本文中的错误发生在 VPN/TUN 启动阶段;先确认节点已经出现在配置中,再看授权与帮助进程日志。订阅为空要走订阅更新排查。

2. 已经出现密码弹窗,还需要检查 pkexec 吗?

可以记录它的存在,但应优先查看授权后帮助进程的第一条错误。#2423 就是在授权窗口出现的情况下发现共享库路径问题。

3. 没看到共享库错误,是否说明节点正常?

不能。日志里没有这一条,只能说明目前不能套用 #2423 的个案;还需按实际错误检查配置、路由、DNS 或出口。

4. AppImage 能照搬 .deb 用户的安装路径吗?

不能直接套用。先核对自己的安装包和实际启动路径,再根据本机日志判断是否进入库加载分支。

5. 直接用 sudo 启动整个图形应用可以吗?

不建议当作常规方案。它可能改变用户目录权限和应用数据所有者。只把它作为维护者在特定环境中的诊断提问,不要据此长期以管理员身份运行。

6. 升到最新版本就一定修好吗?

不能保证。记录升级前后的同一动作与错误,查看官方发布说明及仍开放的主问题;不要把版本号本身当成修复证据。

延伸阅读:Hiddify 完整教程 · Hiddify WARP 精确报错 · 故障排查专题 · 免费节点测试方法。

也可以前往全部文章浏览。