配置ADB连接云手机 - Cloud Phone

需要通過ADB（Android Debug Bridge）串連雲手機時，請按照本文所述步驟進行配置。

準備工作

在無影雲手機控制台上建立或匯入金鑰組，並將金鑰組綁定至對應的雲手機執行個體。具體操作，請參見管理密鑰。
將該金鑰組的私密金鑰adbkey儲存在以下目錄，確保能在本地通過ADB登入。
- macOS作業系統下的目錄：~/.android
- Windows作業系統下的目錄：%USERPROFILE%\.android
執行以下命令來重啟本地的ADB進程。
```
adb kill-server
```
```
adb start-server
```

操作步驟

說明

若雲手機執行個體所屬的執行個體組的網路類型為共用網路，則僅支援通過私網ADB串連。
若雲手機執行個體所屬的執行個體組的網路類型為VPC網路，則支援一鍵ADB（推薦），也支援通過私網ADB或公網ADB串連。

一鍵ADB（推薦）

前提條件

執行個體所屬的VPC網路已開通互連網訪問。具體操作，請參見管理VPC網路的互連網存取權限。

操作步驟

登入無影雲手機控制台。
在左側導覽列，選擇資源管理 > 執行個體。
在執行個體頁面上，找到目標執行個體，在操作列中單擊 ⋮ 表徵圖，並選擇一鍵ADB。
在一鍵ADB串連面板上，單擊一鍵建立ADB串連。
說明
若該VPC網路尚未開通互連網訪問，則請在提示彈窗中單擊立即前往開通。
稍等片刻後，ADB串連將自動建立成功。您可以單擊ADB串連方式右側的表徵圖來複製ADB串連命令。

後續步驟

一鍵ADB功能僅提供一鍵ADB串連方式，但您仍需正確配置安全性群組才能串連到執行個體。請確保您的安全性群組已開放源地址至雲手機入方向5555連接埠的TCP串連。具體操作，請參見公網ADB串連。

私網ADB串連

串連辦公網路所在VPC內的無影雲電腦。
執行以下命令串連雲手機。
```
adb connect <192.168.XX.XX>:5555
```
說明
請將<192.168.XX.XX>替換為雲手機的內網IP地址。
如何查詢雲手機的內網IP地址？
1. 登入無影雲手機控制台。
2. 在左側導覽列，選擇資源管理 > 執行個體。
3. 在執行個體頁面的列表中找到該雲手機執行個體，並複製內網IP列的值。

公網ADB串連

如果需要本地裝置通過公網adb訪問雲手機，則需要增加一個DNAT，並修改安全性群組配置。

在雲手機執行個體所屬的VPC下建立公網NAT Gateway。具體操作，請參見雲手機如何訪問互連網。如已建立，請跳過此步驟。
為上述公網NAT Gateway建立DNAT條目，並配置連接埠映射規則。
1. 登入NAT Gateway管理主控台。
2. 在公網NAT Gateway頁面上找到該公網NAT Gateway執行個體，並在操作列單擊設定DNAT。
3. 在DNAT管理頁簽上單擊建立DNAT條目。
4. 在建立DNAT條目頁面上完成以下配置：
  - 選擇Elastic IP Address地址：選擇一個可用的地址，並記錄該Elastic IP Address，通過命令串連雲手機時將用到此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綁定的Elastic IP Address，將<DNAT公網連接埠>替換為DNAT的公網連接埠，在本文樣本中為1000。

常見問題

通過公網NAT串連ADB，遇到網路不通或逾時問題，怎麼辦？

請確認執行的命令是否正確。通過公網NAT串連ADB的命令為：
```
adb connect <公網IP>:<DNAT公網連接埠>
```
若命令無誤，請從以下方面排查：
- 確認是否已建立對應的公網DNAT條目。
- 確認公網IP和連接埠是否正確。
- 確認安全性群組是否已允許存取對應的連接埠。
- 確認VPC內的路由表配置是否正確，主要關注NAT路由表的下一跳是否已配置為SNAT的公網NAT Gateway。
如果仍然無法解決問題，您可以提交工單以擷取阿里雲支援人員。

通過ADB串連雲手機時發生鑒權失敗錯誤，怎麼辦？

請確認是否已綁定金鑰組，並且已下載對應的adbkey檔案到本地的對應目錄。
綁定金鑰組並將私密金鑰下載到對應目錄後，必須執行以下命令來重啟本地的ADB服務。
```
adb kill-server
```
```
adb start-server
```