gounthar/docker-adb

docker-adb

本仓库包含Android Debug Bridge的https://www.docker.io/%E3%80%82%E5%AE%83%E8%AE%A9%E4%BD%A0%E8%83%BD%E5%A4%9F%E4%BD%BF%E7%94%A8%60adb%60%E5%92%8C%60fastboot%60%E7%AD%89%E5%B9%B3%E5%8F%B0%E5%B7%A5%E5%85%B7%E3%80%82

变更记录

• 2016-07-02 镜像现已使用https://hub.docker.com/_/alpine/%E4%BD%9C%E4%B8%BA%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%EF%BC%8C%E5%A4%A7%E5%B9%85%E5%87%8F%E5%B0%8F%E4%BD%93%E7%A7%AF%E3%80%82%E6%AD%A4%E5%A4%96%EF%BC%8C%E5%B9%B3%E5%8F%B0%E5%B7%A5%E5%85%B7%E7%9A%84%E4%B8%8B%E8%BD%BD%E6%96%B9%E5%BC%8F%E4%BC%98%E5%8C%96%EF%BC%8C%E8%BF%9B%E4%B8%80%E6%AD%A5%E7%A7%BB%E9%99%A4%E4%BA%86%E5%87%A0%E4%B9%8E%E6%89%80%E6%9C%89%E4%BE%9D%E8%B5%96%E5%B9%B6%E5%87%8F%E5%B0%8F%E9%95%9C%E5%83%8F%E5%A4%A7%E5%B0%8F%EF%BC%8C%E7%8E%B0%E5%9C%A8%E4%BB%85%E5%8C%85%E5%90%ABplatform-tools%E3%80%82
• 2016-07-02 由于adb内部变更，之前的启动命令在最新版本中不再生效。命令已更新，若你自行指定启动命令，请确保使用adb -a -P 5037 server nodaemon。不要再使用fork-server参数。
• 2016-07-02 修复了.android目录路径问题。感谢@alexislg2发现此问题！

注意事项

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

安全性

容器预加载了用于认证的RSA密钥，因此无需在每次运行容器时在设备上接受新密钥（通常密钥由adb二进制文件按需生成）。虽然方便，但这意味着拥有该密钥的其他人可通过ADB访问你的设备。你可通过docker run时使用-v /your/key_folder:/root/.android来提供自定义密钥。

手动更新平台工具

若你认为平台工具已过时且无法等待新镜像，可使用以下命令更新平台工具：

sh
update-platform-tools.sh

该脚本位于/usr/local/bin，已添加到$PATH中。

使用方法

本镜像有多种使用方式，以下列出部分可能的使用模式。根据情况有时可混合使用，也不限于以下模式，若有其他适用方式可自行尝试。

模式1 - 同一机器上的共享网络（简单）

此模式将ADB服务器容器的网络与ADB客户端容器共享。

启动服务器：

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 - 主机网络（简单但不推荐）

此模式将ADB服务器直接绑定到主机网络。

启动服务器：

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 -i --net host ubuntu nc localhost 5037 <<<000chost:devices

或在其他机器上：

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

优点：

• 无需端口转发
• 无需查找IP地址
• adb forward无需额外配置（转发对其他机器可见）
• 无Docker网络开销
• ADB服务器对其他机器可见

缺点：

• ADB服务器默认对其他机器可见（除非修改启动命令）
• 客户端容器必须使用主机网络或知道主机IP地址

模式3 - 同一机器上的链接容器（可能繁琐）

此模式将ADB服务器容器的网络与ADB客户端容器共享。

启动服务器：

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地址
• adb forward无需额外配置（转发通过指定IP对客户端容器可见）

缺点：

• 必须通过-H $ADBD_PORT_5037_TCP_ADDR向adb传递服务器IP
• 运行容器时需注意变量在容器内而非调用shell中替换
• 仅适用于服务器和客户端容器在同一机器的场景

模式4 - 远程客户端

此模式最适合从远程主机访问ADB服务器。

启动服务器：

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

其中x.x.x.x是服务器主机的IP地址。

优点：

• 可扩展性更好（支持任意数量的主机/客户端）
• 无网络限制

缺点：

• 需知晓IP地址
• 延迟较高
• 需自行开放其他端口（如adb forward转发的端口）

Systemd单元

systemd/文件夹中提供了示例systemd单元文件。

这种三单元配置虽然稍复杂，但具有显著优势：故障时启动速度极快，因为adbd.service的所有准备工作已完成，无需额外操作。adb镜像仅在开机时拉取一次，而非每次启动（或通过systemctl restart adb-image手动触发，这也会重启其他单元）。

将单元文件复制到目标机器的/etc/systemd/system/目录。

然后启用adbd.service以确保开机后自动启动：

sh
systemctl enable adbd

最后，重启机器或手动启动服务：

sh
systemctl start adbd

若修改单元文件，需运行systemctl daemon-reload使其生效。

致谢

• Jérôme Petazzoni在docker-user论坛上关于USB设备访问的文章
• @sgerrand 提供的https://github.com/sgerrand/alpine-pkg-glibc
• @frol 提供的https://github.com/frol/docker-alpine-glibc

许可证

参见LICENSE。