Cloud Phone ADB Connection Guide

Feature Overview

ADB (Android Debug Bridge) is an important way to connect and control cloud phones. Through ADB commands, you can remotely install apps, push files, execute shell commands, suitable for development debugging and automation script scenarios.

Prerequisites

• Hive Cloud Box is powered on and running
• NestBrowser client is connected to the cloud phone
• Android SDK Platform Tools (containing adb command) is installed locally

Key Parameter Description

Parameter	How to Get
Device IP	Get from the cloud phone list in NestBrowser client
Cloud Phone ID	Get via API, see below for details

Get Cloud Phone ID

In the browser, access the following address to get the cloud phone list, the id field in the returned JSON is the cloud phone ID:

http://cloudPhoneIP:3001/api/1_0/get_container_list

Response format:

[
  { "id": 1, "model": "Redmi-M2003J15SC" },
  { "id": 2, "model": "Redmi-M2003J15SC" }
]

Port Calculation Rule

ADB port on Hive Cloud Box is calculated by the following rule:

ADB Port = Cloud Phone ID + 12000

ADB Connection Example

Assuming:

• Cloud Box Device IP: 192.168.0.100
• Cloud Phone ID: 1

Then the ADB connection command is:

adb connect 192.168.0.100:12001

Complete Operation Steps

1. Get Device IP: View the target cloud phone’s IP address in NestBrowser cloud phone list
2. Get Cloud Phone ID: Access http://deviceIP:3001/api/1_0/get_container_list, record the target cloud phone’s ID
3. Calculate Port: Port number = ID + 12000
4. Execute Connection:

# Connect to cloud phone
adb connect 192.168.0.100:12001

# Verify connection
adb devices

# Enter Shell
adb -s 192.168.0.100:12001 shell

Common ADB Commands

Command	Description
adb connect IP:port	Connect to cloud phone
adb devices	View list of connected devices
adb -s IP:port install xxx.apk	Install APK to specified cloud phone
adb -s IP:port push localPath /sdcard/targetPath	Push file to cloud phone
adb -s IP:port shell	Enter cloud phone Shell
adb -s IP:port reboot	Reboot cloud phone
adb disconnect IP:port	Disconnect

FAQ

Q: Connection failed with “unable to connect”?

• Confirm the cloud phone is running (status is “running”)
• Check if the computer and cloud box are on the same LAN
• Confirm port number calculation is correct: ID + 12000

Q: How to distinguish multiple cloud phones?

Each cloud phone has a different ADB port, distinguished by ID + 12000. Use the corresponding port when connecting to control individually.

Q: Does ADB connection require password?

Hive Cloud Box ADB connection does not require authentication by default, but it is recommended to use with NestBrowser’s device management function.