远程协助工具使用说明
当现场遇到需要技术支持人员直接上手的情况（远程装机、调试、疑难排障），可以使用「远程协助工具（Remote Assist Tool）」。它是一个独立的小程序：不随 vDisk 安装、不随 vDisk 启动，只在需要协助时由现场人员当面手动运行一次，用完即断，产品本身的行为不受任何影响。
与控制台里的「远程协助」不是一回事
控制台终端列表「桌面管理（Desktop Management）→ 远程协助」是管理员看屏并操作某台终端的功能，受终端访问模式限制（→ 如何修改访问模式）；AI 助手里的「开一条远程协助」指的也是这一种（→ 如何使用 AI 助手）。
本页说的是技术支持临时接入现场机器的独立工具，两者互不影响。
一、它是怎么连上的
1，现场机器运行工具后主动往外拨到中转服务器（Relay Server）。
2，认证通过后，中转服务器在技术支持方内网开出一批端口；技术支持访问这些端口，就等于访问现场这台机器上对应的服务。
3，客户侧不需要开放任何入站端口、不需要改防火墙、不需要公网 IP，只要这台机器自己能访问外网即可。
工具里已内置技术支持服务器的地址与证书指纹，只会连内置的那一台；即使有人在程序旁边放一份改过的配置文件，也无法把现场引到别的服务器上。
程序从哪里来
现场端程序由技术支持提供，产品安装包里不带。提供 Windows 与 Linux（含 ARM64、龙芯）版本。技术支持方更换服务器或重签证书后需要重新出包，因此请始终使用技术支持本次发给你的程序包；用旧包可能直接连不上（指纹不匹配会被主动中止，这是设计行为，不是故障）。
二、运行与填写
1，双击工具即自动打开浏览器，在网页操作界面里完成全部操作，不必接触命令行。该界面只在本机监听并带一次性随机口令，同一网络里的其他人打不开它。
2，无图形环境的服务器（例如纯字符界面的 Linux 服务器）仍可用命令行方式运行。
3，首次使用填一次表单；已注册过的机器再打开会直接进入状态页并自动开通，命令行方式下也会提示「检测到本机已注册，正在自动开通」。
现场需要填的只有这几项：
| 填写项 | 默认值 | 说明 |
|---|---|---|
| 单位名称 | 无 | 供技术支持一侧识别是哪个现场 |
| 本套 vDisk 服务器地址 | 无 | 本现场管理服务器的地址 |
| 控制台用户名 | admin | 与控制台密码配套，仅用于管理台自动登录 |
| 控制台密码 | 无 | 同上；仅用于自动登录，不写入日志 |
| 本机系统登录账号 | 无 | 这台电脑自己的系统账号，供技术支持远程登录时使用 |
协助账号不需要现场输入
接入中转服务器所用的账号与口令已在出厂时内置进程序，现场既不需要输入、也不必保管。「没有这个程序就连不上」这条保证不变。
三、开通后有哪些通道
不需要现场逐项勾选，开通的是一份固定清单：
| 通道 | 说明 |
|---|---|
| 管理台（免登录） | 技术支持打开地址即自动用你填的控制台用户名/密码登录，无需再输一遍 |
| 数据库 | 供技术支持排查数据层问题 |
| 远程桌面 | 用你填的系统登录账号登录这台电脑 |
| SSH | Linux 机器的命令行登录 |
| 文件共享 | 访问这台机器的共享目录 |
| 网页文件收发 | 见本页第五节 |
| 网页命令行 | 见本页第六节 |
连接成功后，服务器编号会以大号字样醒目显示并可一键复制，把它发给技术支持即可。编号与这台机器长期绑定：重启、重连、设为开机自启后自动重连，编号都不变；此前用过老版本的机器，第一次用新版时会自动补上并固定下来。
四、状态页：随时看得见、随时掐得断
状态页常驻显示：通道开启中 / 剩余时间 / 当前连接数 / 收发流量，并提供三个操作按钮：
设为开机自启（常驻）：见本页第七节，默认关闭。
重新注册：断开当前协助，并清掉本机记住的注册信息，回到空白表单。换单位、换服务器地址，或想抹掉本机保存的信息时用它。
结束协助：立即断开。
另外需要知道的几条：
- 临时模式是纯前台进程：不安装服务、不写自启、不后台常驻，关掉窗口即断。
- 技术支持方也可以随时踢断，断开原因会显示在现场屏幕上。
- 认证成败、会话起止、每条被转发连接的目标与流量，全过程都有审计流水。
五、时长是硬的
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 单次在线时长 | 2 小时 | 由服务端夹紧，现场端只能申请更短 |
| 时长硬上限 | 8 小时 | 无论怎么设置都不会超过 |
| 空闲自动断开 | 60 分钟 | 期间没有任何转发连接即自动断开 |
到点就断，不会自动续
到点后两侧同时强制断开，需要继续时必须重新开通一条新会话。因此请在开始前与技术支持约好时间；长时间的装机、调试建议使用第七节的常驻方式。具体时长上限可能按现场单独设定，以状态页上显示的剩余时间为准。
六、网页文件收发
技术支持在浏览器里就能浏览、下载、上传这台机器上的文件（取日志、发补丁一步到位）。它不在客户内网监听任何端口，只在已建立的协助通道内工作，且每次会话都会生成一次性随机访问口令。
- 只提供浏览、下载、上传，不提供删除。
- 默认可访问系统盘。需要更保守时，可在启动时使用「不开通文件收发」选项关闭该通道（同时会关掉网页命令行），请向技术支持说明。
七、网页命令行
Windows 上不用远程桌面也能执行命令，不依赖目标机开启 WinRM / SSH / SMB——工具本来就跑在这台机器上，直接就地执行。
| 项 | 说明 |
|---|---|
| 可用解释器 | Windows 下可选 CMD 或 PowerShell；Linux 下用 sh |
| 输出编码 | 统一按 UTF-8 回显，中文 Windows 上不再乱码 |
| 单条命令时限 | 最长 2 分钟自动中止，避免一条卡死的命令挂住终端 |
| 执行身份 | 临时开通＝现场登录用户；常驻服务＝系统身份 |
| 开关 | 随文件收发通道一并开启，用「不开通文件收发」选项可一并关闭 |
八、设为开机自启（常驻）
装机或跨多次重启的长时间调试，可以一键把工具设为开机自动运行：重启后自动重连，掉线也会自动恢复，在技术支持一侧的会话列表中会明确标注为「常驻服务」，不与临时会话混淆。仅使用系统自带机制（Windows 计划任务、Linux systemd），不额外安装组件。
常驻会把密码落到本机
此项默认关闭，需要管理员权限才能开启。开启后，为了让这台机器重启后还能自己连上，工具会把控制台密码与系统登录密码保存到本机受保护目录（仅系统与管理员可读）——这是常驻的必要代价。
协助结束后请点「取消开机自启」，该操作会彻底移除自启并一并抹除保存的信息。
不要同时跑两份
同一台机器请不要同时运行交互工具与常驻服务（正常只跑其一），否则可能出现短暂的服务器编号争用。
九、协助结束后的收尾
1，点「结束协助」或直接关闭窗口（临时模式关窗即断）。
2，不再需要常驻的机器，点「取消开机自启」。
3，这台机器不再交由技术支持长期看护时，点「重新注册」清掉本机记住的注册信息。
4，协助期间技术支持可见控制台密码与系统登录账号，请按贵单位的安全制度决定是否变更这两处密码。
十、常见问题
| 现象 | 原因与处理 |
|---|---|
| 双击后没有弹出网页界面 | 机器无图形环境或没有默认浏览器，改用命令行方式运行 |
| 同事在别的电脑上打不开这个网页界面 | 设计如此。界面只在本机监听、带一次性随机口令，只能在本机操作 |
| 提示连不上中转服务器 | 先确认这台机器能访问外网；再确认用的是技术支持本次发来的程序包（换服务器或重签证书后老包会被主动中止） |
| 打开工具后直接进了状态页，没让填表 | 这台机器此前已注册过，属正常。要回到空白表单请点「重新注册」 |
| 到点被断开 | 单次时长有硬上限，不会自动续，重新开通一条新会话即可 |
| 一段时间没人操作就断了 | 空闲 60 分钟无转发连接会自动断开 |
| 现场已关机/断网，技术支持那边还显示在线 | 会话意外掉线后最多约 90 秒才判定失联，稍等即可 |
| 需要连着好几天协助 | 使用「设为开机自启（常驻）」，用完记得取消 |
| 不希望对方能读写本机文件、执行命令 | 启动时使用「不开通文件收发」选项，文件收发与网页命令行会一并关闭 |
以实际拿到的版本为准
本工具由技术支持单独分发、迭代较快，界面文案与个别选项可能与本页描述略有出入，以实机界面为准；拿不准时直接询问对接的技术支持人员。