跳转到内容
Multilogin帮助中心

如何使用云手机 CLI 命令

使用 Multilogin CLI ,通过命令行创建、更新、启动、停止、整理、转移和管理 Android 云手机。

要查看设备上当前可用的命令,在 Windows 上运行 xcli --help,在 macOS/Linux 上运行 ./xcli --help。

开始前:启动 Multilogin CLI 并登录。如果是初次使用 CLI,请查看“如何开始使用 CLI”。

以团队成员身份使用 CLI?可用命令仍受工作区角色和文件夹权限限制。Helpjuice 成功提示正文

第 1 步:启动 CLI

启动 Multilogin,然后打开 Command Prompt 或 Terminal,进入 CLI 文件夹,并运行 CLI 可执行文件:

Windows

  1. 进入 CLI 文件夹:
    C:/Users/%username%/mlx/deps/cli
  2. 运行 xcli.exe

macOS

  1. 进入 CLI 文件夹:
    /Users/%username%/mlx/deps/cli
  2. 运行 ./xcli:
    ./xcli

Linux

  1. 进入 CLI 文件夹:
    /Home/%username%/mlx/deps/cli
  2. 运行 ./xcli:
    ./xcli

更多详情请查看:如何开始使用 CLI。

第 2 步:登录验证身份

登录以验证 CLI 会话。

粘贴此命令:xcli login --username 你的用户名 --password 你的密码:

Windows

  1. 粘贴此命令登录:
    xcli login --username 'your username' --password 'your password'
  2. 将标志(--username 和 --password)的值替换为你的邮箱和密码
Windows Command Prompt 显示 Multilogin CLI 登录成功。

macOS

  1. 粘贴此命令登录:
    ./xcli login --username 'your username' --password 'your password'
  2. 将标志(--username 和 --password)的值替换为你的邮箱和密码
macOS Terminal 显示 Multilogin CLI 登录成功。

Linux

  1. 粘贴此命令登录:
    ./xcli login --username 'your username' --password 'your password'
  2. 将标志(--username 和 --password)的值替换为你的邮箱和密码
Ubuntu 终端显示 Multilogin CLI 登录成功。

然后滚动到“Mobile Profile Commands”。此部分列出了可用于云手机的命令。

准备运行第一个云手机命令?从以下指南开始:

云手机命令

想完成特定任务?使用下表查找相应命令:

CLI 命令 说明 必填标志 备注

mobile-profiles-limit

获取云手机限额

不适用  

mobile-profiles-group

获取或创建云手机组

不适用

返回当前工作区的云手机组。如果尚无云手机组,会自动创建。

mobile-profiles-states

根据国家获取州

--country 使用 ISO 国家代码。例如,USA 和 GBR 分别代表美国和英国。

mobile-profiles-cities

根据州获取城市

--state 

使用 mobile-profiles-states 返回的州名,例如“Alabama”或“California”。

mobile-profiles-proxy-check

检查全局IP 配置

--detect-type 

--port 

--proxy-type

--server 

--detect-type 设置检测服务,可使用 IP2Location(默认)或 IP-API。

设置全局IP 端口。默认端口为 1080。

选择全局IP 类型:socks5 或 http。默认为 socks5。

在 --server 标志后设置服务器地址。

mobile-profiles-phone-brand-list

根据 Android 版本获取手机品牌列表

--android-version 为 --android-version 标志设置版本号(例如 12、13、14、15、16)。

mobile-profiles-phone-list

使用筛选条件获取云手机列表

不适用 还有其他值可用于筛选搜索结果。使用 --help 标志查看。

mobile-profiles-create

创建新的云手机

--mobile-type

--phone-name

--proxy 

使用 --mobile-type 标志设置操作系统版本,例如“Android 12”。

对于全局IP,添加完整的全局IP 字符串,例如:

socks5://user:pass@host:port

还可以设置地理位置、品牌和型号等其他值。使用 --help 标志查看。

mobile-profiles-update

更新云手机

--id

--phone-name

在 --id 标志后填写云手机 ID。

还可以编辑全局IP、备注和标签。使用 --help 标志查看所有选项。

mobile-profiles-delete

根据 ID 删除云手机

--ids

使用逗号分隔云手机 ID 列表。例如:

"1,2,3"

mobile-profiles-statuses

获取云手机状态

--ids

使用逗号分隔云手机 ID 列表。例如:

"1,2,3"

mobile-profiles-tag-assign

为云手机分配标签

--profile-id

--tags

最多可以添加 10 个标签。

mobile-profiles-tag-unassign

移除云手机的标签

--profile-id

--tags

 

mobile-phone-shutdown

关闭云手机

--ids

使用逗号分隔云手机 ID 列表。例如:

“1,2,3”

mobile-phone-launch

启动云手机

--ids

使用逗号分隔云手机 ID 列表。例如:

“1,2,3”

mobile-profiles-app-list

获取云手机可用应用的列表

不适用 可以使用其他值筛选结果。使用标志 --help 查看。

mobile-profiles-app-install

为一组手机批量安装应用

--id

--version_id

--id 是应用 ID,--version_id 是应用版本 ID。可以通过 mobile-profiles-app-list 命令获取这两个值。

mobile-profiles-phone-start

启动云手机全局IP 调用(不打开图形界面,直接启动手机)

--ids

使用逗号分隔云手机 ID 列表。例如:

“1,2,3”

mobile-profiles-phone-stop

停止云手机全局IP 调用(不使用图形界面,直接停止手机)

--ids

使用逗号分隔云手机 ID 列表。例如:

“1,2,3”

mobile-profiles-phone-import-template

下载用于导入的 Excel 模板

不适用 使用 --output 标志设置自定义导出路径。默认将文件保存到 /mlx/deps/cli/

mobile-profiles-phone-import-validate

验证云手机导入文件

--file --file 设置要验证的 Excel 文件的路径。

mobile-profiles-phone-export

将云手机导出到 Excel 文件

--ids

使用 --output 标志设置自定义导出路径。默认将文件保存到 /mlx/deps/cli/

--ids 设置要导出的配置文件数量。可以导出 1 到 200 个配置文件。

mobile-profiles-files-list

列出已上传的云手机文件

--page

设置页码。默认使用第 1 页。

可以使用其他值筛选结果。使用 --help 标志查看。

mobile-profiles-files-upload

将文件上传到云手机网盘

--file

--file 设置文件路径。使用 --help to see supported file types.

mobile-profiles-files-delete

根据 ID 删除云手机网盘中的文件

--ids

使用逗号分隔文件 ID 列表。例如:

“1,2,3”.

可以从 mobile-profiles-files-list 获取文件 ID。

mobile-profiles-files-tag-assign

为云手机文件分配标签

--material-id

--tags

--material-id 设置文件 ID。可以通过 mobile-profiles-files-list 命令获取文件 ID。

最多可以添加 10 个标签。

mobile-profiles-files-tag-unassign

取消分配给云手机文件的标签

--material-id

--tags

--material-id 设置文件 ID。可以通过 mobile-profiles-files-list 命令获取文件 ID。

最多可以添加 10 个标签。

mobile-profiles-transfer

将云手机转移给另一位用户

--ids

--target-email

使用逗号分隔文件 ID 列表。例如:

“1,2,3”.

一次最多可以转移 200 个配置文件。

--target-email 是接收方的邮箱地址。

mobile-profiles-adb-set 设置运行中的云手机的 ADB 状态 --ids 需要设置 --enable 或 --disable 标志,以管理 ADB 功能。
mobile-profiles-adb-info 获取云手机的 ADB 连接信息 --ids 返回云手机状态、IP、端口和密码(pwd)等信息。这些信息是在终端中连接 ADB所需的。

随时掌握最新动态

获取最新动态,交流经验,了解实际使用场景。

获取产品更新Telegram频道向其他用户提问Telegram聊天查看使用场景Discord社区