云手机控制 API - Tài liệu

功能介绍

蜂巢云盒提供完整的 REST API 接口，支持通过 HTTP 方式对云手机进行远程控制，涵盖设备信息查询、云手机增删改查、代理管理、系统配置更新等功能，便于集成到自动化系统或自定义管理平台。

📌 接口基础地址：http://设备IP:3001/api/1_0

通用说明

项目	说明
协议	HTTP
返回格式	JSON
授权要求	部分接口需要授权（详见各接口说明）
设备 IP	在 NestBrowser 客户端中获取

GET /systeminfo

获取设备系统信息。

是否需要授权：否

返回参数：

{
  "data": {
    "id": "1",
    "dev": "设备序列号",
    "mac": "02:42:53:7e:6b:88",
    "cpu": "3.38%",
    "mem": "57.44%--15.57GB",
    "version": "1.1.35",
    "sDisk": "13.52%-57.79GB",
    "nvmDisk": "11.87%-468.38GB",
    "temp": "52.69°C",
    "desc": "授权有效,截止时间：2024-10-12 15:48:20"
  }
}

字段	说明
cpu	CPU 使用率
mem	内存使用率及总量
sDisk	系统盘使用情况
nvmDisk	数据盘使用情况
temp	设备温度
desc	授权状态及到期时间

POST /licenses

设置设备授权信息。

是否需要授权：否

请求参数：

{
  "license": "授权码字符串"
}

返回结果：

{ "valid": true }

GET /get_container_list

获取当前所有云手机列表。

是否需要授权：否

返回参数：

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

GET /get_container_info/:id

获取指定云手机的详细信息。

是否需要授权：是

路径参数：:id — 云手机 ID

返回参数：

{
  "id": 1,
  "model": "Redmi-M2003J15SC",
  "status": "created",
  "wifi_status": "created"
}

status 值	说明
created	关机
running	开机

wifi_status 值	说明
created	初始化中
running	可投屏

GET /get_online_index

获取可用来创建云手机的索引。

是否需要授权：是

返回：数字（可用的索引位置）

GET /get_img_list

获取 MX 提供的镜像列表。

是否需要授权：是

GET /get_model_list

获取 MX 提供的机型列表。

是否需要授权：是

POST /create_container

创建云手机实例。

是否需要授权：是

请求参数：

{
  "tag": "mx-20250521-gms-normal",
  "model": "Redmi-Note-7",
  "amount": 1,
  "dns": "223.5.5.5"
}

参数	必填	说明
tag	是	固件版本号
model	是	机型名称
amount	是	创建数量（≥1）
dns	否	DNS 服务器地址

返回：true 或 false

GET /run/:id

启动云手机。

是否需要授权：是

返回：true 或 false

GET /stop/:id

关闭云手机。

是否需要授权：是

返回：true 或 false

GET /remove/:id

删除云手机。

是否需要授权：是

返回：true 或 false

GET /updatedeclare/:id/:declare

更新云手机描述信息。

是否需要授权：是

路径参数：

参数	说明
:id	云手机 ID
:declare	新的描述文字

返回：true 或 false

POST /s5_set

设置云手机 SOCKS5 代理信息。

是否需要授权：是

请求参数：

{
  "id": "1",
  "proxyurl": "base64编码的代理信息"
}

代理信息需先 base64 编码，原始格式：

{
  "type": "socks5",
  "lookupUrl": "https://nestbrowser.com/api/cpi/ip-lookup",
  "proxy_status": 0,
  "host": "1.1.1.1",
  "port": "1000",
  "user": "用户名",
  "password": "密码"
}

返回：{ "valid": true }

GET /s5_query/:id

查询云手机代理信息。

是否需要授权：是

返回：包含代理状态的 JSON 数据

GET /s5_start/:id

启动云手机代理。

是否需要授权：是

返回：true 或 false

GET /s5_stop/:id

关闭云手机代理。

是否需要授权：是

返回：true 或 false

GET /install_image/:tag

安装镜像。

是否需要授权：是

返回：true 或 false

GET /remove_image/:tag

删除镜像。

是否需要授权：是

返回：true 或 false

POST /update_config

修改云手机配置信息，包括 OAID、IMEI、GPS 等参数。

是否需要授权：是

请求参数：

{
  "id": "12345",
  "data": {
    "oaid": {
      "oaid": "d8a8d7f0-1a2b-3c4d-5e6f-7a8b9c0d1e2f",
      "vaid": "v1234567890",
      "uaid": "u9876543210",
      "aaid": "a1234567890abcdef"
    },
    "gsm": {
      "imei": "123456789012345",
      "phone": "+8613812345678",
      "modeType": "LTE"
    },
    "system": {
      "timezone": "Asia/Shanghai",
      "locale": "zh-CN"
    },
    "gps": [
      "LatitudeDegrees=25.041026818001678",
      "LongitudeDegrees=121.52334876982831",
      "AltitudeMeters=1.60062531",
      "BearingDegrees=0",
      "SpeedMetersPerSec=0"
    ]
  }
}

返回：true 或 false

ADB 端口规则

通过 API 获取云手机 ID 后，可按以下公式计算 ADB 连接端口：

ADB 端口 = 云手机ID + 12000

连接示例：

# 云手机 ID=1 时
adb connect 192.168.0.100:12001