雲手機 ADB 連線指南
蜂巢雲盒通過 ADB 連線雲手機的完整教程，包含 IP 位址獲取、雲手機 ID 查詢、連接埠計算與連線命令詳解。
最后更新：
功能介紹
ADB（Android Debug Bridge）是連線和控制雲手機的重要方式。通過 ADB 命令，可以遠端安裝應用程式、推送檔案、執行 Shell 命令，適用於開發偵錯和自動化腳本場景。
前置條件
- 蜂巢雲盒已開機並運行
- NestBrowser 用戶端已連線雲手機
- 本地已安裝 Android SDK Platform Tools（含 adb 命令）
關鍵參數說明
| 參數 | 獲取方式 |
|---|---|
| 設備 IP | 在 NestBrowser 用戶端的雲手機列表中獲取 |
| 雲手機 ID | 通過 API 獲取，詳見下方說明 |
獲取雲手機 ID
在瀏覽器存取以下位址，獲取雲手機列表，返回的 JSON 中 id 欄位即為雲手機 ID：
http://雲手機IP:3001/api/1_0/get_container_list
返回格式：
[
{ "id": 1, "model": "Redmi-M2003J15SC" },
{ "id": 2, "model": "Redmi-M2003J15SC" }
]
連接埠計算規則
蜂巢雲盒的 ADB 連接埠按以下規則計算：
ADB 連接埠 = 雲手機ID + 12000
ADB 連線範例
假設：
- 雲盒設備 IP：
192.168.0.100 - 雲手機 ID：
1
則 ADB 連線命令為：
adb connect 192.168.0.100:12001
完整操作步驟
- 獲取設備 IP：在 NestBrowser 雲手機列表中查看目標雲手機的 IP 位址
- 獲取雲手機 ID：存取
http://設備IP:3001/api/1_0/get_container_list，記錄目標雲手機的 ID - 計算連接埠：連接埠號 = ID + 12000
- 執行連線：
# 連線雲手機
adb connect 192.168.0.100:12001
# 驗證連線
adb devices
# 進入 Shell
adb -s 192.168.0.100:12001 shell
常用 ADB 命令
| 命令 | 說明 |
|---|---|
adb connect IP:連接埠 | 連線雲手機 |
adb devices | 查看已連線設備列表 |
adb -s IP:連接埠 install xxx.apk | 安裝 APK 到指定雲手機 |
adb -s IP:連接埠 push 本地路徑 /sdcard/目標路徑 | 推送檔案到雲手機 |
adb -s IP:連接埠 shell | 進入雲手機 Shell |
adb -s IP:連接埠 reboot | 重啟雲手機 |
adb disconnect IP:連接埠 | 中斷連線 |
常見問題
Q：連線失敗提示 “unable to connect”？
- 確認雲手機正在運行中（狀態為「運行中」）
- 檢查電腦與雲盒是否在同一區域網路
- 確認連接埠號計算正確：
ID + 12000
Q：多台雲手機如何區分？
每台雲手機的 ADB 連接埠不同，通過 ID + 12000 區分，連線時使用對應連接埠即可單獨控制。
Q：ADB 連線需要密碼嗎？
蜂巢雲盒預設 ADB 連線無需認證，但建議配合 NestBrowser 的設備管理功能使用。