常见问题解答

这页按用户最常遇到的问题排：先看连接，再看画面和操作，最后看安装、版本和反馈。

连接类

手机上需要装什么 App 吗？

不需要。连接时会临时注入一个小程序，断开即失效，手机上不会多出任何应用图标，也不需要 root。

同一个局域网就能自动搜到手机吗？

不是自动搜到。目前需要：真机先插 USB（自动出现在设备墙），或在「连接设备」里输入设备的 IP:5555。设备扫描功能（自动发现同网段设备）在开发计划中。

为什么我输入 IP 连不上，非要插 USB？

大概率你连的是真机。真机默认关闭网络连接能力，必须先用 USB 线连一次、执行「点火」命令开通，之后才能用 IP 连。这是安卓系统的安全机制，不是 VMOS投屏的限制。完整步骤见 真机首次开通 WiFi 连接。

如何安装 adb？

当前版本需要电脑安装 adb 工具（后续版本会内置，无需安装）：

macOS（终端执行）：

brew install --cask android-platform-tools

没有 Homebrew 的话，先安装：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Windows：

1. 下载谷歌官方 Platform Tools；
2. 解压到固定位置，比如 C:\platform-tools；
3. 把该目录加入系统环境变量 Path：「设置」搜「编辑系统环境变量」→ 环境变量 → 系统变量里找到 Path → 编辑 → 新建 → 填 C:\platform-tools；
4. 重新打开 cmd，输入 adb version 验证。

Linux：

sudo apt install adb        # Debian/Ubuntu
sudo pacman -S android-tools  # Arch

装好后重启 VMOS投屏 生效。

USB 插上没反应？

按顺序排查：① 换一根支持数据传输的线（纯充电线最常见）；② 确认「USB 调试」已开启；③ 重插后在手机上点授权「允许」；④ Windows 装该品牌手机的 USB 驱动；⑤ 终端 adb devices 看设备是否出现。详见 USB 连接排查。

云机连不上？

① 确认 IP 正确、在同一内网（电脑 ping 一下）；② 确认云机平台已开放 adb（5555）端口；③ 防火墙/安全组是否拦了 5555。

连接设备要填什么格式？

填写 IP:5555，例如 192.168.1.88:5555。只填 IP 不够，因为 adb 默认走 5555 端口。多台设备可以一行一个批量粘贴。

WiFi 扫描不到设备怎么办？

当前版本不做同网段自动扫描，需要手动输入 IP:5555。如果你用的是真机，先用 USB 做一次 adb tcpip 5555 点火；如果是云机，去云机平台确认 5555 端口是否开放。

设备重启后 WiFi 连接失效？

这是安卓系统安全机制：真机重启后网络 adb 会关闭。重新插 USB 线，执行 adb tcpip 5555 后再拔线连接。

画面与操作类

画面黑屏 / 一直「连接中」？

• 手机锁屏时部分机型不输出画面，先解锁试试；
• 等待十几秒，客户端会自动重连；
• 还不行就移除卡片重新连接，或重启客户端。

能操作画面但很卡？

• 设备墙同屏路数越多越吃资源，把不用的设备移除或分组隐藏；
• WiFi 信号差会明显卡顿，重要场景建议电脑用有线网络；
• 在设置里把帧率调低（15/30 帧）可显著降负载。

鼠标能点但打不了字？

当前版本在控制大窗里用右侧「文本输入」框发送文字（先在手机上点一下输入框获得光标）。电脑键盘直接打字的功能正在开发中。

设备掉线了要重新添加吗？

不用。连接过的地址自动保存，设备回到网络后会自动重连回设备墙。

打开控制大窗后有哪些按钮？

右侧栏包含返回、主页、最近、旋转、截图、录屏和文本输入：

输入密码或敏感输入框黑屏？

部分应用会对密码框、支付页或受保护页面开启安全窗口，系统会阻止投屏录制。这不是 VMOS投屏限制。请在手机本机确认该页面，或切换到不受保护的普通输入页再操作。

画面能看但不能控制？

优先检查：小米 / Redmi 是否开启「USB 调试（安全设置）」和「通过 USB 安装」；手机上是否弹了授权或安装确认框；控制窗口是否点在真实手机画面区域，而不是设备卡片标题栏。

为什么同屏越多越卡？

每一路画面都需要解码和渲染。设备越多，电脑 CPU/GPU 和网络压力越大。建议按分组查看、降低帧率、减少同屏列数，重要场景电脑接有线网络。

批量操作类

批量操作在哪里？

选中设备后，顶部工具条会出现批量装包、推送文件、批量卸载、批量截图等按钮：

为什么批量安装 APK 有些成功有些失败？

常见原因：某些手机开启了安装确认、旧版本签名不同、存储空间不足、数据线或 WiFi 不稳定。先选 1 到 2 台测试通过，再扩大到整组设备。

批量截图会影响设备操作吗？

截图会短暂占用设备和电脑资源。几十台同时截图时建议等待结果全部返回，不要连续快速点击批量截图。

批量卸载安全吗？

批量卸载不可恢复，必须确认包名准确。建议先在少量测试设备上卸载一次，再对整组执行。

安装与环境类

Windows 提示「已保护你的电脑」？

SmartScreen 对新软件的正常提示，点「更多信息」→「仍要运行」。

Mac 提示「无法验证开发者」？

新版本已签名公证，正常不会出现。老版本遇到：「系统设置 → 隐私与安全性」底部点「仍要打开」，或下载最新版。

支持 iPhone 吗？

当前版本支持安卓设备（真机和云机）。iOS 支持在规划中。

数据安全吗？

所有画面和控制数据只在你的局域网内传输，不上传任何云端服务器。软件核心基于开源项目构建，源码可查。

当前最新版本是多少？

官网当前公开下载版本是 v0.1.0。更新内容和三端安装包地址见 版本发布历史。

能离线使用吗？

只要电脑和设备在同一个局域网内，核心投屏和控制不依赖公网。下载安装包、访问在线文档、远程云机平台本身可能需要网络。

如何提交有效反馈？

请带上设备类型、客户端版本、电脑系统、手机型号、连接方式、问题截图或录屏。完整模板见 如何反馈问题。

还是解决不了？

参考 如何反馈问题 联系我们，按模板提供信息能最快得到解决。