ADB Bridge

浏览器通过 WebSocket 连接后端，后端再把原始 ADB 流量桥接到本机 adb server。当前实现聚焦 Screen Mirror，前端使用开源 scrcpy 相关包完成画面镜像和基础控制，但 USB 和 ADB Wi-Fi 连接仍统一由服务端 adb 管理。

特性

• 使用 bun 管理依赖与运行脚本
• 前端使用 React + Vite
• 后端使用 Express + WebSocket
• 浏览器端直接调用 @yume-chan/adb
• 服务端连接 @yume-chan/adb-server-node-tcp
• 使用 @yume-chan/adb-scrcpy 与 @yume-chan/scrcpy-decoder-webcodecs
• 支持 Screen Mirror、点击控制、返回/主页/最近任务/旋转、画质切换
• 支持设备选择、ADB Wi‑Fi 连接、文件浏览、上传与下载
• 支持 PWA 安装，开发模式也启用 service worker

本机运行

bun install
adb start-server
bun run dev

默认地址：

• 前端开发服务器：http://0.0.0.0:5173
• 后端 bridge：http://0.0.0.0:3000
• ADB Server：127.0.0.1:5037

可选环境变量：

PORT=3000
HOST=0.0.0.0
ADB_SERVER_HOST=127.0.0.1
ADB_SERVER_PORT=5037

生产构建：

bun run build
bun run start

容器化

当前仓库支持两种方式：

1. 本机运行

• Web 前后端在本机运行
• 使用本机 adb server

2. 容器运行

• 容器里跑前端静态文件和后端 ADB bridge
• 容器里自动启动 adb server
• 不处理 USB，只处理 ADB Wi‑Fi

镜像地址：

• ghcr.io/awsl-project/awsl-webadb:latest
• ghcr.io/awsl-project/awsl-webadb:v0.1.1

直接拉镜像运行：

docker run --rm \
  -p 3000:3000 \
  -p 5037:5037 \
  -v awsl-webadb-data:/var/lib/awsl-webadb \
  ghcr.io/awsl-project/awsl-webadb:latest

固定版本运行：

docker run --rm \
  -p 3000:3000 \
  -p 5037:5037 \
  -v awsl-webadb-data:/var/lib/awsl-webadb \
  ghcr.io/awsl-project/awsl-webadb:v0.1.1

访问：

• http://127.0.0.1:3000
• adb -H 127.0.0.1 -P 5037 devices

说明：

• 当前 Dockerfile 会安装 adb
• 容器内 Web 服务会先编译成单个可执行文件再运行
• 容器运行层不再依赖 Bun 和 node_modules
• 容器把 HOME 固定到 /var/lib/awsl-webadb
• 请持久化 /var/lib/awsl-webadb，这样 ~/.android 下的认证文件和 Wi‑Fi 配对缓存不会丢
• 容器启动会自动执行 adb -a start-server
• 后端 bridge 默认连容器内的 127.0.0.1:5037
• 容器会同时暴露 3000 和 5037
• 设备连接方式是 adb connect <ip:port>
• adb pair <ip:port> <code> 和 adb connect <ip:port> 都可以在页面里完成
• 这套方案不支持 USB 直通

容器内 ADB Wi‑Fi 的链路是：

• Web App Container -> Container adb server -> Wi-Fi Device

开源说明

本项目只使用公开开源能力，没有复制参考仓库的私有服务或闭源资产。核心依赖：

• @yume-chan/adb
• @yume-chan/adb-server-node-tcp

参考仓库：https://github.com/yume-chan/ya-webadb

对应声明见 THIRD_PARTY_NOTICES.md。