adb

Adb Docker 镜像

自动构建

该Docker镜像封装Android Debug Bridge(ADB)工具,提供adb和fastboot等平台工具,支持容器化管理安卓设备调试,包含多种使用模式及系统服务配置。

31 次收藏下载次数: 0状态:自动构建维护者:sorccu仓库类型:镜像最近更新:8 年前
下载命令
点击查看

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 docker.xuanyuan.run/sorccu/adb

同机运行客户端:

docker run --rm -ti --net container:adbd docker.xuanyuan.run/sorccu/adb adb devices
docker run --rm -i --net container:adbd docker.xuanyuan.run/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 docker.xuanyuan.run/sorccu/adb

同机客户端:

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

远程客户端:

docker run --rm -ti docker.xuanyuan.run/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 docker.xuanyuan.run/sorccu/adb

同机客户端:

docker run --rm -ti --link adbd:adbd docker.xuanyuan.run/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 docker.xuanyuan.run/sorccu/adb

远程客户端:

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

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

Systemd服务单元

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

单元文件角色用途
adb-image.service支持从Docker Hub拉取镜像
adbd-container.service支持创建ADB守护进程容器(不运行)
adbd.service主服务运行ADB守护进程容器并保持存活

配置步骤

  1. 将单元文件复制到/etc/systemd/system/。
  2. 启用自动启动:
sh
systemctl enable adbd
  1. 启动服务:
sh
systemctl start adbd

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

致谢

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

许可证

详见LICENSE。

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 adb 镜像标签

docker pull docker.xuanyuan.run/sorccu/adb:<标签>

DockerHub 原生拉取命令

docker pull sorccu/adb:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持99.95% SLA 保障付费会员免广告