运维自动化神器！UU远程CLI命令行功能全教程，一行代码管控全部设备

对于运维工程师、脚本开发者、AI爱好者、多设备管理人员，反复点击可视化远程客户端效率极低。网易UU远程推出完整CLI命令行终端工具，全部远程操作仅靠一行指令完成，可嵌入批处理、Shell、AI流程实现全自动无人值守管控，覆盖本地设备、云电脑、远程Shell、远程协助四大核心能力，Windows、macOS双端同步上线。

一、什么是UU远程CLI命令行控制？

CLI（命令行）控制是UU远程内置的终端操作能力，无需打开软件可视化界面，直接在CMD、PowerShell、系统终端输入指令，即可一站式完成：

• 查询账号下全部在线/离线本地设备、云电脑列表
• 一键发起/断开远程桌面连接
• 启动、关机、调度云电脑实例
• 直连被控端Shell终端，远程批量执行运维命令
• 管理本机远程协助权限、生成/刷新连接验证码

全部指令统一以 uuyc-cli 作为前缀，查询类接口标准返回JSON结构化数据，方便脚本解析、AI程序读取调用。

CLI五大核心适用场景

1. 快速操作党 熟记简短指令一键发起远控，省去翻阅设备列表、鼠标点击按钮的重复操作。
2. 自动化脚本玩家 将远程流程写入定时脚本，自动启动云电脑、批量巡检设备在线状态、定时远程运维。
3. 批量机房运维 统一批量下发管控策略，适配企业多办公设备、机房服务器7×24小时无人值守管理。
4. 纯远程终端需求 无需加载远程桌面画面，纯命令行接入被控端cmd/PowerShell/bash，轻量化执行运维指令。
5. AI程序提效 通过自然语言驱动AI，随时调用UU远程全部远控、云电脑、终端功能，打通AI自动化工作流。

二、Windows设备标准使用步骤

前置三大使用前提

1. 运行状态：绝大多数命令依赖UU远程主客户端打开运行，关闭主程序会返回报错退出码2；仅version版本查询命令无需主程序。
2. 账号登录：客户端需提前登录账号，设备列表、远控权限、云电脑资源全部绑定登录账号。
3. 工具路径：CLI执行文件 uuyc-cli.exe 存放于软件安装目录 bin 文件夹内。

分步操作流程

1. 切换至CLI工具目录 打开命令提示符或PowerShell，执行路径切换指令（默认安装路径）： cd C:\Program Files\NetEase\GameViewer\bin

步骤2：校验CLI与主程序通信

执行连通测试指令，确认工具正常通信： uuyc-cli echo 终端返回应答文字即代表连接正常，可继续使用全部指令。

步骤3：查询账号下所有可控设备

uuyc-cli device list

命令以JSON格式返回全部设备信息，包含deviceId（设备唯一ID）、设备名称、在线状态，记录目标设备ID用于后续连接。

步骤4：一行命令发起远程连接

将上一步获取的设备ID填入指令，一键建立远控：

uuyc-cli device connect 设备 ID 字符串

步骤5：断开远程连接

断开单台指定设备

uuyc-cli device connect 设备 ID

不带 ID，断开当前所有远程连接

uuyc-cli device disconnect

三、全分类CLI完整命令汇总

3.1 基础通用命令

命令	功能说明	使用示例
version	读取本地CLI版本，无需启动主程序	uuyc-cli version
echo [消息]	测试CLI与主程序通信连通性	uuyc-cli echo "ping"
help [命令名]	查看指定分类命令完整参数文档	uuyc-cli help device

3.2 用户信息命令

命令	功能说明	使用示例
user info	获取当前登录账号基础信息	uuyc-cli user info

3.3 本地设备(device)控制命令

命令	功能说明	使用示例
device list	获取账号下全部本地受控设备列表	uuyc-cli device list
device connect	通过设备唯一ID发起远程桌面连接	uuyc-cli device connect uuyc20260606
device disconnect [id]	断开远程连接，无ID则断开全部	uuyc-cli device disconnect
device status	获取当前全部远程连接在线状态	uuyc-cli device status

3.4 云电脑(cloudpc)调度命令

命令	功能说明	使用示例
cloudpc list	查询账号下全部云电脑实例	uuyc-cli cloudpc list
cloudpc launch	开机启动指定ID云电脑	uuyc-cli cloudpc launch uuyc20260606
cloudpc shutdown [id]	关闭云电脑，无ID则关闭全部实例	uuyc-cli cloudpc shutdown
cloudpc connect	连接已开机的指定云电脑	uuyc-cli cloudpc connect uuyc20260606
cloudpc disconnect [id]	断开云电脑远程连接	uuyc-cli cloudpc disconnect

3.5 远程终端(term)命令（仅支持Windows被控端）

可使用设备名直接连接，也可通过--device-id指定ID，支持多会话管理、切换Shell类型

命令参数	功能说明	使用示例
term <设备名>	打开指定设备远程终端	uuyc-cli term home
term --device-id	通过设备ID打开远程终端	uuyc-cli term --device-id uuyc20260606
--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	接入指定编号的已有会话	uuyc-cli term home --session-id 2
--kill-session	关闭指定编号终端会话	uuyc-cli term home --kill-session 2

3.6 远程协助(assist)命令（当前仅macOS本机支持）

用于管理本机协助权限、生成连接凭证、向其他设备发起协助

命令	功能说明	使用示例
assist id	获取本机远程协助连接ID	uuyc-cli assist id
assist reset-code	自动刷新8位临时协助验证码	uuyc-cli assist reset-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

四、命令退出码标准说明

每条指令执行完成后会返回数字退出码，方便脚本、AI程序自动判断执行结果：

退出码	对应含义
0	命令执行成功
1	配置文件读取错误
2	无法连接UU远程主程序（客户端未打开）
3	输入无效命令/参数错误
4	请求数据不可用、设备不存在
5	接口执行超时
6	远程终端内部执行失败
99	未知异常错误

五、CLI功能核心注意事项

1. 主程序常驻要求：除version版本查询外，其余所有命令必须保持UU远程客户端后台运行，关闭后主程序会返回退出码2报错；
2. connect指令仅支持设备ID：device connect、cloudpc connect 后方只能填写长串设备ID，不支持直接输入设备名称；term命令可填设备名，两者传参规则不同；
3. 无参指令全局生效：disconnect、cloudpc shutdown 不携带设备ID时，操作会作用于全部连接/云电脑，批量执行前谨慎操作；
4. 远程终端平台限制：term远程终端当前仅支持Windows被控设备，macOS被控端支持版本后续更新；
5. 远程协助平台限制：assist协助管理命令当前仅macOS本机可用，Windows本机协助CLI能力后续迭代上线；
6. 码率参数延迟生效：-b画质码率限制参数仅在下一次新建远程连接时生效，极端高低画质组合可能存在性能损耗，建议搭配合理码率使用。

六、高频常见问题FAQ

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

A：报错代表UU远程客户端未启动，先打开软件并登录账号，保持窗口后台运行后再执行指令。

Q2：终端提示找不到uuyc-cli命令？

A：当前终端工作目录不在bin工具文件夹，先执行cd切换到 C:\Program Files\NetEase\GameViewer\bin 路径，再运行命令。

Q3：device connect能不能直接填写设备名称？

A：不可以，该指令仅识别设备ID字符串，需先用 uuyc-cli device list 查询对应ID后填入；term命令支持直接填写设备名。

Q4：不带ID执行disconnect会断开所有连接吗？

A：会一次性断开当前全部远程桌面与云电脑连接；云电脑断开后默认后台挂机持续计费，如需关机请使用cloudpc shutdown指令。

Q5：Mac电脑是否支持这套CLI命令？

A：完全支持，Windows与Mac共用同一套命令语法，仅切换工具目录的文件路径存在差异，可查看Mac专属安装路径说明。

Q6：如何查看单条命令完整参数文档？

A：使用help指令调取，例如查看设备操作：uuyc-cli help device；远程终端帮助：uuyc-cli term --help。

七、CLI核心价值总结

1. 自动化全链路：完美适配批处理、Shell、AI工作流，实现定时远程、批量巡检、无人值守机房运维；
2. 轻量化低资源占用：纯终端运行，无需渲染图形桌面，低配服务器、轻薄本均可稳定调度；
3. 跨平台统一语法：Windows、macOS命令体系完全互通，运维人员无需两套操作逻辑；
4. 全功能覆盖：本地设备远控、云电脑调度、远程Shell终端、跨设备远程协助一站式覆盖；
5. 结构化输出友好：查询接口标准JSON返回，机器可读，适配程序自动解析、AI自主调用。

针对机房运维、自动化开发、AI工作流搭建、多设备批量管理的用户，UU远程CLI命令行能够彻底摆脱重复点击图形界面，大幅削减远程管控操作成本。