如何用 SSH 隧道连接远程 adb 服务器实现 scrcpy 远程投屏

原创2026-09-09 13:06:002,315 阅读
文章标签:音视频视频桌面应用跨平台移动开发

如何用 SSH 隧道连接远程 adb 服务器实现 scrcpy 远程投屏

Android 设备连在另一台电脑上,而本地电脑没有设备接入时,scrcpy 无法直接镜像它。scrcpy 通过隧道机制解决这个问题:让本地的 adb 客户端去连接远程机器上的 adb 服务器,scrcpy 客户端则照常在本地运行。当两台机器之间的链路不可信(例如经过互联网)时,文档推荐用 SSH 隧道来加密这段通信,而不是让远程 adb 服务器直接暴露端口。

完成本场景的前提是:本地电脑装有 scrcpy 客户端与 adb;远程电脑上装有 adb 并且 Android 设备已连接在远程电脑上(USB 或同一网络);本地可以 SSH 登录远程电脑。另外,本地 adb 客户端与远程 adb 服务器应使用相同版本的 adb 协议。

scrcpy 投屏窗口截图

连接链路说明

整条链路涉及两个端口,这也是后面 SSH 命令中两组转发的含义所在:

  • 5037:adb 服务器的控制端口。scrcpy 通过环境变量 ADB_SERVER_SOCKET 指定要连接的 adb 服务器地址;SSH 隧道把本地 5038 端口转发到远程机器的 5037 端口。
  • 27183:scrcpy 建立 adb 隧道所用的本地端口(即 adb forward 使用的端口,--port 的默认值)。

按 doc/develop.md 的说明,默认情况下(未设置 --force-adb-forward 时),网络层面的客户端与服务端角色是反转的:scrcpy 客户端先在本地监听一个端口,设备端主动连过来。这就是为什么 SSH 命令里需要一条反向转发(-R):把远程机器的 27183 转发回本地的 27183,让设备端能穿过隧道连到本地 scrcpy。

建立 SSH 隧道并启动 scrcpy

第一步:确认远程电脑上的 adb 服务器在运行

在远程电脑上执行:

adb start-server

第二步:在本地建立 SSH 隧道

your_remote_computer 替换为你 SSH 登录远程电脑所用的主机(含用户名),例如 user@192.168.1.2。该命令执行后会停留在前台,必须保持这个终端一直开着,隧道才有效:

# local  5038 --> remote  5037
# local 27183 <-- remote 27183
ssh -CN -L5038:localhost:5037 -R27183:localhost:27183 your_remote_computer
# keep this open

第三步:在另一个终端运行 scrcpy

ADB_SERVER_SOCKET 指向 SSH 隧道映射出来的本地 5038 端口:

# in bash
export ADB_SERVER_SOCKET=tcp:localhost:5038
scrcpy

Windows 下两种 shell 的写法(均来自 doc/tunnels.md):

:: in cmd
set ADB_SERVER_SOCKET=tcp:localhost:5038
scrcpy
# in PowerShell
$env:ADB_SERVER_SOCKET = 'tcp:localhost:5038'
scrcpy

启动后 scrcpy 窗口显示出连在远程电脑上的那台设备的画面,说明链路已打通,此后的操作与镜像本地设备完全一致。

避免启用远程端口转发

上面命令中的 -R 要求 SSH 服务端允许远程端口转发。如果受限,可以改用两条 -L 转发(都是本地到远程方向),让 scrcpy 强制使用 adb forward 而不是 adb reverse:

# local  5038 --> remote  5037
# local 27183 --> remote 27183
ssh -CN -L5038:localhost:5037 -L27183:localhost:27183 your_remote_computer
# keep this open

然后另一个终端中运行:

export ADB_SERVER_SOCKET=tcp:localhost:5038
scrcpy --force-adb-forward

按 man 页 的定义,--force-adb-forward 的作用是“Do not attempt to use "adb reverse" to connect to the device”,即不再尝试让设备端主动回连本地,改由本地主动连接远程转发的 27183 端口,因此这条路径不需要 -R。

隧道端口被占用或链路更复杂时

如果 27183 与预期不一致(例如经过多级转发、端口重定向),可以用 --tunnel-port 强制指定建立 adb 隧道的本地端口:

scrcpy --tunnel-port=1234

按 man 页 说明,--tunnel-port 的默认值为 0(不强制),此时 scrcpy 使用建立隧道所用的本地端口。doc/tunnels.md 指出这种强制指定端口在“涉及更多重定向的复杂情况”下有用。

可选分支:不经 SSH 直连远程 adb 服务器

doc/tunnels.md 还给出了一条更直接的替代路径:让远程 adb 服务器监听所有接口,本地直接连它。在远程电脑上执行(注意 adb kill-server 会先终止该机器上现有的 adb 服务器进程,再以前台方式重启):

adb kill-server
adb -a nodaemon server start
# keep this open

然后在本地终端设置环境变量并指定隧道主机 IP(以远程电脑 IP 为 192.168.1.2 为例,替换成实际地址):

export ADB_SERVER_SOCKET=tcp:192.168.1.2:5037
scrcpy --tunnel-host=192.168.1.2

文档对这条路径有明确警告:客户端与 adb 服务器之间的所有通信都是不加密的,所以仅在可信网络内使用,跨不可信链路应回到前面的 SSH 隧道方案。

设备选择与限制

  • 如果远程电脑上同时连接了多台设备,scrcpy 不会自动选择,需要按 doc/connection.md 的方式指定,例如 scrcpy --serial=0123456789abcdef(或 scrcpy -d 只选 USB 设备、scrcpy -e 只选 TCP/IP 设备)。
  • SSH 隧道是前台进程,终端关闭即断开,scrcpy 会失去连接;需要重连时重新执行 ssh 命令即可。
  • 直连远程 adb 服务器(非 SSH)时通信不加密,这一点由文档明确标出,按网络可信度自行取舍。
登录后查看全文
scrcpy