sorccu/adb

docker-adb

本仓库包含Android Debug Bridge（ADB）的Dockerfile，提供对adb、fastboot等平台工具的访问能力。

变更记录

• 2016-07-02：镜像改用Alpine作为基础镜像，大幅减小体积；优化平台工具下载方式，移除几乎所有依赖；仅保留平台工具。
• 2016-07-02：因ADB内部变更，更新启动命令为adb -a -P 5037 server nodaemon，不再使用fork-server参数。
• 2016-07-02：修复.android目录路径问题。

注意事项

• 容器需要扩展权限以访问USB设备。
• 需将主机的/dev/bus/usb挂载到容器。

安全说明

容器预加载RSA密钥用于认证，避免每次运行容器时设备重新授权。若需自定义密钥，可通过-v /your/key_folder:/root/.android挂载密钥目录。

手动更新平台工具

若需手动更新平台工具，可执行以下命令：

sh
update-platform-tools.sh

该脚本位于/usr/local/bin，已加入环境变量$PATH。

使用方式

模式1：同机共享网络（简单）

启动服务器：

docker run -d --privileged -v /dev/bus/usb:/dev/bus/usb --name adbd sorccu/adb

同机运行客户端：

docker run --rm -ti --net container:adbd sorccu/adb adb devices
docker run --rm -i --net container:adbd ubuntu nc localhost 5037 <<<000chost:devices

优点：无需端口转发、无需查找IP、adb forward直接生效；缺点：客户端容器只能用共享网络、仅限同机。

模式2：主机网络（简单但不推荐）

启动服务器：

docker run -d --privileged --net host -v /dev/bus/usb:/dev/bus/usb --name adbd sorccu/adb

同机客户端：

docker run --rm -ti --net host sorccu/adb adb devices

远程客户端：

docker run --rm -ti sorccu/adb adb -H x.x.x.x -P 5037 devices

优点：无需端口转发、无网络开销、支持远程访问；缺点：ADB服务器对其他机器可见（除非修改启动命令）。

模式3：同机链接容器（略繁琐）

启动服务器：

docker run -d --privileged -v /dev/bus/usb:/dev/bus/usb --name adbd sorccu/adb

同机客户端：

docker run --rm -ti --link adbd:adbd sorccu/adb \
  sh -c 'adb -H $ADBD_PORT_5037_TCP_ADDR -P 5037 devices'

优点：无需端口转发、自动获取IP；缺点：需手动传递服务器IP、仅限同机。

模式4：远程客户端

启动服务器：

docker run -d --privileged -v /dev/bus/usb:/dev/bus/usb --name adbd -p 5037:5037 sorccu/adb

远程客户端：

docker run --rm -ti sorccu/adb adb -H x.x.x.x -P 5037 devices

优点：支持多主机/客户端、无网络限制；缺点：需知道服务器IP、延迟较高。

Systemd服务单元

systemd/目录提供示例服务单元：

配置步骤

1. 将单元文件复制到/etc/systemd/system/。
2. 启用自动启动：

sh
systemctl enable adbd

3. 启动服务：

sh
systemctl start adbd

修改单元文件后需执行systemctl daemon-reload更新。

致谢

• Jérôme Petazzoni关于Docker USB设备访问的论坛帖子
• @sgerrand的alpine-pkg-glibc
• @frol的docker-alpine-glibc

许可证

详见LICENSE。