←⌁Remote ADB文档
在线

GET STARTED

三分钟接入
远程 ADB。

Agent 负责连接 USB 设备，Client 把远程 ADB Server 映射到本机。两者都只需要向中继服务发起出站连接。

01 · Agent 电脑

安装 Node.js 20+ 和 Android Platform Tools，确认：

adb devices
# 应出现设备序列号

解压客户端后运行：

RELAY_URL=wss://HOST/
ACCESS_TOKEN=TOKEN
DEVICE_ID=SERIAL
node agent.js

Agent 会自动读取型号、上传文件，并建立 ADB 隧道。

02 · 本地桥接

在需要使用远程设备的本机运行 Client：

RELAY_URL=wss://HOST/
ACCESS_TOKEN=TOKEN
DEVICE_ID=SERIAL
node client.js

然后使用：

ADB_SERVER_SOCKET=tcp:127.0.0.1:5038 adb devices
ADB_SERVER_SOCKET=tcp:127.0.0.1:5038 adb -s SERIAL shell

Android Studio、脚本和 CI 也可以配置为本机 5038 端口。

03 · 浏览器控制台

输入令牌并选择在线设备。终端支持 shell 命令；“设备文件”可以推送 APK 或任意文件到远端路径。

adb shell pm install -r /sdcard/Download/app.apk

故障排查

  • 设备不在线：检查 adb devices、USB 调试授权和 DEVICE_ID。
  • 桥接无响应：确认 Client 与 Agent 使用同一令牌、设备编号，本机 5038 未被占用。
  • 网页无法连接：确认使用 HTTPS/WSS 地址和正确令牌。
  • 令牌轮换：修改服务器 .env 后执行 systemctl restart remote-adb。