如何通过ADB将USB Android真机连接至Kubernetes中的Appium Server

前提条件 #

• 本地机器已通过ADB成功连接Android真机，设备处于USB调试模式并授权本地机器
• Kubernetes集群中已部署Appium 2.0 Server容器

操作步骤 #

1. 配置本地ADB服务器允许远程访问
   先停止本地运行的ADB服务，再启动监听所有网卡的ADB服务：

   adb kill-server
   adb -a -P 5037 start-server
   

   此操作让本地ADB服务器可以被Kubernetes集群内的容器访问。

2. 确保Kubernetes容器能访问本地ADB端口
   确认本地机器与Kubernetes集群网络互通，关闭本地防火墙对5037端口的限制，或添加放行规则。
   测试环境可通过kubectl port-forward临时打通网络（假设Appium Pod在default命名空间，名称为appium-server-xxxx）：

   kubectl port-forward pod/appium-server-xxxx 5037:<本地机器IP>:5037
   

   生产环境可通过NodePort/LoadBalancer服务暴露本地ADB端口，或确保Appium容器所在节点能直接访问本地机器IP。

3. 配置Appium Server连接远程ADB
   在Appium容器中指定本地ADB服务器地址，有两种方式：

   • 启动Appium时添加参数：

     appium --adb-server-host <本地机器IP> --adb-server-port 5037
     

   • 在Kubernetes部署yaml中配置环境变量（推荐）：

     env:
       - name: ANDROID_ADB_SERVER_URL
         value: "http://<本地机器IP>:5037"
     

4. 验证设备连接
   进入Appium容器执行ADB命令，确认能识别到本地连接的真机：

   kubectl exec -it <appium-pod-name> -- adb devices
   

   输出中出现已连接的设备序列号即表示配置成功。

注意事项 #

• 本地ADB服务器版本需与Appium容器内的ADB客户端版本一致，避免版本不兼容导致连接失败
• 若设备连接后断开，需重新在本地执行adb devices触发授权，再在容器中重新检查连接

内容的提问来源于stack exchange，提问作者Udara Manupriya