Native 与 Kotlin 客户端 · API v2

你的 Android 设备,
一个控制台。

查看设备状态、管理连接、发送任务并读取回传结果。NexusCore 把设备管理工作集中在一个清晰的工作台里。

支持 Android 5.0+ · HTTPS 通信 · 按账号隔离设备
NexusCore / 设备总览
设备总览服务正常
在线设备12
今日任务48
执行成功率98%
Pixel 8 Pro
Kotlin / Java · Android 15
● 在线
工作设备 A12
Native · Android 13
● 在线
测试机 03
Native · Android 12
○ 离线
✓ device.info   已完成 · 128ms
✓ app.list      已返回设备数据
按账号隔离设备与资源Native / Java 分层执行API v2 优先,v1 受控降级命令结果全程留痕
Core features

需要的能力,放在顺手的位置。

从设备接入到结果回传,每一步都有明确状态。控制台没有多余的概念,也不把简单操作藏在层层菜单里。

01 / DEVICES

设备状态与详情

查看型号、系统版本、最后在线时间与客户端类型,给设备添加便于识别的备注。

02 / COMMANDS

任务下发与回传

按设备发送任务,跟踪 queued、delivered、succeeded 等状态,并保存标准输出与错误信息。

03 / CLIENTS

两种执行层

Native 客户端处理系统层任务;Kotlin/Java APK 在已获 Android 权限的范围内执行结构化命令。

04 / ACCESS

细粒度访问控制

普通用户只访问自己的设备。管理员、开发者与全局配置权限分别控制。

05 / PLUGINS

可扩展插件

使用插件补充设备能力,保留参数配置与执行记录,便于定位每次任务。

06 / AUDIT

操作可追溯

设备操作、用户管理和 API 配置变更写入审计记录,问题排查有据可查。

Workflow

从接入设备开始。

创建账号并获取用户密钥

在控制台查看你的密钥,它用于客户端身份认证。

构建并安装客户端

按需求选择 Native 二进制或 Kotlin/Java APK,安装后启动服务。

确认设备上线

客户端完成首次心跳后,设备会出现在设备管理列表。

选择功能并确认下发

核对设备、执行层和参数后提交,稍后在命令历史中读取结果。

默认接口 · API v2
POST/api/v2/?r=/devices/heartbeat
GET/api/v2/?r=/devices
POST/api/v2/?r=/devices/commands

统一入口不依赖 PHP 文件名。v2 维护时客户端可切换到 v1;权限错误不会被静默降级。

查看接口文档 →
FAQ

常见问题

Native 和 Kotlin/Java 客户端怎么选?

需要系统层 Shell 能力的受控设备使用 Native 客户端;普通 APK 场景选择 Kotlin/Java 客户端。两者的设备列表和命令记录使用同一个控制台。

没有 Root 的 APK 能做什么?

可读取公开设备信息、网络状态、应用列表,并在取得对应 Android 权限后访问媒体等能力。后台截屏、跨应用文件访问、静默安装等系统级操作不在无 Root 能力范围内。

命令发送后在哪里查看结果?

进入控制台的“命令历史”,按设备或状态筛选。每次任务会保留请求 ID、执行状态、退出码和回传内容。

API v2 维护时怎么办?

新客户端会检查服务状态,并在服务不可用或维护时使用 v1 降级通道。认证失败和权限不足会明确返回错误,不会自动换接口重试。

把设备管理放回一个工作台。

登录 NexusCore,查看你的设备与任务。

打开控制台 →