1、概述

CloudDesk 云桌面系统支持多种客户端访问，包括瘦客户机、专用客户端以及浏览器访问。如果设备上没有合适的客户端程序，可以选择通过浏览器访问云桌面。

为了支持浏览器访问云桌面，CloudDesk 云桌面系统需要安装 H5 RDP 组件。H5 RDP 组件可以独立安装在一台 Linux 主机上，也可以部署在 CloudDesk 管理系统内。对于高并发访问的场景，建议独立部署 H5 RDP 组件；如果用户只是偶尔访问，则可以在 CloudDesk 管理系统内部署 H5 RDP 组件。H5 RDP 的安装和配置，请参考相关手册。

2、管理员手册

2.1 配置H5 RDP客户端地址和链接有效时长

部署好 H5 RDP 组件后，需要在 CloudDesk 中配置 H5 RDP 的地址以及链接有效时长，具体位置参见下图中的 1、2 处。

如需从外网访问，需将 H5 RDP 的端口映射到防火墙的外网端口，并在此处填写外网的主机和端口地址。

CloudDesk 在用户通过浏览器打开桌面时，会生成一个链接。该链接具有一定的有效期，超过有效期后将无法打开。一般建议设置为 2 分钟。若希望链接长期有效，可将时长设置得较长一些。

如果用户希望通过 URL 链接的方式分享桌面，可将有效时长设置较长，例如 60 分钟。这样用户可直接将桌面的 URL 发送给其他用户，其他用户在 60 分钟内可通过浏览器直接打开桌面。

2.2 配置H5 RDP的密钥

CloudDesk 和 H5 RDP 组件之间通过非对称加密保护桌面连接信息（其中包含登录桌面的账号和密码）。CloudDesk 使用公钥加密连接信息，H5 RDP 组件使用私钥解密，然后连接到桌面。

配置密钥的原则是：密钥对在私钥使用的地方生成，私钥永远不离开 H5 RDP 组件所在的主机。

• 合并部署（H5 RDP 组件与 CloudDesk 在同一台主机）：在【系统】【H5 RDP】页面点击【安装】时自动生成密钥对，不需要手工处理；以后需要更换时，在「密钥」区点击【重新生成密钥】。
• 独立部署（H5 RDP 组件在单独的 Linux 主机）：安装 H5 RDP 组件时会在该主机上自动生成密钥对，并显示公钥和公钥指纹。在「密钥」区点击【粘贴网关公钥】，粘贴该公钥，然后核对页面上的公钥指纹与 H5 RDP 主机上显示的一致。

不要下载私钥，也不要通过 U 盘、邮件或聊天工具传递私钥。详细步骤参见《配置H5 RDP网关》。

2.3 配置用户默认H5连接

用户使用浏览器登录云桌面时，点击桌面图标默认会下载一个用于连接桌面虚拟机的 RDP 文件。若已配置 H5 RDP，可通过上下文菜单进入 H5 RDP 客户端，通过浏览器开启桌面。

如希望将 H5 RDP 设为默认打开方式，可在 CloudDesk 后台配置用户默认使用 H5 连接。配置方法如下：在【系统】→【系统设置】→【用户默认 H5 连接】中勾选相应选项。

2.4 控制H5 RDP Client的文件传输

用户使用 H5 RDP Client 连接桌面时，无法使用 USB 重定向，但可以使用文字的复制粘贴（见 3.6）和磁盘重定向（文件上传、下载，见 3.5）。H5 RDP Client 的磁盘重定向功能同样受【本地磁盘映射】选项控制。 若启用【本地磁盘映射】，云桌面用户可通过 H5 RDP Client 正常上传和下载文件；若禁止【本地磁盘映射】，用户将无法上传和下载文件。

文件传输需要同时满足以下条件：

• 桌面池启用了【本地磁盘映射】；
• 用户账号的重定向策略没有禁止磁盘映射；
• 连接中带有桌面所属的用户。用户自己登录时总是满足；管理员连接的是未分配用户的桌面时，不提供文件中转盘（见 2.5）。

上传的文件保存在 H5 RDP 组件所在主机上，每个用户一个目录（默认 /home/jieyun/deskpool/file/<用户名>/）。这些文件不会在会话断开后自动删除，请提醒用户用完后及时清理，管理员也应定期检查该目录占用的磁盘空间。

2.5 管理员后台启用H5 RDP Client

管理员在后台可通过 VNC Client 或 H5 RDP Client 访问桌面计算机。两者均通过浏览器方式连接桌面，区别在于 VNC Client 通过 VNC 协议连接到虚拟机的控制台，不经过虚拟机的网卡。这样即使虚拟机网卡故障或无法正常启动，仍可观察其屏幕。

管理员使用 H5 RDP Client 连接时，会通过 RDP 协议连接虚拟机的 IP 地址，并使用桌面池的默认账号登录桌面虚拟机。如果用户修改了默认账号密码，管理员将无法使用 H5 RDP Client 连接。

若用户已连接桌面虚拟机，管理员使用 H5 RDP Client 连接会导致用户的桌面会话被断开。反之，若管理员通过 H5 RDP Client 连接虚拟机，用户连接该桌面也会断开管理员的 RDP 会话。

管理员通过 H5 RDP Client 连接已分配给用户的桌面时，文件中转盘使用的是该桌面所属用户的目录，能看到该用户上传的文件；连接未分配用户的桌面时，不提供文件中转盘。

2.6 H5 RDP组件的安装和配置

H5 RDP 组件需运行在 RockyLinux 9.x 的 Linux 系统中。

• 合并部署：在 CloudDesk 后台【系统】【H5 RDP】页面，部署方式选择「本机网关」，点击【安装】。
• 独立部署：在 H5 RDP 主机上以 root 执行在线安装命令（参见《配置H5 RDP网关》，或向厂家、集成商获取），然后在 CloudDesk 后台选择「外部网关」，填写访问地址并粘贴网关公钥。

安装时会自动生成密钥对（见 2.2）和自签名 SSL 证书。H5 RDP 主机上提供管理工具 h5rdpctl，可以查看状态、更换密钥和证书、启停服务和诊断故障。

默认的自签名证书会使浏览器出现 SSL 安全性提示（见 3.2）。如需消除提示，可以为 H5 RDP 的访问域名申请正式的 SSL 证书，用 h5rdpctl cert import 导入，方法参见《KB0042.H5 WebClient配置SSL证书》。

3、桌面用户操作手册

3.1 浏览器选择

在 PC 上推荐使用以下浏览器：

Chrome 浏览器

Edge 浏览器

Firefox 浏览器

其他浏览器未经过充分测试，兼容性暂不确定。

iPhone 手机和 iPad 推荐使用 Chrome 浏览器。自带的 Safari 浏览器可能存在兼容性问题。

3.2 浏览器登陆云桌面

以 Edge 浏览器访问云桌面系统 192.168.1.43 为例，展示登录过程：

用户在浏览器中输入 CloudDesk 管理系统地址（例如 192.168.1.43），然后输入用户账号和密码。 登录后进入【用户桌面列表】页面，若只有一个桌面，系统会自动打开该桌面。

浏览器可能会显示 SSL 安全提示，此时选择【高级】按钮。

然后选择【继续访问 192.168.1.43（不安全）】。

浏览器页面将自动进入 Windows 桌面。

3.3 切换全屏模式和窗口模式

3.3.1 Edge浏览器进入全屏桌面

可选择全屏方式进入桌面，提供类似于本地桌面的体验。以 Edge 浏览器为例：

1、设置缩放比例 100%，进入全屏模式

首先返回云桌面【用户桌面列表】页面，在浏览器菜单中选择【缩放 100%】，然后点击【全屏】按钮，具体菜单位置参考下图中的 1、2、3 处。

浏览器进入全屏模式，并显示退出全屏的说明：按 ESC 键，或将鼠标移至屏幕底部，会显示浮动菜单。

2、点击桌面图标，以全屏模式登录桌面

点击桌面图标，浏览器将开启一个新页面，以全屏模式进入桌面。

3、鼠标移至顶部，通过浮动菜单退出全屏模式
退出全屏桌面的方法是将鼠标移至顶部，点击浮动菜单右侧的按钮，恢复到窗口模式。

4、如桌面不能全屏显示，可能是缩放比例不是 100% 引起
如果页面桌面没有全屏显示，通常是由于浏览器的缩放比例不是 100% 引起的。请将缩放比例设置为 100%，重新打开桌面。也可在页面菜单中刷新，使桌面以缩放后的比例全屏显示。

3.3.1 Chrome浏览器进入全屏桌面

操作方法参考 Edge 浏览器。

Chrome 浏览器在鼠标移至顶部时不会显示浮动菜单，只会显示一个退出全屏的按钮。使用 Chrome 浏览器全屏访问桌面时，必须将浏览器的缩放比例设置为 100%。

3.4 页面刷新和会话超时

从云桌面的【用户桌面列表】页面启动 H5 RDP Client 页面后，若刷新页面，H5 RDP 组件会验证链接的有效时间。默认有效时间为 2 分钟。

打开桌面后，若在 2 分钟内刷新页面，H5 RDP Client 会重新登录桌面；若超过 2 分钟后刷新页面，H5 RDP Client 会提示“URL 链接超时”。

此时，应关闭 H5 RDP Client 页面，返回【用户桌面列表】页面，重新打开 H5 RDP Client 页面。

如果【用户桌面列表】页面也已超时，请注销后重新登录。

3.5 文件下载和上传

使用 H5 RDP Client 访问 CloudDesk 时，若管理员启用了本地磁盘映射功能，用户可通过浏览器从云桌面下载文件，或上传文件到云桌面。

由于浏览器无法直接访问本地文件系统，本地磁盘映射功能通过中转方式实现。

3.5.1 功能介绍

在桌面池开启【本地磁盘映射功能】的情况下，使用 H5 RDP Client 登录桌面后，屏幕右下方会显示一个浮动图标。

点击该图标会显示一个设置页面，其中包括文件上传功能以及提示信息：可通过 Ctrl + Alt + Shift 显示或隐藏该图标。

在桌面上打开【我的电脑】，可以看到一个名为【ShareRDP 上的 Filesystem】的映射磁盘，该磁盘是文件上传和下载的中转站。其下有一个 Download 子目录。

注意 ：磁盘【ShareRDP 上的 Filesystem】只用于中转，不要在上面长期保存文件。上传到该磁盘的文件保存在 H5 RDP 服务器上，会话断开后不会自动删除，下次登录仍能看到。文件复制到云桌面的本地硬盘后，请从中转盘中删除。

3.5.2 从云桌面下载文件

将需要下载的文件复制到磁盘【ShareRDP上的Filesystem】的 Download 目录下，浏览器会自动下载该文件到本地。

3.5.3 上传文件到云桌面

点击浮动图标，打开上传界面（如无浮动图标，按 Ctrl + Alt + Shift 显示）。在界面中选择文件上传。

上传后，在【ShareRDP 上的 Filesystem】磁盘中可看到上传的文件，将其复制到云桌面的本地硬盘即可。

3.5.4 使用限制和注意事项

1、建议不要上传或下载超过 500MB 的文件。

2、空文件无法下载。

3、如为大量小文件，建议压缩打包后上传和下载。

4、在广域网环境下，传输文件会占用互联网出口带宽，影响用户的桌面体验。

5、中转盘上的文件不会自动删除，用完后请及时清理。

3.6 复制粘贴

H5 RDP Client 支持在本地电脑和云桌面之间复制粘贴文字（不支持图片和文件，文件请用 3.5 的方法传输）。

• 从云桌面复制到本地：在云桌面中复制文字后，文字会自动写入本地电脑的剪贴板，在本地程序中直接粘贴即可。
• 从本地复制到云桌面：在本地程序中复制文字，然后切换回 H5 RDP Client 的浏览器页面（页面重新获得焦点时同步），在云桌面中粘贴即可。

首次使用时，浏览器会询问是否允许该网站访问剪贴板，请选择【允许】。如果之前选择了拒绝，可以在浏览器地址栏左侧的网站设置中，把“剪贴板”改为允许，然后刷新页面。

推荐使用 Chrome 或 Edge 浏览器。其他浏览器对网页读取剪贴板的支持有限，可能无法从本地复制到云桌面。