如何通过ADB连接云手机 - 无影云手机

需要通过ADB（Android Debug Bridge）连接云手机时，请按照本文所述步骤进行配置。

准备工作

在无影云手机控制台上创建或导入密钥对，并将密钥对绑定至对应的云手机实例。具体操作，请参见管理密钥。
将该密钥对的私钥adbkey存储在以下目录，确保能在本地通过ADB登录。
- macOS操作系统下的目录：~/.android
- Windows操作系统下的目录：%USERPROFILE%\.android
执行以下命令来重启本地的ADB进程。
```
adb kill-server
```
```
adb start-server
```

操作步骤

说明

若云手机实例所属的实例组的网络类型为共享网络，则仅支持通过私网ADB连接。
若云手机实例所属的实例组的网络类型为VPC网络，则支持通过私网ADB或公网ADB连接。

私网ADB连接

登录VPC内的ECS实例，或连接VPC内的无影云电脑。
执行以下命令连接云手机。
```
adb connect <192.168.XX.XX>:5555
```
说明
请将<192.168.XX.XX>替换为云手机的内网IP地址。
如何查询云手机的内网IP地址？
1. 登录无影云手机控制台。
2. 在左侧导航栏，单击实例。
3. 在实例页面的列表中找到该云手机实例，并复制内网IP列的值。

公网ADB连接

如果需要本地设备通过公网adb访问云手机，则需要增加一个DNAT，并修改安全组配置。

在云手机实例所属的VPC下创建公网NAT网关。具体操作，请参见云手机如何访问互联网。如已创建，请跳过此步骤。
为上述公网NAT网关创建DNAT条目，并配置端口映射规则。
1. 登录NAT网关管理控制台。
2. 在公网NAT网关页面上找到该公网NAT网关实例，并在操作列单击设置DNAT。
3. 在DNAT管理页签上单击创建DNAT条目。
4. 在创建DNAT条目页面上完成以下配置：
  - 选择弹性公网IP地址：选择一个可用的地址，并记录该弹性公网IP，通过命令连接云手机时将用到此IP。
  - 选择私网IP地址：选择通过手动输入，并填写云手机实例的内网IP。
    如何查询云手机的内网IP地址？
    登录无影云手机控制台。
    在左侧导航栏，单击实例。
    在实例页面的列表中找到该云手机实例，并复制内网IP列的值。
  - 具体端口：填写要映射的公网和私网端口，例如1000:5555。
修改弹性网卡的policy安全组的规则，将5555端口开放给公网访问。
1. 登录ECS控制台。
2. 在左侧导航栏中选择网络与安全 > 弹性网卡。
3. 在弹性网卡页面单击弹性网卡ID，并单击基本信息区域内的第一个安全组ID。
  说明
  在弹性网卡绑定的2个安全组当中，一个名称为vda，另一个名称为policy，需要修改规则的是名称为policy的安全组。单击安全组ID之后即可查看该安全组的名称。
4. 在安全组详情页签的入方向页签上单击手动添加，并配置以下规则：
  - 授权策略：允许
  - 优先级：1
  - 协议类型：自定义TCP
  - 端口范围：5555/5555
  - 授权对象：0.0.0.0/0
    说明
    此配置表示所有IP地址都可以访问5555端口。若希望提高安全性，也可以填写将执行adb命令的本地设备的公网IP地址。
执行以下命令连接云手机。
```
adb connect <公网IP>:<DNAT公网端口>
```
说明
请将<公网IP>替换为DNAT绑定的弹性公网IP，将<DNAT公网端口>替换为DNAT的公网端口，在本文示例中为1000。

常见问题

通过公网NAT连接ADB，遇到网络不通或超时问题，怎么办？

请确认执行的命令是否正确。通过公网NAT连接ADB的命令为：
```
adb connect <公网IP>:<DNAT公网端口>
```
若命令无误，请从以下方面排查：
- 确认是否已创建对应的公网DNAT条目。
- 确认公网IP和端口是否正确。
- 确认安全组是否已放行对应的端口。
- 确认VPC内的路由表配置是否正确，主要关注NAT路由表的下一跳是否已配置为SNAT的公网NAT网关。
如果仍然无法解决问题，您可以提交工单以获取阿里云技术支持。

通过ADB连接云手机时发生鉴权失败错误，怎么办？

请确认是否已绑定密钥对，并且已下载对应的adbkey文件到本地的对应目录。
绑定密钥对并将私钥下载到对应目录后，必须执行以下命令来重启本地的ADB服务。
```
adb kill-server
```
```
adb start-server
```