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 connect、adb install、scrcpy在终端里切来切去,光盯着命令行就费眼。Escrcpy 把 Scrcpy 的能力整体包进了图形界面:投屏、控制、批量操作、反向网络共享,全部有按钮可点,跨平台体验一致。
💡小贴士:开发者、测试和常管多台设备的人,用它最划算,群控场景下多台设备的管理效率提升明显。
它能干什么:给 Scrcpy 套了一层图形界面
一句话定义:Escrcpy 就是 Scrcpy 的图形前端,镜像与控制核心仍由 Scrcpy 提供。常用能力集中在几处:
- 内嵌镜像窗口:设备屏幕投进独立窗口,自动适配分辨率与方向,自带快捷操作;
- 多设备群控:单窗口同控多台设备、广播输入,支持批量截图与 APK 安装;
- 无线连接:无线 ADB、二维码配对、局域网自动发现;
- Gnirehtet 反向网络共享:把电脑网络共享给手机,Windows/Linux 版内置;
- 一体化控制栏 + 自动化:旋转、截图、启动应用、终端、文件管理收在侧边栏,还能图形化编排自动化脚本,支持屏幕识图条件判断。
最短路径跑通:5 步从代码到投屏
- 拿源码。目录里能看到
package.json和pnpm-workspace.yaml就说明克隆成功:
git clone https://gitcode.com/GitHub_Trending/es/escrcpy cd escrcpy- 准备环境。需要 Node.js v20+(以
develop.md为准);ADB 的装法按平台一行带过:
| 平台 | ADB 安装 | 备注 |
|---|---|---|
| Windows | 下载 platform-tools 加入 PATH | 需 Win10 及以上 |
| macOS | brew install android-platform-tools | scrcpy 二进制已内置 |
| Linux | sudo apt install adb | 1.27.1+ 起 scrcpy 二进制同样内置 |
- 装依赖并启动。跑完看一眼,弹出应用窗口、主界面出现设备列表区域就对了:
corepack enable pnpm # 启用 pnpm pnpm install # 安装工作区依赖 pnpm dev # 开发模式启动- 连设备。手机开启开发者选项和 USB 调试,数据线连上电脑,弹出授权提示点「允许」,设备列表里出现设备名和型号即识别成功。
- 开镜像。选中设备点「开始镜像」,手机画面出现在内嵌窗口,鼠标键盘直接操作,到这一步就算跑通了。
💡小贴士:想打包成可分发程序,用pnpm build(自动识别平台),或指定pnpm build:win、build:mac、build: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),仅供参考