如何通过命令行（CLI）控制网易UU远程

命令行（CLI）控制是UU远程提供的一套终端操作能力，让你无需点开界面、用鼠标一步步操作，直接在命令行里输入一行命令，就能完成查询设备、发起远控、启动云电脑、打开远程终端等操作。

它特别适合需要批量管理、自动化脚本或快速操作的场景——把常用动作写进脚本，就能一键执行，省去重复的界面点击。

同时我们为大家准备了UU远程 CLI SKILL，欢迎大家下载体验：https://a56.gdl.netease.com/uuyc-cli.zip

若有任何问题、建议也可微信扫描下方二维码进群交流：

适用场景

• 快速操作：记住命令就能一行发起远控，省去翻列表、点按钮
• 自动化任务：把常用操作写进脚本，定时启动云电脑、批量查询状态
• 批量运维：统一配置、统一策略，适合多设备管理与无人值守
• 远程终端：直接从命令行打开被控端的终端，执行远程命令

具体步骤

一、远程控制 Windows 时

所有命令都以 uuyc-cli 开头。在 Windows 设备上，先打开「命令提示符」或「PowerShell」，切换到 CLI 工具所在目录，再执行命令。

1. 切换到 CLI 所在目录

根据你的实际安装路径调整，默认目录如下：

cd C:\Program Files\Netease\GameViewer\bin

2. 确认与主程序通信正常

如果返回了应答信息，说明 CLI 与主程序通信正常，可以开始使用。

uuyc-cli echo

3. 查询可用设备

命令会以 JSON 格式返回你账号下所有可远程控制的设备，每台设备包含 deviceId（设备 ID）、deviceName（设备名）、isOnline（是否在线）等字段。记下你想连接设备的 deviceId。

uuyc-cli device list

返回示例：

   {
      "data": {
          "devices": [
             { "deviceId": "uuyc20261234", "deviceName": "home", "isOnline": true, "platform": 1 }
          ]
      },
      "success": true
  }

4. 发起远程连接

用上一步查到的 deviceId 发起连接：

uuyc-cli device connect aeawkilohaaac7fx

5. 断开连接

不带设备 ID 执行 disconnect，会断开当前所有远程连接。

uuyc-cli device disconnect

二、远程控制 macOS 设备时

所有命令都以 uuyc-cli 开头。在 macOS 设备上，打开「Terminal」，执行命令。

1. 确认与主程序通信正常

如果返回了应答信息，说明 CLI 与主程序通信正常，可以开始使用。

uuyc-cli echo

2. 查询可用设备

命令会以 JSON 格式返回你账号下所有可远程控制的设备，每台设备包含 deviceId（设备 ID）、deviceName（设备名）、isOnline（是否在线）等字段。记下你想连接设备的 deviceId。

uuyc-cli device list

返回示例：

 {
     "data": {
         "devices": [
             { "deviceId": "uuyc20261234", "deviceName": "home", "isOnline": true, "platform": 1 }
         ]
     },
     "success": true
 }

3. 发起远程连接

用上一步查到的 deviceId 发起连接：

uuyc-cli device connect aeawkilohaaac7fx

4. 断开连接

不带设备 ID 执行 disconnect，会断开当前所有远程连接。

uuyc-cli device disconnect

命令行汇总

所有命令均以 uuyc-cli 开头。查询类命令以 JSON 格式返回结果，包含 data（数据）、success（是否成功）、timestamp（时间戳）等字段，便于脚本解析。以下按类别整理当前支持的全部命令。

基础命令

命令说明示例：

命令	说明	示例
version	获取版本信息（主程序未运行时显示本地 CLI 版本	uuyc-cli version
echo [<消息>]	测试与主程序的通信（默认发送 "hello"）	uuyc-cli echo "ping"
help [<命令>]	查看指定命令的详细帮助	uuyc-cli help device

用户信息（user）

命令说明示例：

命令	说明	示例
user info	获取当前登录用户信息（默认子命令）	uuyc-cli user info
user wallet	获取钱包余额和积分	uuyc-cli user wallet

设备控制（device）

命令说明示例：

命令	说明	示例
device list	获取可远程控制的设备列表（默认子命令）	uuyc-cli device list
device connect < id >	通过设备 ID 发起远程连接	uuyc-cli device connect uuyc20260606
device disconnect [< id >]	断开远程连接；不带 ID 则断开全部	uuyc-cli device disconnect
device status	获取当前设备连接状态	uuyc-cli device status

云电脑控制（cloudpc）

命令说明示例：

命令	说明	示例
cloudpc list	获取云电脑列表（默认子命令）	uuyc-cli cloudpc list
cloudpc launch < id >	通过 ID 启动（开机）指定云电脑	uuyc-cli cloudpc launch uuyc20260606
cloudpc shutdown [< id >]	关闭云电脑；不带 ID 则关闭全部	uuyc-cli cloudpc shutdown
cloudpc connect < id >	连接到指定云电脑（需已开机）	uuyc-cli cloudpc connect uuyc20260606
cloudpc disconnect [< id >]	断开云电脑连接；不带 ID 则断开全部	uuyc-cli cloudpc disconnect

远程终端（term）

打开被控端的远程终端，可指定 Shell 类型，并支持多会话管理。目标设备可用设备名指定，也可用 --device-id 指定设备 ID，目前仅支持 Windows 设备， macOS 设备支持后续更新。 命令说明示例：

命令	说明	示例
term <设备名>	打开指定设备的远程终端	uuyc-cli term home
term --device-id < id >	用设备 ID 打开远程终端	uuyc-cli term --device-id uuyc20260606
--shell <类型>	指定 Shell 类型：powershell / cmd / zsh / bash（默认 powershell）	uuyc-cli term home --shell cmd
--list-sessions	列出该设备的远程终端会话	uuyc-cli term home --list-sessions
--new-session	强制新建一个会话	uuyc-cli term home --new-session
--session-id < id >	接入指定 ID 的已有会话	uuyc-cli term home --session-id 2
--kill-session < id >	关闭指定 ID 的会话	uuyc-cli term home --kill-session 2

远程协助（assist）

远程协助命令用于管理本机的被协助设置，以及向其他设备发起协助，目前仅支持 macOS 设备， Windows 设备支持后续更新。

注意：

• assist id 、reset-code 、set-code 、allow 这 4 个命令不要求登录（本机被协助方能力）。
• assist start 发起协助需要登录。
• 设置自定义验证码，会使得验证方式做调整，比如之前是免密，会变为验证码连接，之前是仅使用临时验证码，会变成同时使用两种。

命令说明示例：

命令	说明	示例
assist id	获取本机的远程协助连接 ID（默认子命令）	uuyc-cli assist id
assist reset-code	刷新本机临时验证码（系统自动生成 8 位）	刷新本机临时验证码（系统自动生成 8 位）
assist set-code < 验证码 >	assist set-code < 验证码 >	uuyc-cli assist set-code MyPass2026
assist allow on/off	开关「允许他人远程协助本机」	uuyc-cli assist allow on
assist start <对方ID> [验证码]	向指定设备发起远程协助；验证码可省略，省略时按对方验证方式提示	uuyc-cli assist start 12345678 ABCD2345

兼容命令（旧版短参数）

以下短参数为兼容 Windows 客户端旧版本保留，仍可正常使用。 命令说明示例：

命令	说明	示例
-v, --version	显示版本信息	uuyc-cli -v
-d, --device-id	获取本机远程协助的设备 ID（需主程序运行）	uuyc-cli -d
--list-devices	列出设备（名称、设备 ID、在线状态）	uuyc-cli --list-devices
-c, --reset-custom-code < code >	重置自定义验证码	uuyc-cli -c ABCD1234
-n, --connect <设备ID> [ 验证码 ]	发起远程协助；验证码可省略，省略时按被控端验证方式提示	uuyc-cli -n uuyc20260606
-b, --set-bitrate-limit <码率>	设置本机作为被控时最大码率上限（1–500 Mbps，0 为取消限制）	uuyc-cli -b 50
-l, --disable-lite-punch <true/false>	切换打洞模式：true=完整模式，false=轻量模式	uuyc-cli -l true

退出码说明

命令执行结束后会返回一个退出码，便于在脚本中判断执行结果。 注意：如果命令返回退出码 2，请先确认 UU 远程主程序已经打开并正常运行。 命令说明示例：

退出码	含义
0	执行成功
1	配置文件错误
2	无法连接主程序（主程序未运行）
3	无效命令
4	数据不可用
5	执行超时
6	终端命令执行失败
99	未知错误

注意事项

• 主程序必须开着：除查看本地 CLI 版本外，几乎所有命令都依赖主程序运行，关闭主程序后命令会返回退出码 2。
• 连接用的是设备 ID：device connect 需要填写设备 ID（形如 aeawkilohaaac7fx 的字符串），可先用 device list 或 --list-devices 查到对应 ID。
• disconnect / shutdown 不带 ID 会作用于全部：执行断开或关闭命令时如果不指定 ID，会对所有设备 / 云电脑生效，请谨慎使用。
• 远程终端可用设备名或设备 ID：term 命令默认用设备名称（如 term home），也可用 --device-id 指定 ID；这与 device connect 只接受 ID 的方式不同，注意区分。
• 码率限制下次连接生效：-b 设置的码率上限在下次连接时才会生效，且极端画质组合下可能压不住，建议参考合理的码率设置。

常见问题

1. 执行命令后提示无法连接主程序 / 返回退出码 2，怎么办？

这说明 UU 远程主程序没有运行。请先打开 UU 远程客户端，确认它在正常运行后再执行命令。

2. 提示找不到 uuyc-cli 命令？

你可能不在 CLI 工具所在目录。请先用 cd 切换到安装目录下的 bin 文件夹（默认 C:\Program Files\Netease\GameViewer\bin），再执行命令。

3. device connect 应该填设备名还是设备 ID？

填设备 ID（形如 aeawkilohaaac7fx 的字符串）。可以先执行 uuyc-cli device list 或 uuyc-cli --list-devices 查看每台设备对应的 deviceId，再用 ID 发起连接。

4. 我不指定 ID 直接执行 disconnect，会发生什么？

会断开当前所有远程连接。如果只想断开某一台，请在命令后加上对应的设备 ID。 注意：目前disconnect云电脑，默认是后台挂机模式。目前出现异常退出的提示弹窗，属于已知问题，弹窗问题后续会修复。