UU远程终端怎么用？远程执行命令与会话重接教程

「终端」支持在同账号远控中直接操作 Windows 或 macOS 被控端的命令行，适合远程执行命令、部署程序、查看日志和排查问题。同一被控设备可以有多个终端会话；关闭主控端终端窗口或退出终端页面不会自动终止会话，之后可以重新接入。

适用设备与版本

终端功能仅支持同账号远控。建议主控端和被控端都更新到最新版本。

项目	支持情况
适用场景	同账号远控
主控端	Windows、macOS、Android、iOS
被控端	Windows、macOS
推荐版本	主控端和被控端均为 V4.39.0 及以上

这个功能适合什么场景

• 远程执行命令、部署程序或查看日志。
• 长任务运行中暂时离开终端页面，之后重新接入同一个会话。
• 使用手机远控电脑时，通过系统输入法、语音输入或触控操作 TUI 工具。

使用方法

1. 进入终端

在主控端打开 UU远程，连接同账号下的目标设备，进入[设备详情]-[终端]。以下以移动端为例，PC 端同样从[设备详情]-[终端]进入，仅界面布局有所不同。

如果被控端处于锁屏状态，进入[终端]前需要完成一次系统账户验证。该验证只用于确认账户身份，不会解锁被控端屏幕。

• 已开启[自动解锁被控端]：系统会自动使用已记录的系统账户密码完成验证。
• 未开启[自动解锁被控端]：按页面提示输入被控端的系统账户密码，验证通过后即可进入[终端]。

被控端	验证方式
Windows	支持自动验证，但仅在 macOS、iOS 或 Android 主控端发起时生效；Windows 主控端发起时，需要在终端页面手动输入系统账户密码。
macOS（已登录但锁屏）	需要在终端页面手动输入系统账户密码，验证不会解锁屏幕。
macOS（未登录）	无法在终端页面完成登录，请先通过远程控制画面完成 macOS 账户登录，再重新进入[终端]。

2. 选择或创建会话

如果已有终端会话，选择要接入的会话；如果没有会话，系统会自动创建。需要同时处理多个任务时，点击[新建会话]创建其他会话。PC 端可从会话列表或终端窗口切换会话，移动端需返回会话列表后再选择其他会话。

3. 输入命令和操作 TUI

进入会话后，在终端中输入命令并按 Enter 发送，输出区域会实时显示被控端的执行结果。

Windows 被控端默认使用 PowerShell。如果你习惯使用 cmd，部分命令语法可能无法直接执行；可以改用 PowerShell 语法，或在被控设备本机新建 cmd.exe 会话后再接入。

移动端使用「终端」时，点击终端页面唤起输入框，即可使用系统输入法进行整段输入、编辑或语音输入；也可以直接使用电脑全键盘输入命令。对于带 TUI 界面的工具，可直接点击终端页面操作，例如切换会话或切换 Agent。

4. 退出和重新接入

关闭主控端终端窗口或退出终端页面时，只会断开当前主控端连接，不会终止被控端会话。再次进入[终端]后，选择原会话即可重新接入。若手动删除终端会话，或被控端程序重启、终端进程退出，原会话及历史输出无法恢复，只能重新创建。

被控端本机管理会话

在被控设备本机打开终端软件，可以使用 uuyc-cli lterm 管理由 UU远程创建的会话：

命令	作用
uuyc-cli lterm ls	查看会话列表
uuyc-cli lterm new <会话名>	创建会话
uuyc-cli lterm attach <会话名>	接入会话
uuyc-cli lterm kill <会话名>	终止会话
uuyc-cli lterm rename <旧名> <新名>	重命名会话

需要指定 Shell 时，使用以下命令创建会话：

uuyc-cli lterm new <会话名> --shell <Shell 路径>

例如，在 Windows 被控端本机创建 cmd.exe 会话：

uuyc-cli lterm new cmd会话 --shell C:\Windows\System32\cmd.exe

Windows 被控端通过主控端创建会话时，默认会打开对应的终端窗口；macOS 被控端不会自动打开窗口，如需在被控端本机继续使用，请执行：

uuyc-cli lterm attach <会话名>

常见问题

关闭终端窗口后，会话会结束吗？

不会。关闭主控端终端窗口或退出终端页面时，只会断开当前主控端的连接，会话会保留在被控端，再次进入[终端]后可以重新接入。只有手动删除终端会话，或在被控端执行 uuyc-cli lterm kill <会话名>，才会终止对应会话。

删除终端会话后，还能重新接入吗？

不能。手动删除终端会话后，对应会话会随之终止，之后无法重新接入，需要在被控端重新创建会话。关闭终端窗口或退出终端页面只是断开连接，不会删除会话。

终端会显示被控端已有的其他会话吗？

不会。「终端」只展示和管理由 UU远程创建的本地终端会话，不会扫描、展示或接管其他终端软件创建的会话。

Windows 被控端会自动打开终端窗口吗？

会。通过主控端创建会话时，Windows 被控端默认会打开对应的终端窗口。

macOS 被控端会自动打开终端窗口吗？

不会。请在 macOS 被控端本机打开终端软件，执行 uuyc-cli lterm attach <会话名> 接入会话。

旧版主控端可以连接新版被控端吗？

不可以。主控端和被控端都需要升级到 V4.39.0 及以上版本。

新版主控端连接旧版被控端怎么办？

请先按页面提示升级被控端，升级完成后重新进入[终端]。

指定 Shell 路径不可用怎么办？

请确认 --shell 后填写的是被控端真实存在的 Shell 路径，例如 /bin/bash。

为什么 Windows 终端中的命令执行无效？

Windows 被控端默认使用 PowerShell。如果输入的是 cmd 专用语法，可能无法直接执行。请改用 PowerShell 语法，例如执行当前目录下的程序时使用 .\uuyc-cli.exe；如果需要使用 cmd 命令行，请在被控设备本机执行 uuyc-cli lterm new cmd.exe会话 --shell C:\Windows\System32\cmd.exe 创建 cmd.exe 会话，再从会话列表接入并执行 Windows 命令。

被控端锁屏时，如何进入终端？

进入[终端]前需要完成一次系统账户验证。开启[自动解锁被控端]后，系统会自动验证；未开启时，按页面提示输入被控端系统账户密码。该验证只确认账户身份，不会解锁被控端屏幕。

macOS 被控端未登录时，如何进入终端？

请先通过远程控制画面完成 macOS 账户登录，再重新进入[终端]；未登录状态下无法直接在终端页面完成登录。

注意事项

• 终端功能仅支持同账号远控，远程协助暂不支持。
• 主控端和被控端都需要使用 V4.39.0 及以上版本；旧版主控端不支持连接新版被控端。
• 关闭终端窗口或退出页面不等于终止会话；会话会保留在被控端，可重新接入。
• 手动删除终端会话，或使用 uuyc-cli lterm kill <会话名> 终止后，会话无法重新接入。
• 关闭主控端终端窗口不会终止会话；被控端程序重启或终端进程退出后，原会话及历史输出无法恢复。
• uuyc-cli lterm 只管理由 UU远程创建的本地终端会话，不管理其他终端软件创建的会话。
• Linux 被控端和移动端作为被控端暂不支持此功能。