Adb Docker 镜像
sorccu查看 Docker Hub 原文页
自动构建
该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挂载密钥目录。
手动更新平台工具
若需手动更新平台工具,可执行以下命令:
shupdate-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守护进程容器并保持存活 |
配置步骤
- 将单元文件复制到
/etc/systemd/system/。 - 启用自动启动:
shsystemctl enable adbd
- 启动服务:
shsystemctl start adbd
修改单元文件后需执行systemctl daemon-reload更新。
致谢
- Jérôme Petazzoni关于Docker USB设备访问的论坛帖子
- @sgerrand的alpine-pkg-glibc
- @frol的docker-alpine-glibc
许可证
详见LICENSE。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull sorccu/adb:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务