Escrcpy 完整指南:图形化 Scrcpy 三步投屏与反向网络共享配置
2026/9/15 19:01:24 网站建设 项目流程

Escrcpy 完整指南:图形化 Scrcpy 三步投屏与反向网络共享配置

【免费下载链接】escrcpy📱 Display and control your Android device graphically with scrcpy.项目地址: https://gitcode.com/GitHub_Trending/es/escrcpy

Escrcpy 是一个基于 Electron 构建的 Scrcpy 图形化控制壳,把安卓设备屏幕投进桌面窗口,用鼠标键盘直接操作,是一款不用敲 adb 命令的 Android 设备投屏工具。Windows、macOS、Linux 三端体验一致,安装包本身约 100MB,比传统管理工具更轻。

一次盯 3 台设备,还在终端里来回切?

手上同时跑 3 台安卓设备做验证,adb connectadb installscrcpy在终端里切来切去,光盯着命令行就费眼。Escrcpy 把 Scrcpy 的能力整体包进了图形界面:投屏、控制、批量操作、反向网络共享,全部有按钮可点,跨平台体验一致。

💡小贴士:开发者、测试和常管多台设备的人,用它最划算,群控场景下多台设备的管理效率提升明显。

它能干什么:给 Scrcpy 套了一层图形界面

一句话定义:Escrcpy 就是 Scrcpy 的图形前端,镜像与控制核心仍由 Scrcpy 提供。常用能力集中在几处:

  • 内嵌镜像窗口:设备屏幕投进独立窗口,自动适配分辨率与方向,自带快捷操作;
  • 多设备群控:单窗口同控多台设备、广播输入,支持批量截图与 APK 安装;
  • 无线连接:无线 ADB、二维码配对、局域网自动发现;
  • Gnirehtet 反向网络共享:把电脑网络共享给手机,Windows/Linux 版内置;
  • 一体化控制栏 + 自动化:旋转、截图、启动应用、终端、文件管理收在侧边栏,还能图形化编排自动化脚本,支持屏幕识图条件判断。

最短路径跑通:5 步从代码到投屏

  1. 拿源码。目录里能看到package.jsonpnpm-workspace.yaml就说明克隆成功:
git clone https://gitcode.com/GitHub_Trending/es/escrcpy cd escrcpy
  1. 准备环境。需要 Node.js v20+(以develop.md为准);ADB 的装法按平台一行带过:
平台ADB 安装备注
Windows下载 platform-tools 加入 PATH需 Win10 及以上
macOSbrew install android-platform-toolsscrcpy 二进制已内置
Linuxsudo apt install adb1.27.1+ 起 scrcpy 二进制同样内置
  1. 装依赖并启动。跑完看一眼,弹出应用窗口、主界面出现设备列表区域就对了:
corepack enable pnpm # 启用 pnpm pnpm install # 安装工作区依赖 pnpm dev # 开发模式启动
  1. 连设备。手机开启开发者选项和 USB 调试,数据线连上电脑,弹出授权提示点「允许」,设备列表里出现设备名和型号即识别成功。
  2. 开镜像。选中设备点「开始镜像」,手机画面出现在内嵌窗口,鼠标键盘直接操作,到这一步就算跑通了。

💡小贴士:想打包成可分发程序,用pnpm build(自动识别平台),或指定pnpm build:winbuild:macbuild:linux

高频场景:投屏、反向网络共享、批量装应用

设备投屏:USB 与无线两条路

USB 走上面第 4、5 步即可。无线连接两种玩法:

  • 扫码配对:先 USB 连过一次,手机开发者选项里开「无线调试」,在 Escrcpy 点「通过二维码配对设备」,一步到位;
  • IP 连接:在无线调试页面拿到手机局域网 IP 和端口(默认5555),填入后点「连接设备」。

预期画面:设备列表出现该无线设备,点「开始镜像」后画面投出,电脑上的点击、滑动实时同步到手机。

反向网络共享怎么配

让手机蹭电脑的网络,路径就三步:设备 → 设备控制栏 → Gnirehtet,点击启用即可。

  • Windows/Linux 版内置 Gnirehtet,开箱即用;
  • macOS 版未内置,需先手动安装并可在偏好设置里指定gnirehtet路径。

预期画面:手机状态栏出现数据连接标识,不连 Wi-Fi 也能上网,流量走电脑网络。

多设备批量操作

设备列表里选中多台设备,批量区直接可做批量镜像、批量截图、批量安装 APK、批量执行脚本。预期画面:多个镜像窗口按网格铺开,输入同步广播,装完 APK 后各设备的应用列表里都多了新应用。

按需进阶:不是必须,用到再开

以下内容平时不用碰,哪样卡手再配哪样:

  • 快捷键:偏好设置里可自定义全局快捷键,截图、录制、全屏这类高频操作绑上按键后效率最高;
  • 配置文件:偏好项统一落在~/.escrcpy/config.json,行为不对劲时直接检查或重置这个文件;
  • 窗口编排:多设备镜像后可可视化拖拽摆放,存成布局下次直接复用;
  • 自动化脚本scripts/目录随项目附带工具脚本;应用内「自动化」功能可逐步编排工作流,支持屏幕识图判断和多设备批量执行。

连不上 / 卡了怎么办

现象层级处理
设备无法识别连接层重新插拔并在手机上允许 USB 调试授权;Windows 先装好对应品牌驱动
无线连接提示「积极拒绝访问」连接层先扫码配对一次,或先插 USB 授权成功再转无线
启动失败 / 报错连接层确认 Node.js 已升到 v20+;按Ctrl+Shift+I打开开发者工具看具体报错
画面卡顿渲染层换 5G WiFi 或高速数据线
投屏窗口出现黑边渲染层双击黑边区域即可自动隐藏
音频无输出渲染层音频转发要求 Android 11+,不满足时在偏好设置里关掉音频转发
有画面但鼠标键盘无响应交互层设备端需允许模拟操作授权(小米另开「USB 调试(安全设置)」)
无法输入中文交互层偏好设置把键盘模式切到uhid,手机端再启用物理键盘输入法

答案去哪找:文档与社区

  • 官方文档:docs/zhHans/index.md,入门看docs/zhHans/guide/index.md,scrcpy 参数全解在docs/zhHans/reference/scrcpy/index.md
  • 问题反馈:在仓库 Issues 提交,附上设备型号与系统版本
  • 社区讨论:参与仓库 Discussions 板块

插上设备,点一下「开始镜像」,剩下的交给界面。

【免费下载链接】escrcpy📱 Display and control your Android device graphically with scrcpy.项目地址: https://gitcode.com/GitHub_Trending/es/escrcpy

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询