本文汇总 AIuse 云电脑 MCP Server 当前版本开放的工具、参数风格和返回结构。 协议能力 当前 MCP Server 基于 MCP STDIO 通信，主要面向以下 MCP 能力： initialize notifications/initialized ping tools/list tools/call 通用参数 所有 AIuse 云电脑 MCP 工具都需要明确目标桌面编码。当前版本通过工具参数传入 desktopCode： plaintext { "desktopCode": "xxx" } 在 Qoder 等支持自然语言工具调用的客户端中，也可以在指令中说明： plaintext 在 desktopCodexxx 桌面，截取当前屏幕。 Computer Use 工具 工具名 用途 movemouse 移动鼠标到指定坐标 clickmouse 在指定坐标点击鼠标 dragmouse 从起点拖拽到终点 scroll 在指定位置滚动 presskey 按下键盘按键或组合键 typetext 输入文本 screenshot 截取当前桌面屏幕 getcursorposition 获取当前鼠标位置 FileSystem 工具 工具名 用途 createdirectory 创建目录 readfile 读取文本文件内容 writefile 写入文本文件内容 movefile 移动或重命名文件、目录 searchfiles 搜索文件 返回结构 当前 MCP Server 将工具调用结果以文本内容返回，结构如下： plaintext { "content": [ { "type": "text", "text": "The operation(movemouse) was successfully executed on the desktop code xxx,the result is ..." } ] } 如果业务调用失败，返回文本中会包含失败信息： plaintext { "content": [ { "type": "text", "text": "The operation(clickmouse) failed on the desktop code xxx,the error message is desktop is offline" } ] } 当前版本未承诺返回 structuredContent 或 isError 字段。调用方应以 MCP Client 展示的工具调用结果为准。

本文汇总 AIuse 云电脑 MCP Server 当前版本开放的工具、参数风格和返回结构。 协议能力 当前 MCP Server 基于 MCP STDIO 通信，主要面向以下 MCP 能力： initialize notifications/initialized ping tools/list tools/call 通用参数 所有 AIuse 云电脑 MCP 工具都需要明确目标桌面编码。当前版本通过工具参数传入 desktopCode： plaintext { "desktopCode": "xxx" } 在 Qoder 等支持自然语言工具调用的客户端中，也可以在指令中说明： plaintext 在 desktopCodexxx 桌面，截取当前屏幕。 Computer Use 工具 工具名 用途 movemouse 移动鼠标到指定坐标 clickmouse 在指定坐标点击鼠标 dragmouse 从起点拖拽到终点 scroll 在指定位置滚动 presskey 按下键盘按键或组合键 typetext 输入文本 screenshot 截取当前桌面屏幕 getcursorposition 获取当前鼠标位置 FileSystem 工具 工具名 用途 createdirectory 创建目录 readfile 读取文本文件内容 writefile 写入文本文件内容 movefile 移动或重命名文件、目录 searchfiles 搜索文件 返回结构 当前 MCP Server 将工具调用结果以文本内容返回，结构如下： plaintext { "content": [ { "type": "text", "text": "The operation(movemouse) was successfully executed on the desktop code xxx,the result is ..." } ] } 如果业务调用失败，返回文本中会包含失败信息： plaintext { "content": [ { "type": "text", "text": "The operation(clickmouse) failed on the desktop code xxx,the error message is desktop is offline" } ] } 当前版本未承诺返回 structuredContent 或 isError 字段。调用方应以 MCP Client 展示的工具调用结果为准。

在上架设置的页面中，管理员可以选择可见的对象范围（全部桌面或指定桌面）、上架时间（立即上架或指定时间）。

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx desktopOid 否 String 桌面ID desktopName 否 String 桌面名称 pageNum 否 Integer 页码，至少1，默认1 pageSize 否 Integer 每页数量，最大100，默认10

接口功能介绍 返回适合用于创建云电脑的镜像 接口约束 无 URI GET /v3/image/describe 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx osType 否 String 系统类型。枚举值范围：[Windows, Linux]，默认为Windows flavorType 否 String 规格类型。枚举值范围：[Common通用型, GpuGPU型, XcXC型]，默认为Common。 flavorSubtype 否 String 规格子类型。仅对资源包模式Linux通用型规格云电脑有意义。枚举值范围：[Desktop桌面版, Server服务器版]，默认为Desktop。 cpuArch 否 String CPU架构。仅对XC型规格有意义。枚举值范围：[arm, x86]，默认为arm。 billMode 否 String 计费方式。枚举值[ResBag资源包，Cycle包月计费，OnDemand按需计费]，默认为ResBag. processorType 否 String 处理器类型。仅对XC型规格有意义。默认为kp。取值范围： kp：鲲鹏。 hg：海光。 ft：飞腾。 zx：兆芯。 Intel：Intel。 graphicsCardType 否 String 显卡类型。仅对GPU型规格有意义。枚举值[Nvidia英伟达,AMDAMD,Intel英特尔,MOORE摩尔线程],默认全部 pageNum 否 Integer 页码，至少1，默认1 pageSize 否 Integer 每页数量，最大100，默认10

本节介绍云电脑支持对虚拟机创建备份策略，实现定时备份云电脑数据盘、系统盘的数据。 AI云电脑（政企版）支持对虚拟机创建备份策略，实现定时备份AI云电脑数据盘、系统盘的数据。 说明 1、备份策略仅支持资源包创建的桌面，不支持单实例创建的桌面。 2、备份功能按所选系统盘、数据盘容量的50%消耗存储包。 新建备份策略 1.进入“AI云电脑（政企版）”管理控制台； 2.点击“策略管理”，点击“备份策略管理”，进入“备份策略管理”页面； 3.填写策略名称； 4.根据备份需求备份内容“系统盘“、”数据盘”； 5.根据需求选择执行周期、备份时间、保留规则等配置。 6.点击“提交”，即完成备份策略的创建。 分配备份策略 1.进入“AI云电脑（政企版）”管理控制台； 2.点击“策略管理”，点击“备份策略管理”，进入“备份策略管理”页面； 3.选择需分配的备份策略所在行，点击“分配” 4.在“分配备份策略”窗口，选择需要执行备份策略的AI云电脑； 5.根据备份需求备份内容“系统盘“、”数据盘”； 6.根据需求选择执行周期、备份时间、保留规则等配置。 7.点击“确定”，即可以把备份策略分配到对应的AI云电脑。

本节介绍AIuse云电脑的功能说明。 功能简介 AIuse云电脑致力为AI构建任务执行平台，它依托天翼AI云电脑的强大算例，通过意图识别，模拟用户操作，自动完成任务的规划、决策与实施，助力AI的商业化落地 多场景覆盖：搭建可定制云端桌面环境，依托标准化接口实现传统桌面软件自动化调用与批量操作，适配政企办公，研发测试等多场景使用。 灵活接入：提供标准化工具链与弹性运行环境、支持WebSdk、MCP等主流接入方式，无缝对接各种AI agent，兼容轻量调用与专业部署方式。 高效运行：依托天翼云强大算力底座，实现算力弹性伸缩与并发场景高效运行，保障桌面操作、软件运行及数据处理的流畅性与可靠性。 安全防护：采用企业级沙箱防护方案，构建多层次安全体系，用过严格权限隔离防范各类安全风险，保障企业核心业务数据安全合规。 试用申请说明 使用指南 您可以为您的不同场景/不同项目创建不同的AccessKey，用于灵活的分权控制对应的云电脑来实现不同的任务。 创建AccessKey 1. 进入协同套件Aiuse云电脑功能专区； 2. 再专区卡片点击前往管理； 3. 在服务管理页面，点击创建AccessKey； 4. 在输入框中输入AccessKey名称等相关信息，点击确定。 注意 AccessKey为重要鉴权凭证，为了您的信息安全请妥善保管，切勿随意分享给他人。

本文主要介绍远程桌面连接Windows云主机报错:0x1104如何处理。 问题描述 使用MSTSC方式登录Windows Server 2008操作系统的云主机，系统报错：检测到一个协议错误（代码 0x1104）。 图 协议错误（代码 0x1104） 可能原因 服务端安全组3389端口未开启。 服务端防火墙关闭。 服务端3389端口被其他进程占用。 远程桌面会话主机配置不正确。 处理方法 步骤 1 检查安全组设置。 检查3389端口入方向是否开启，若已开启，执行步骤2。 步骤 2 检查防火墙是否关闭。 1.登录Windows云主机。 2.单击桌面左下角的Windows图标，选择“控制面板 > Windows防火墙”。 3.单击“启用或关闭Windows防火墙”。 查看并设置防火墙的具体状态：开启或关闭。 如果正常，请执行步骤3。 步骤 3 使用VNC方式登录云主机，查看端口信息。 1.进入cmd命令窗，并执行以下命令。 netstat ano findstr ：3389 图 检查3389端口 如上图所示，3389端口被占用，进程PID为4。 2.打开任务管理器，查看PID为4的进程为System系统进程。 3.通常IIS服务和SQL Server会以System进程运行，执行以下HTTP命令进一步查看。 netsh http show servicestate 图 查看系统进程 4.如果可以看到3389端口被HTTP协议使用，可以确定是被IIS服务占用。 5.在浏览器输入“ 6.修改IIS使用其他端口，重启IIS服务。 步骤 4 如果以上检查均没有问题，请执行步骤5，检查是否由于远程桌面会话主机配置导致。 步骤 5 检查远程桌面会话主机配置。 1.通过VNC登录云主机。 2.打开cmd运行窗口，并输入“gpedit.msc”。 3.单击“确定”，打开“本地组策略编辑器”。 4.选择“计算机配置 > 管理模板 > Windows组件”，查找并双击“远程桌面服务”。 图 远程桌面服务 5.选择“远程桌面会话主机 > 安全 > 远程（RDP）连接要求使用指定的安全层”。 图 远程（RDP）连接要求使用指定的安全层 6.选择“已启用”，并将“安全层”设置为“RDP”。 图 设置安全层 7.单击“确定”。 8.配置完成后，打开“cmd”命令窗。 9.执行以下命令，刷新组策略。 gpupdate 图 刷新组策略

错误码 说明 52060 指定桌面不属于当前用户 92006 桌面不在线 92100 通过 sessionId 找不到 session 92101 消息发送失败 92102 请求内容长度超过限制 92103 找不到消息记录 92104 功能未开放，请联系管理员 92105 功能未开放，请联系管理员

错误码 说明 52060 指定桌面不属于当前用户 92006 桌面不在线 92100 通过 sessionId 找不到 session 92101 消息发送失败 92102 请求内容长度超过限制 92103 找不到消息记录 92104 功能未开放，请联系管理员 92105 功能未开放，请联系管理员

本节介绍云电脑（政企版）创建子账号以及子账号邀请等操作。 创建子账号 当需要增加下级管理员协助进行用户管理、桌面管理等工作时，您可以创建子账号，并为子账号授予指定的角色。 创建子账号后，系统会自动发送邀请邮件到子账号的邮箱，子账号接受邀请后，可登录AI云电脑（政企版）管理控制台。 1.进入“AI云电脑（政企版）”控制台； 2.点击“组织管理”，选择“子账号管理”，进入“子账号管理”页面； 3.选择需要创建子账号的所在行，点击“创建子账号”，进入“创建子账号”页面； 4.填写“邮箱”和“描述”，完成子账号创建，系统会自动发送邀请邮件到子账号邮箱。 5.对已创建的子账号可以设置角色、编辑和删除操作。 说明 创建的子账号需在邀请邮件中接受邀请，才会生效成为企业管理的子账号。 子账号接受邀请 当管理员在AI云电脑控制台创建子账号后，子账号会收到邀请邮件，接受邀请后可以登录AI云电脑管理控制台。 1.打开子账号邀请邮件； 2.点击“接受邀请”。 子账号设置角色 当需要增加下级管理员协助进行用户管理、桌面管理等工作时，您可以为子账号授予指定的角色，获取对应的管理台菜单以及功能权限。权限设置请参考“角色”。 1.进入“AI云电脑（政企版）”控制台； 2.点击“组织管理”，选择“子账号管理”，进入“子账号管理”页面； 3.选择需要创建子账号的所在行，点击“设置角色”，进入“设置角色”页面； 4.子账号可选择多个角色进行授权，点击“确定”即完成设置。

本节介绍翼家云电脑的功能说明。 产品介绍 翼家AI云电脑推出一站式“1+N”家庭场景解决方案，满足家长办公、家庭管理，孩子学习，老人娱乐等家庭多样化场景。 注意 1. 翼家AI云电脑功能仅支持天翼AI云电脑客户端V2.5.10以上版本进行使用。 2. 翼家当前对天翼AI云电脑（公众版）开放，如政企版想体验翼家功能，请联系运维或通过邮件申请，邮件发送至：clouddesktop@chinatelecom.cn） 家庭管理 家长可通过手机号邀请成员（成员账号需拥有AI云电脑）或管理员加入家庭管理。组建家庭关系后，家长和管理员可对家庭成员AI云电脑查看学习、绿色管控、远程接入、解绑等操作。 家庭管理入口 电脑端： 1.登录天翼AI云电脑客户端； 2.前往“家庭管理入口”。 桌面列表“家庭管理”。 AI云电脑内“家庭管理”。 移动端： 1.登录天翼AI云电脑客户端； 2.前往“家庭管理入口”。 我“家庭管理”。 AI云电脑内“家庭管理”。

本节包含了图形加速型G1云主机的概述、规格。 概述 G1型弹性云主机基于NVIDIA GRID虚拟GPU技术，提供较为经济的图形加速能力。同时，G1型弹性云主机使用NVIDIA Tesla M60 GPU卡，能够支持DirectX、OpenGL，可以提供最大显存4GiB、分辨率为4096×2160的图形图像处理能力，适用于图形渲染要求较高的应用。 类型 CPU基频/睿频 CPU型号 ::: G1 2.6GHz/3.5GHz 英特尔® 至强® 处理器 E52690 v4 规格 表 G1型弹性云主机的规格 规格名称 vCPU 内存（GiB） 最大带宽/基准带宽 最大收发包能力 GPU 显存（GiB） 虚拟化类型 :::::::: g1.xlarge 4 8 中 中 1×M601Q 1 XEN g1.2xlarge 8 16 中 中 1×M602Q 2 XEN 说明 M60xQ使用GPU虚拟化能力，x为1/2，表示云主机使用GRID技术将M60 GPU虚拟为不同规格和型号的vGPU， x对应于vGPU的显存大小，Q表示该类型的vGPU主要适用于工作站和桌面场景。更多关于GRID虚拟GPU的介绍，请参见

时间节点 功能名称 功能描述 相关文档 2024.3.18 高可用AI云电脑 AI云电脑高可用功能可在AI云电脑出现不可预见的故障时，为用户提供持续可用的桌面服务，保障业务连续性。

本文向您介绍Windows云主机如何配置多用户登录(Windows 2012)。 操作场景 本文档指导您配置Windows云主机实现多用户登录，以Windows Server 2012标准版R2中文版操作系统的云主机为例。 说明 远程桌面授权仅支持120天，过期后将因缺失远程桌面授权服务器许可证而导致多用户登录无法使用，需激活远程桌面授权。 配置多用户登录后，如果出现多用户登录Windows主机时无法打开浏览器的问题，请参考 操作须知 请确保云主机带宽资源充足，避免由于多用户同时操作负载过高导致云主机卡顿或登录异常。 所在安全组入方向已开放云主机登录使用的端口，默认使用3389端口。 云主机已经绑定弹性公网IP。 配置多用户登录后，不同的用户登录云服务器操作互相之间无影响。 配置多用户登录后，如果出现多用户登录Windows主机时无法打开浏览器的问题，请参考多用户登录Windows主机时无法打开浏览器。 操作步骤 步骤一：安装桌面会话主机和远程桌面授权。 1. 登录弹性云主机。 2. 在操作系统界面， 打开“服务器管理器”，单击“添加角色和功能”。 3. 保持默认参数，单击“下一步”。 4. 左侧导航栏选择“安装类型”，选择“基于角色或基于功能的安装”，单击“下一步”。 5. 左侧导航栏选择“服务器选择”，选择“从服务器池中选择服务器”，单击“下一步”。 6. 左侧导航栏选择“服务器角色”，选择“远程桌面服务”，单击“下一步”。 7. 左侧导航栏选择“功能”，在此页面保持默认参数，单击两次“下一步”。 8. 左侧导航栏选择“角色服务”，在此界面依次选择“远程桌面会话主机”和“远程桌面授权”，在弹出的窗口单击“添加功能”，单击“下一步”。 9. 确认在云主机上安装的角色，单击“安装(I)”。 10. 安装完成后，重启云主机。 第二步：允许多用户远程连接云主机。 1. 在运行里输入 gpedit.msc，打开计算机本地组策略 2. 选择“计算机配置>管理模板>windows组件>远程桌面服务>远程桌面会话主机>连接”，并依次设置“允许用户通过使用远程桌面服务进行远程连接”、“限制连接数量”和“将远程桌面服务用户限制到单独的远程桌面” 3. 右键单击“编辑”，设置“允许用户通过使用远程桌面服务进行远程连接”设置为“已启用”。 4. 右键单击“编辑”，设置“限制连接数量”选择为已启用，可根据具体数量设置，这里示例将允许的RD最大连接数设置为999。 5. 右键单击“编辑”，“将远程桌面服务用户限制到单独的远程桌面”选择已启用，或者已禁用，请注意此处已启用和已禁用的区别。本示例勾选“已启用”。 说明 l 已启用：多个用户同时登录的多用户登录，不能单个用户多登录 例如：配置为已启用，用户A、用户B、用户C可以分别使用账号A、账号B、账号C同时登录云主机，但是不支持用户A、用户B、用户C使用同一个账号同时登录云主机 l 已禁用：单个用户同时多个登录的多用户登录 例如：配置为已禁用，用户A、用户B、用户C可以使用同一个账号同时登录云主机 6. 运行cmd，输入 gpupdate /force，强制执行本地组策略，重启服务器，整个配置过程完成。 第三步：配置新用户并加入远程桌面用户组。 1. 在运行中输入 lusrmgr.msc，打开本地用户和组，进行新用户创建。 2. 单击“用户”，在空白处右键选择新用户。 3. 填写新用户信息，单击“创建”。 4. 单击“组”，双击打开Remote Desktop Users组，单击“添加”。 5. 进入选择用户界面，单击“高级”。 6. 在新的选择用户界面，单击“立即查找”，在下方搜索结果中选中需要远程登录的用户，并单击“确定”，完成添加，即可远程登录。 7. 单击“确定”，添加用户到Remote Dsektop Users组。

本文介绍如何挂载CIFS文件系统到Windows云主机。 操作场景 CIFS类型的文件系统仅支持使用Windows操作系统的云主机进行挂载。本此以Windows Sever 2012标准版操作系统为例进行CIFS类型的文件系统的挂载。其他版本请参考以下主要步骤，根据实际界面进行配置。 注意事项 不推荐CIFS协议的文件系统挂载至Linux，因为Linux系统对CIFS协议的兼容程度较低，并且Linux上的CIFS客户端存在一些安全漏洞隐患。因此本产品仅提供Windows 挂载CIFS的方式。 如果仍然期望采用CIFS协议的文件系统挂载至Linux的方式，请提交工单联系技术人员进行相关评估和配置。同时请务必知晓上述风险，若采用此种挂载方式，本服务不承诺SLA。 前提条件 在需要操作的地域创建虚拟私有云VPC，具体操作步骤参见创建虚拟私有云VPC。 已创建该VPC下的弹性云主机，操作系统为Windows Sever 2012标准版，具体操作步骤参见创建弹性云主机。 已创建该VPC下的文件系统，文件系统的协议类型为CIFS，具体操作步骤参见创建文件系统。 操作步骤 1. 登录天翼云控制中心，单击管理控制台左上角的，选择地域。 2. 选择“计算>弹性云主机”，进入弹性云主机页面，找到即将执行挂载操作的云主机所在行。 3. 点击“远程登录”，使用管理控制台提供的VNC方式远程登录Windows弹性云主机。 4. 对于Windows Server 2016以上的系统，需要配置允许客户端匿名访问，在命令行工具执行以下命令。 plaintext REG ADD HKEYLOCALMACHINESYSTEMCurrentControlSetservicesLanmanWorkstationParameters /f /v AllowInsecureGuestAuth /t REGDWORD /d 1 5. 单击桌面左下角Windows按键，选择这台电脑，右键单击“这台电脑>映射网络驱动器”。 6. 在弹出窗口中，设置“驱动器”盘符名称及文件夹（即在文件系统中看到的挂载目录），文件夹及为文件系统的挂载地址，可在文件系统的详情页获取，如下图。勾选“登录时重新连接”可在云主机重启后自动挂载文件系统。设置完毕后单击完成。 地域资源池挂载地址获取： 可用区资源池挂载地址获取： 7. 单击桌面左下角Windows按键，单击“这台电脑”，在网络位置处将出现已挂载的文件系统，此时您可以像使用一般的文件系统一样进行创建、修改删除文件，构造自己的文件系统。

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx floatingIpAddress 否 String 弹性IP地址 desktopOid 否 String 已绑定的桌面ID ipAddr 否 String 已绑定的桌面的IP地址 bandName 否 String 带宽名称 resourcePackName 否 String 资源包名称 pageNum 否 Integer 页码，至少1，默认1 pageSize 否 Integer 每页数量，最大100，默认10

本文主要介绍怎样查询Linux弹性云主机磁盘分区与磁盘设备的对应关系? 对于Linux弹性云主机，磁盘分区与磁盘设备名称完全对应。本节以Red Hat Enterprise Linux 7的图形界面为例，介绍查询Linux弹性云主机磁盘分区与磁盘设备的方法。 1.以root权限登录Red Hat Enterprise Linux 7弹性云主机。 2.在桌面空白处右键打开一个终端会话。 图 open terminal 3.执行以下命令，查询磁盘分区和磁盘设备。 fdisk l 图 查询磁盘分区和磁盘设备 对于Linux弹性云主机，查询到的磁盘分区与实际使用的磁盘设备名称完全对应，如下表所示。 表 磁盘分区和磁盘设备的映射关系 磁盘分区 磁盘设备 xvda xvda xvdb xvdb xvdc xvdc xvdd xvdd xvde xvde xvdf xvdf xvdg xvdg xvdh xvdh xvdi xvdi xvdj xvdj xvdk xvdk xvdl xvdl xvdm xvdm xvdn xvdn xvdo xvdo xvdp xvdp xvdq xvdq xvdr xvdr xvds xvds xvdt xvdt xvdu xvdu xvdv xvdv xvdw xvdw xvdx xvdx

本文介绍 SDK 接入时常见的高级配置项和工程化建议,适用于需要在生产环境中稳定调用 AIuse 云电脑能力的场景。 服务地址配置 创建 Client 时可通过 serviceURL 指定服务地址： plaintext const client new Client({ apiKey: process.env.AIUSEAPIKEY, apiSecret: process.env.AIUSEAPISECRET, desktopCode: process.env.AIUSEDESKTOPCODE, serviceURL: ' }); 如未显式配置服务地址，SDK 将使用默认地址。默认地址以 SDK 实际发布版本为准。 环境变量配置 生产环境建议使用环境变量或密钥管理系统保存敏感配置： 环境变量 说明 AIUSEAPIKEY AccessKey ID AIUSEAPISECRET AccessKey Secret AIUSEDESKTOPCODE 桌面编码 AIUSESERVICEURL 服务地址 示例： plaintext const client new Client({ apiKey: process.env.AIUSEAPIKEY!, apiSecret: process.env.AIUSEAPISECRET!, desktopCode: process.env.AIUSEDESKTOPCODE!, serviceURL: process.env.AIUSESERVICEURL }); 超时与重试 GUI 操作依赖目标桌面状态、应用响应速度和网络情况。建议在业务侧为关键步骤设置超时和重试策略。 推荐策略： 对创建会话、截图、文件读取等关键操作设置超时。 对临时网络异常可进行有限次数重试。 对具有副作用的操作，如点击提交按钮、删除文件、覆盖写入文件，应谨慎重试。 重试前应尽量通过截图或状态检查确认当前界面状态。 日志记录 建议记录以下信息： 任务 ID。 AccessKey 名称或脱敏后的 AccessKey ID。 桌面编码。 会话 ID。 关键操作名称和调用结果。 错误码和错误信息。 不建议记录完整 AccessKey Secret、文件正文、敏感业务数据或完整截图地址。

本文介绍 SDK 接入时常见的高级配置项和工程化建议,适用于需要在生产环境中稳定调用 AIuse 云电脑能力的场景。 服务地址配置 创建 Client 时可通过 serviceURL 指定服务地址： plaintext const client new Client({ apiKey: process.env.AIUSEAPIKEY, apiSecret: process.env.AIUSEAPISECRET, desktopCode: process.env.AIUSEDESKTOPCODE, serviceURL: ' }); 如未显式配置服务地址，SDK 将使用默认地址。默认地址以 SDK 实际发布版本为准。 环境变量配置 生产环境建议使用环境变量或密钥管理系统保存敏感配置： 环境变量 说明 AIUSEAPIKEY AccessKey ID AIUSEAPISECRET AccessKey Secret AIUSEDESKTOPCODE 桌面编码 AIUSESERVICEURL 服务地址 示例： plaintext const client new Client({ apiKey: process.env.AIUSEAPIKEY!, apiSecret: process.env.AIUSEAPISECRET!, desktopCode: process.env.AIUSEDESKTOPCODE!, serviceURL: process.env.AIUSESERVICEURL }); 超时与重试 GUI 操作依赖目标桌面状态、应用响应速度和网络情况。建议在业务侧为关键步骤设置超时和重试策略。 推荐策略： 对创建会话、截图、文件读取等关键操作设置超时。 对临时网络异常可进行有限次数重试。 对具有副作用的操作，如点击提交按钮、删除文件、覆盖写入文件，应谨慎重试。 重试前应尽量通过截图或状态检查确认当前界面状态。 日志记录 建议记录以下信息： 任务 ID。 AccessKey 名称或脱敏后的 AccessKey ID。 桌面编码。 会话 ID。 关键操作名称和调用结果。 错误码和错误信息。 不建议记录完整 AccessKey Secret、文件正文、敏感业务数据或完整截图地址。

本节介绍翼甲卫士的产品规格。 使用方式&范围 按VPC维度开通翼甲卫士，绑定带宽/专线后对其下所有AI云电脑生效防护，并支持针对不同AI云电脑集群搭配不同策略组合。 支持的操作系统 服务桌面：Centos Server 7, UOS Server v20(arm/x86)。 用户桌面：Windows：Windows Server 2008/2016/2019， Windows 7/10。Linux：UOS v20，麒麟v10。 数据安全 审计数据存储于防火墙虚机内部，保障数据不出租户。 功能规格 功能 描述 标准版 增强版 访问控制 基于安全策略进行访问控制，支持ACL过滤、DNAT、SNAT、旁路规则 支持 支持 VPN隧道 搭建VPN加密通道，实现本地网络与VPC之间的网络互通 支持 支持 病毒防护 探测各种病毒威胁并拦截 支持 支持 入侵防御 实时监控多种网络攻击并根据配置对网络攻击进行阻断等操作 支持 支持 网站访问管理 基于预设或自定义网站库对用户访问网站行为进行审计管控 不支持 支持 短信告警 支持自定义配置告警通知，可配置通知频率、多个管理员接收通知等 支持 支持 日志规格 高IO 高IO/超高IO 日志监控 支持各类防护、管控事件的审计 支持 支持

本文介绍如何卸载文件系统。 操作场景 当不在需要使用文件系统时，可以进行卸载。 准备工作 弹性云主机已挂载文件系统。 卸载文件系统前建议先终止进程和停止读写再卸载。 Linux系统卸载步骤 1. 登录天翼云控制中心，在左上角的选择地域。 2. 选择“计算>弹性云主机”，进入弹性云主机页面，找到即将执行挂载操作的云主机。 3. 以root用户登录弹性云主机。执行如下命令，卸载文件系统。 umount 本地路径 本地路径：云服务器用于挂载文件系统的本地路径，例如"/mnt/sfs"。 Windows系统卸载步骤 1. 登录天翼云控制中心，在左上角的选择地域。 2. 选择“计算>弹性云主机”，进入弹性云主机页面，找到即将执行挂载操作的云主机。 3. 点击“远程登录”，使用管理控制台提供的VNC方式远程登录Windows弹性云主机。 4. 单击桌面左下角Windows按键，单击“这台电脑”，在“网络位置”处，右键单击要卸载的文件系统，选择“断开”。 5. 若网络位置下已挂载的文件系统已不存在即表示卸载成功。

本节介绍AccessKey的管理操作说明。 AccessKey 是调用 AIuse 云电脑 SDK 和 MCP 能力的身份凭证。调用方需要使用 AccessKey ID、AccessKey Secret 和桌面编码建立连接，并在授权范围内操作云电脑。 创建 AccessKey 操作步骤如下： 1. 登录 AIuse 云电脑控制台。 2. 进入“协同套件 AIuse 云电脑”功能专区。 3. 在服务管理页面单击“创建 AccessKey”。 4. 输入 AccessKey 名称等信息。 5. 确认创建。 创建完成后，请妥善保存 AccessKey ID 和 AccessKey Secret。AccessKey Secret 属于敏感凭证，不应通过截图、聊天工具、工单附件或公开仓库传播。 命名建议 建议 AccessKey 名称包含业务含义，便于后续管理和排查。 名称示例 说明 demodevkey 演示环境使用 projectatestkey 项目 A 测试环境使用 financebatchprodkey 财务批处理生产任务使用 关联云电脑 AccessKey 创建后，需要关联指定云电脑才可使用。 操作步骤如下： 1. 在服务管理页面找到目标 AccessKey。 2. 单击“关联云电脑”。 3. 在弹窗中搜索并选择需要绑定的云电脑。 4. 单击确认，完成绑定。 AccessKey 只能操作已关联的云电脑。若调用时返回“指定桌面不属于当前用户”或类似错误，请优先检查 AccessKey 与云电脑的关联关系。 查看与复制密钥 在 AccessKey 列表中，可以查看 AccessKey ID、AccessKey Secret 和关联云电脑数量。复制密钥时，请确认当前环境安全，避免在录屏、投屏或共享屏幕场景下展示 Secret。

操作场景 本节将以使用"Microsoft Remote Desktop for Mac"工具远程连接到运行"Windows Server 2012 R2 数据中心版 64位"操作系统的云主机为例，介绍如何在Mac OS系统上登录Windows云主机的操作步骤。 前提条件 Windows云主机处于“运行中”状态。 已获得Windows云主机的用户名和密码。如果忘记密码，须重置云主机密码，请参考在控制台重置弹性云主机密码。 Windows云主机所在安全组的入方向已开放3389端口。 Windows防火墙未开启或开启后放通3389端口。 登录工具与Windows云主机具有网络连通性。如果使用处于公网中的终端登录，需要您的Windows云主机已绑定弹性IP。如果通过内网使用此方式登录，则不需要绑定弹性IP，例如VPN、云专线等内网网络连通场景。 Windows云主机已开启远程桌面协议RDP。 已在Mac OS系统上安装了Microsoft Remote Desktop for Mac或其他适用于Mac OS系统的远程连接工具。您可以下载Microsoft Remote Desktop for Mac。 注意 请注意，微软官方已停止提供Remote Desktop客户端的下载链接，您可以尝试下载 操作步骤 1. 启动Microsoft Remote Desktop应用。 2. 点击"Add Desktop"（添加桌面）。 3. 在"Add PC"（添加计算机）页面，进行登录信息的设置。 PC name（计算机名称）：输入要登录的Windows实例的弹性IP地址。 User account（用户账户）：从下拉列表中选择"Add user account"（添加用户账户），然后弹出"Add user account"对话框。 在"Add user account"对话框中，输入Windows实例的用户名（例如"administrator"）和登录密码，然后点击"Add"（添加）。 4. 在"Remote Desktop"页面，双击要登录的Windows实例的图标。 5. 确认信息后，点击"Continue"（继续）。

本节介绍了使用控制面板卸载不需要的程序的最佳实践。 操作场景 本章节指导用户通过控制面板卸载不需要的程序。 本文以操作系统为“Windows Server 2016 Standard 64bit”的云主机为例。不同操作系统的云主机清理步骤可能不同，本文仅供参考，具体操作步骤和差异请参考对应操作系统的产品文档。 操作步骤 1.在云主机桌面，单击左下方开始图标。弹出常用程序窗口。 2.在左侧导航栏中，选择“Windows系统 > 控制面板”。弹出“所有控制面板项”窗口。 图 所有控制面板项 3.在导航列表中，选择“程序和功能”。进入“程序和功能”窗口。 图 程序和功能 4.在程序列表中，单击待卸载的程序，并右键单击“卸载”。弹出确认卸载对话框。 图 卸载对话框 5.单击“是”，开始卸载程序，释放磁盘空间。

本节介绍翼加密的管理员脱密工具下载以及使用的说明。 下载管理员脱密工具 管理员登录AI云电脑控制台，在文件加密模块的任意列表页面（密级管理、加密策略管理、加密桌面管理、脱密审计）右上角，点击“管理员脱密工具”进行下载。 使用管理员脱密工具 管理员脱密工具的脱密权限，与运行工具的AI云电脑的密级权限相关。 例如，将脱密工具安装到一个密级等级为3级的用户的加密AI云电脑内，则可以使用工具脱密密级等级为3级和3级以下的加密文件。 反之，如果将脱密工具安装到一个未加密的桌面，则无法脱密任何加密文件。 备注：建议管理员尽量在一个密级等级最高的用户的加密AI云电脑内，安装及使用此工具进行文件脱密。 使用工具脱密文件的步骤： 1.安装并运行“管理员脱密工具”； 2.添加需要脱密的文件，可点击“选取文件”添加；也可以直接拖入页面添加。单次添加的脱密文件个数和大小不做限制； 3.点击“选择目标路径”选择文件脱密后保存的路径； 4.点击“确认脱密”提交脱密操作。在执行脱密前，需要输入脱密UKey。脱密UKey在控制台文件加密模块的任意列表页面（密级管理、加密策略管理、加密桌面管理、脱密审计）右上角，点击“管理员脱密工具”即可看到； 注意：脱密UKey是一个随机生成的6位数密码。并且每1分钟会刷新重置。只有在脱密UKey刷新重置前及时输入才能完成脱密。 5.脱密完成后，弹窗结果弹窗。点击“前往所在位置”则打开脱密文件保存的目标路径。脱密文件在下一次编辑保存之前，将保持脱密状态，可直接明文外发。

使用模式 四步快速实现“黑猴”最佳游戏体验。 1、用户在天翼云官网或者通过客户经理开通天翼云云电竞服务； 2、本地安装云电竞客户端，打开客户端，根据本地网络带宽情况选择合适的分辨率配置； 3、登录界面通过开通账号及云电竞激活码进行登录，进入电竞桌面； 4、打开预安装的“黑猴”游戏，登录自己的游戏账号进行畅快体验。 使用效果 目前天翼云云电竞游戏环境最优可以支持到2k分辨率下的全景光追效果，画面达到80帧上下，完美体验“黑猴”这款3A大作的魅力。

退出登录 如需退出AI云电脑登录账号，在桌面列表右上角，点击“退出登录”或点击“三”展开更多菜单，点击“退出登录”。 二次确认即可退出登录账号

本节介绍云电脑高可用的产品简介，以便您了解云电脑高可用。 AI云电脑高可用功能可在AI云电脑出现不可预见的故障时，为用户提供持续可用的桌面服务，保障业务连续性。 跨资源池灾备 AI云电脑所在资源池出现异常故障时，可自动切换使用备资源池的灾备AI云电脑。 业务连续性 提供一致的AI云电脑的服务，用户可持续开展业务工作。

本文向您介绍如何配置多用户登录Windows云主机。 操作场景 本文档将指导您配置多用户登录的Windows云主机，以Windows Server 2008标准版R2中文版为例。 说明 远程桌面授权仅支持120天，过期后将因为缺失远程桌面授权服务器许可证而导致多用户登录无法使用，需要重新激活。 配置多用户登录后，如果出现多用户登录Windows主机时无法打开浏览器的问题，解决方法请参考 操作步骤 1. 安装桌面会话主机和远程桌面授权。 (1) 登录Windows云主机。 (2) 在操作系统界面，打开“服务器管理器”，单击“角色>操作>添加角色”。 (3) 跳转至左侧导航栏为“服务器角色”，选择“远程桌面服务”，单击“下一步”。 (4) 保持默认参数，单击“下一步”。 (5) 跳转至左侧导航栏为“角色服务”，依次勾选“远程桌面会话主机”和“远程桌面授权”，单击“下一步”。 (6) 保持默认参数，单击“下一步”。 (7) 跳转至左侧导航栏为“身份验证方法”，指定远程桌面会话主机的身份验证方法，单击“下一步”。本示例选择的是“需要使用网络级别身份验证”，之后单击“下一步”。 (8) 跳转至左侧导航栏为“授权模式”，指定授权模式。本示例选择“以后配置”，之后单击“下一步”。 (9) 跳转至左侧导航栏为“用户组”，选择允许访问此RD会话主机服务器的用户组，单击“下一步”。 (10) 跳转至左侧导航栏为“客户端体验”。本示例选择的是“音频和视频播放”，之后单击“下一步”。 (11) 跳转至左侧导航栏为“RD授权配置”，为RD授权配置搜索范围，配置完成后单击“下一步”。 (12) 单击“安装(I)”。 2. 允许多用户远程连接云主机。 (1) 在运行里输入 gpedit.msc，打开计算机本地组策略。 (2) 选择“计算机配置>管理模板>windows组件>远程桌面服务>远程桌面会话主机>连接”。设置“允许用户通过使用远程桌面服务进行远程连接”、“限制连接数量”和“将远程桌面服务用户限制到单独的远程桌面”。 (3) 选中“允许用户使用远程桌面服务进行远程连接”，右键单击“编辑”，将其设置为已启用。 (4) 选中“限制连接数量”，右键单击“编辑”，选择已启用，可根据具体数量设置，本示例设置允许的RD最大连接数为999。 (5) 选中“将远程桌面服务用户限制到单独的远程桌面服务会话”，右键单击“编辑”，选择已启用，或者已禁用。本示例以勾选“已启用”为例。 说明 请注意此处已启用和已禁用的区别： l 已启用：允许多个用户同时登录，不能单个用户同时多人登录。 例如：配置为已启用，用户A、用户B、用户C可以分别使用账号A、账号B、账号C同时登录云主机，但是用户A、用户B、用户C无法使用同一账号同时登录云主机。 l 已禁用：允许单个用户同时多人登录。 例如：配置为已禁用，用户A、用户B、用户C可以使用同一个账号同时登录云主机。 (6) 运行cmd，输入 gpupdate /force，强制执行本地组策略，重启服务器，整个配置过程完成。 3. 配置新用户并加入远程桌面用户组。 (1) 在运行中输入 lusrmgr.msc，打开本地用户和组，进行新用户创建。 (2) 单击“用户”，在空白处右键选择新用户。 (3) 填写新用户信息，单击“创建”。 (4) 单击“组”，双击打开Remote Desktop Users 单击“添加”。 (5) 进入选择用户界面，单击“高级”。 (6) 在新的选择用户界面，单击“立即查找”，在下方搜索结果中选中需要远程登录的用户，并单击“确定”，完成添加，即可远程登录。 (7) 单击“确定”，添加用户Remote Desktop Users组。

云电脑使用过程中提示“连接已断开，正在为您重连，请稍等”，怎么解决？ 请您按以下步骤检测终端及网络等情况： 1. 点击工具栏的网络检测，如果检测提示您的网络可能存在丢包等情况，请尝试更换网络后使用。 2. 如您的云电脑客户端不是最新版本，请更新到最新版客户端后尝试。 3. 如果您是使用瘦终端或一体机等设备，建议尝试更换移动端或PC端等设备使用观察，如更换设备后正常，则建议您联系厂家或查看您所使用的终端是否为适配终端。 如以上问题未解决，可在工具栏点击“报障”功能，填写故障信息或者拨打服务热线：4008109889。 6.为什么客户已开通了专线，天翼AI云电脑还需开通云侧带宽才能上网？ 专线是连接客户本地侧与云侧资源的通道，天翼AI云电脑（政企版）是在云端为客户开通的计算、存储资源，与互联网是相互隔离的，所以仍需开通云侧带宽，开通后进行vpc设置，分配到桌面关联的子网，才能实现天翼AI云电脑（政企版）向互联网的访问。

Windows云主机无法访问外网怎么办？ 当Windows云主机状态正常，但是无法访问外网时，我们可以通过以下步骤进行排查： 1. 查看云主机是否负载过高 可以通过云监控查看云主机负载情况，您可以创建告警任务，当CPU或带宽利用率高时，系统会自动发送告警给您。 如果确定云主机负载过高，可以使用进程管理查找负载过大的进程，终止过高负载的进程，再尝试进行访问外网。 2. 查看云主机的安全组设置 检查弹性云主机安全组是否有配置错误，安全组出方向规则为允许，放行出方向网络流量。 3. 查看VPC的网络ACL设置 查看云主机对应的子网是否关联了网络ACL。单击子网名称查看网络ACL的信息。点击ACL名称，进入修改ACL规则，或者将子网内的ACL删除。 4. 检查云主机的防火墙设置 查看并禁用Windows弹性云主机防火墙策略，禁用后检查是否可以连通网络。 登录Windows弹性云主机。单击桌面左下角的开始图标，选择“控制面板 > 系统和安全 > Windows防火墙”。 单击“检查防火墙状态 > 关闭Windows防火墙”。 再次尝试访问公网。 5. 使用Ping命令检查网关通信是否正常 使用ping命令检查云主机与网关通信是否正常。如果可以ping通就是其他原因，无法ping通需查看DNS设置情况。 如果上述排查都没能成功访问公网，请提交工单，联系技术支持人员帮助解决。