Escrcpy 中的 Gnirehtet 命令行全解析从反向网络共享原理到 API 实战【免费下载链接】escrcpy Display and control your Android device graphically with scrcpy.项目地址: https://gitcode.com/GitHub_Trending/es/escrcpyGnirehtet 是一款基于adb的 Android 反向网络共享Reverse Tethering工具它能让安卓设备直接复用电脑的网络连接无需 root 权限。本篇文章以 docs/zhHans/reference/gnirehtet/api.md 为骨架系统讲解 gnirehtet 全部命令的语法、参数与实战示例并结合 Escrcpy 桌面端的源码实现中继中间件、偏好设置模型、控制栏组件展开纵深分析。读完本文你将能独立完成 gnirehtet 的安装、启停、多设备管理与断线恢复并理解 Escrcpy 内部如何调用这套 CLI。一、Gnirehtet 是什么反向网络共享的核心机制在常规的“网络共享tethering”中手机把自己的移动网络分享给电脑而 gnirehtet 恰好相反——它让安卓设备通过 USB 使用电脑的网络连接。这被称为反向网络共享。它工作的关键路径是电脑端启动一个中继服务器relay server默认监听 TCP 端口31416通过adb reverse localabstract:gnirehtet tcp:31416建立一条 USB 反向隧道把设备上的抽象 socket 映射到电脑的 TCP 端口安卓端的客户端一个 APK包名com.genymobile.gnirehtet通过这条隧道把设备的 TCP/UDP 流量转发到电脑从而借用电脑的网络上网。从原理上要注意几个事实边界不需要 root 权限设备与电脑均无需目前只转发 IPv4 下的 TCP 与 UDP 流量不支持 IPv6设备端 Android 应用至少需要 API 21Android 5.0电脑端adb需支持adb reverse命令1.0.36 版本已验证可用gnirehtet 提供 Java 与 Rust 两种实现Rust 版本占用更少的 CPU 和内存且无需 JRE是官方推荐版本Java 版本则要求电脑安装 Java 8 运行时作为 Rust 版本的备选方案。二、命令总览与通用约定gnirehtet 的 CLI 结构统一为gnirehtet command [serial] [options]。核心命令共 11 个按职责可分为四类类别命令作用客户端管理install/uninstall/reinstall安装、卸载、重装设备端 APK一键启停run/autorun/stop/restart组合式完成中继 客户端生命周期管理客户端控制start/autostart仅启动设备端客户端隧道与中继tunnel/relay管理 adb reverse 隧道与中继服务器通用参数serial 与 -d / -p / -r所有命令都遵循一套公共参数约定serial位置参数目标设备序列号。仅当adb devices同时连接了多台设备时才必须指定单设备场景可省略。-d DNS[,DNS2,...]指定设备使用的 DNS 服务器多个用逗号分隔如-d 8.8.8.8,8.8.4.4。-p PORT指定中继服务器监听的端口默认31416如-p 8080。-r ROUTE[,ROUTE2,...]指定反向共享的路由网段多个用逗号分隔如-r 192.168.1.0/24。三、客户端管理install / uninstall / reinstall这三条命令只负责管理设备上的 APK不涉及网络中继。gnirehtet install [serial]在指定设备上安装客户端后立即退出。多设备场景必须携带serialgnirehtet install gnirehtet install 1234567890ABCDEFgnirehtet uninstall [serial]从指定设备卸载客户端后退出gnirehtet uninstall gnirehtet uninstall 1234567890ABCDEFgnirehtet reinstall [serial]等价于“先卸载再安装”用于客户端升级或修复异常状态gnirehtet reinstall gnirehtet reinstall 1234567890ABCDEF在 Escrcpy 中客户端安装状态通过 gnirehtet 中间件 的isInstalled检查底层调用adb.isInstalled(deviceId, com.genymobile.gnirehtet)即以上述包名在目标设备上探测 APK 是否存在。安装动作则封装为shell(install deviceId)直接把命令拼接为gnirehtet install deviceId执行并把进程纳入统一的ProcessManager管理。四、一键启停run / autorun / stop / restartrun和autorun是日常使用频率最高的命令它们把多步操作合并为一个指令。gnirehtet run [serial] [-d DNS] [-p PORT] [-r ROUTE]为单一设备启用反向网络共享内部依次执行必要时安装客户端已安装则跳过启动设备端客户端启动电脑端中继服务器按下CtrlC时停止中继服务器与客户端。gnirehtet run gnirehtet run 1234567890ABCDEF -d 8.8.8.8,8.8.4.4 gnirehtet run -p 8080 gnirehtet run -r 192.168.1.0/24gnirehtet autorun [-d DNS] [-p PORT] [-r ROUTE]为所有已连接及后续接入的设备启用反向网络共享持续监控设备连接自动为新设备启动客户端启动中继服务器。gnirehtet autorun gnirehtet autorun -d 8.8.8.8,8.8.4.4 gnirehtet autorun -p 8080 gnirehtet autorun -r 192.168.1.0/24注意autorun不接受serial设备序列号会自动从检测结果中获取。gnirehtet stop [serial]停止指定设备上的客户端并退出gnirehtet stop gnirehtet stop 1234567890ABCDEFgnirehtet restart [serial] [-d DNS] [-p PORT] [-r ROUTE]停止当前客户端后按新参数重新启动gnirehtet restart gnirehtet restart 1234567890ABCDEF -d 8.8.8.8,8.8.4.4 gnirehtet restart -p 8080 gnirehtet restart -r 192.168.1.0/24源码印证Escrcpy 中的 run 流程Escrcpy 的run(deviceId)实现见 desktop/electron/middleware/gnirehtet/index.js完整复刻了上述流程并加入了容错与偏好注入先调用stop(deviceId)清理残留失败仅告警启动relay进程通过监听 stdout 中的Relay server started判定中继就绪读取偏好common.gnirehtetFix若未开启修复开关则通过isInstalled探测客户端未安装才执行install读取偏好common.gnirehtetAppend将多行文本的换行替换为空格后 trim作为附加参数追加到start命令尾部从而支持用户自定义-d/-r等额外选项。这三个偏好gnirehtetFix、gnirehtetAppend、gnirehtetPath都定义在 desktop/src/models/preference/common/index.js 中用户在 Escrcpy 的偏好设置页可直接配置。此外gnirehtet 的可执行文件路径默认通过whichResolve(gnirehtet)探测configs/which/index.jsAPK 则由 configs/extra/index.js 指向随应用分发的resources/extra/common/gnirehtet/gnirehtet.apk。五、仅启动客户端start / autostart当不需要 gnirehtet 替你管理中继服务器例如中继已由relay独立运行时用这两条命令只控制设备端。gnirehtet start [serial] [-d DNS] [-p PORT] [-r ROUTE]在设备上启动客户端后退出参数含义指定-d设备使用指定的 DNS 服务器指定-r仅反向共享指定的路由指定-p中继服务器监听指定端口需与 relay 侧一致。gnirehtet start gnirehtet start 1234567890ABCDEF gnirehtet start -d 8.8.8.8,8.8.4.4 gnirehtet start -p 8080 gnirehtet start -r 192.168.1.0/24gnirehtet autostart [-d DNS] [-p PORT] [-r ROUTE]监听设备连接为每个检测到的设备自动启动客户端。参数与start相同但无需也不能指定serialgnirehtet autostart gnirehtet autostart -d 8.8.8.8,8.8.4.4 gnirehtet autostart -p 8080 gnirehtet autostart -r 192.168.1.0/24六、隧道与中继tunnel / relay这两条命令面向进阶的分步部署场景。gnirehtet tunnel [serial] [-p PORT]设置adb reverse隧道。当设备在 gnirehtet 运行期间断开并重新连接时隧道会失效此时执行tunnel可恢复连接——这是多设备/频繁插拔场景下最常用的故障修复手段gnirehtet tunnel gnirehtet tunnel 1234567890ABCDEF gnirehtet tunnel -p 8080gnirehtet relay [-p PORT]在当前终端启动中继服务器保持前台运行CtrlC结束gnirehtet relay gnirehtet relay -p 8080在 Escrcpy 中tunnel被封装为shell(tunnel deviceId)middleware/gnirehtet/index.js供用户在需要重置隧道时调用relay则被封装为带就绪检测的 Promise 版本只有 stdout 出现Relay server started才会 resolve确保后续客户端启动前中继一定可用。七、分步操作流程多设备场景的标准范式当需要同时为多台设备启用反向网络共享或希望精细控制各环节时可把run拆分为以下步骤这也是 Escrcpy 采用并暴露的流程# 1. 启动中继服务器并保持前台运行 ./gnirehtet relay # 2. 在另一终端安装 APK每台设备执行一次 ./gnirehtet install [serial] # 3. 为每个客户端分别启动每台设备执行一次 ./gnirehtet start [serial] # 4. 需要停止时 ./gnirehtet stop [serial] # 5. 设备断线重连后恢复隧道 ./gnirehtet tunnel [serial]再次强调只有当adb devices输出包含多台设备时才需要为命令追加serial。不带任何参数直接运行./gnirehtet可查看全部高级选项说明。八、手动运行理解底层 adb 调用链gnirehtet 命令本质上是底层adb命令的封装。手动执行可以完全脱离 gnirehtet 二进制便于排障或嵌入自己的脚本# 启动中继服务器 ./gnirehtet relay # 安装 APK adb install -r gnirehtet.apk # 建立反向隧道并启动客户端 adb reverse localabstract:gnirehtet tcp:31416 adb shell am start -a com.genymobile.gnirehtet.START \ -n com.genymobile.gnirehtet/.GnirehtetActivity # 停止客户端 adb shell am start -a com.genymobile.gnirehtet.STOP \ -n com.genymobile.gnirehtet/.GnirehtetActivity可以看到隧道名固定为localabstract:gnirehtet端口默认31416客户端 Activity 固定为com.genymobile.gnirehtet/.GnirehtetActivity通过am start携带START/STOPaction 来控制。这与 Escrcpy 中isInstalled使用包名com.genymobile.gnirehtet的探测逻辑完全对应。九、环境变量自定义 adb 与 APK 路径gnirehtet 支持两个环境变量用于在无法保证 PATH 或默认路径的场景下指定外部依赖# 指定自定义 adb 路径 ADB/path/to/my/adb ./gnirehtet run # 指定自定义 gnirehtet.apk 路径 GNIREHTET_APK/usr/share/gnirehtet/gnirehtet.apk ./gnirehtet run对应地Escrcpy 在图形界面侧提供了等价的偏好项common.adbPath与common.gnirehtetPath允许用户在偏好设置中手动覆盖可执行文件路径preference/common/index.js两者最终都会回落到window.$preload.configs提供的默认探测结果上。十、Escrcpy 中的图形化入口在 Escrcpy 桌面端gnirehtet 的能力被完整封装并暴露到渲染进程IPC 暴露createMiddleware()将 gnirehtet 中间件挂载为window.$preload.gnirehtetmiddleware/index.js渲染层可直接调用run/stop/tunnel等方法控制栏入口control-bar/gnirehtet/index.vue 提供下拉菜单包含“启动 Gnirehtet / 停止 Gnirehtet”两个动作浮窗模式下通过系统菜单open-system-menu触发启动过程中设备会进入$gnirehtetLoading加载态成功/失败分别以adaptiveMessage提示批量动作 Hookuse-gnirehtet-action/index.js 支持传入设备数组以start或stop模式逐个调用window.$preload.gnirehtet.run/stop用于对多台设备批量启停进程生命周期中间件中的所有 gnirehtet 子进程都注册进ProcessManager应用退出前监听quit-before事件统一调用stop()并killProcesses()避免残留进程。十一、使用注意事项多设备必须指定 serial否则命令会因无法确定目标设备而失败autorun/autostart不接受 serial设备由监听逻辑自动发现端口一致性start -p、relay -p、tunnel -p指定的端口必须与中继服务器实际监听端口一致默认31416断线恢复设备在反向网络共享期间断开重连后隧道会失效执行tunnel即可恢复无需重启整套服务路由限定-r用于限定反向共享的网段默认行为是共享全部可路由流量按需配置可避免不必要的流量转发停止方式run模式下按CtrlC会同时停止中继与客户端分步模式下需分别stop客户端、CtrlC结束 relay。通过本文的命令速查与源码对照无论是直接使用 CLI还是在 Escrcpy 中通过图形界面操作你都能准确掌握 gnirehtet 反向网络共享的完整生命周期管理。【免费下载链接】escrcpy Display and control your Android device graphically with scrcpy.项目地址: https://gitcode.com/GitHub_Trending/es/escrcpy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
