在 Windows Server RDS 上安装远程桌面 HTML5 Web 客户端

在部署了远程桌面服务的 Windows Server 2022/2019/2016 上，您可以安装和配置新的基于 HTML5 的远程桌面 Web 客户端。此 Web 客户端将允许任何设备（iOS、macOS、Android、Linux）直接从任何浏览器访问 RDS 主机上的 RemoteApp（无需安装额外的 RDP 客户端）。

远程桌面 Web 客户端可作为运行 Windows Server 2022/2019/2016 的 RDS 服务器上的 RD Web 访问角色功能。

在部署RD Web客户端之前，您需要确保您的RDS基础架构满足以下要求：

• 已部署的 RDS 场基础设施，包括 Windows Server 2022/2019/2016 上的远程桌面网关、RD 连接代理和 RD Web 访问；

• 使用每用户终端许可证 (RDS CAL)；

• RDS 网关和 Web 访问服务器必须使用受信任 CA 颁发的 SSL 证书。您可以在 RDS 上使用免费的 Let’s Encrypt 证书或自签名 SSL 证书（仅在有限模式下）。

在 Windows Server RDS 上安装 RD Web HTML5 客户端

Windows Server 发行版中不包含 HTML5 RD Web 客户端。您需要从 PowerShell 脚本库手动安装 RD Web 客户端管理模块。

在具有 RD Web 访问角色的服务器上安装 PowerShellGet 模块：

Install-Module -Name PowerShellGet -Force

重新启动 PowerShell.exe 控制台并安装 RD Web 客户端管理模块：

Install-Module -Name RDWebClientManagement

在断开连接的网络上，您可以脱机安装此 PowerShell 模块。

要接受 Microsoft 许可协议的条款，请按

A

。

然后安装最新版本的 Web 远程桌面包：

Install-RDWebClientPackage

安装 RDWebClientPackage 包后，使用以下命令检查其属性：

Get-RDWebClientPackage

正如你所看到的，出现了

rd-html 5.0 package version 1.0.0

。

接下来，您需要将 SSL 证书从具有用于 SSO（启用单点登录）的 RDS 连接代理角色的服务器导出到 .cer 文件（BASE64 格式）。

1. 打开计算机证书管理控制台

   certlm.msc

   ;

2. 展开个人 -> 证书部分；

   

3. 找到您的 RDS 场中使用的证书，右键单击它，然后选择“所有任务”->“导出”；

   

4. 选择Base-64 编码的 X.509 (.CER) 导出格式并指定文件名。

远程客户端必须信任此证书。了解如何将证书添加到 Windows 和 Linux 中的受信任证书。

将证书导入到 RD Web 访问服务器：

Import-RDWebClientBrokerCert C:\RDBrokerCert.cer

现在您可以发布 RD Web 客户端：

Publish-RDWebClientPackage -Type Production -Latest

要测试 RD Web 客户端，您可以使用以下命令部署它：

Publish-RDWebClientPackage -Type Test -Latest

使用 Web (HTML5) 客户端连接到 RDWeb 访问服务器

在 RDS 服务器上部署 Web 客户端包后，您可以使用客户端计算机上的浏览器访问 RemoteApps 和桌面。支持所有最新版本的 Microsoft Edge、Google Chrome、Safari 和 Mozilla Firefox。要从浏览器访问 RDS 服务器，只需与您的用户共享 RDWeb 服务器的 URL 链接即可。

请务必使用 RD Web 服务器的 FQDN 进行连接。请注意，此 FQDN 必须位于您部署的 RDS 证书中（检查公用名称/CN 和主题备用名称/SAN 字段）

打开URL地址：

https://RDWebFQDN.server.name/RDWeb/webclient/index.html

要访问测试环境，请使用以下 URL 地址：

https://RDWebFQDN.server.name/RDWeb/WebClient-Test/index.html

服务器名称必须与 SSL 证书中的 RD Web 访问服务器名称匹配。

使用您的凭据登录 RDWeb 服务器。

登录期间，系统将提示您 RD 会话中应提供哪些本地资源。仅剪贴板和打印机重定向可用。目前，本地驱动器和任何 USB 设备无法通过 HTML5 RDP 客户端进行重定向。请改用 mstsc.exe 客户端、RDCMan 或类似客户端。

成功登录后，您将看到 RD 集合中发布的所有 RemoteApp。您可以使用窗口顶部的图标在它们之间切换。

当您运行 RemoteApp 时，它将显示在浏览器中，并提供将窗口扩展到全屏的选项。

您可以使用 PDF 虚拟打印机（Microsoft Print to PDF）从远程桌面 Web 客户端进行打印。然后，您在 RD Web 客户端窗口中打印某些内容，浏览器会提示您下载 PDF 文件。您可以打开此 PDF（使用内置 Edge PDF 查看器或第三方应用程序）并将其打印到本地打印机。

HTML5 RD Web 客户端中可以动态更改 RD 窗口大小和全屏模式。您只能通过剪贴板将文本复制到远程桌面会话（但不能复制文件或图形）。

常见 RD Web 客户端错误

当您通过 Web 客户端登录 RD Web 访问时，您会看到已发布的远程应用程序的列表，但当您尝试启动其中任何一个时，您会收到错误：

Oops, we could not connect to Calculator. The connection to the remote PC was lost. This might be because of a network connection problem. If this keeps happening, ask your administrator or tech support for help.

也可能有错误：

The web client needs a Remote Desktop Gateway to connect to desktops and apps.

如果您在没有 RD Web 网关的情况下部署了 RDS 场，则会出现这些错误。如果仅部署了 RD 连接代理，则需要将 RDS 证书绑定到端口 3392（请参阅在 Windows Server 2019 中连接到没有 RD 网关的 RD Broker https://learn.microsoft.com/en-us/windows-server/remote/remote-desktop-services/clients/remote-desktop-web-client-admin 部分中的说明）。

错误 ：

Your session ended because an unexpected server authentication certificate was received from the remote PC. Ask your admin or tech support for help.

检查您的 RD 证书是否正确（证书中必须包含带有 RD Web 客户端的服务器的 FQDN）。验证是否已将此证书分配给 RDS 部署中的所有角色。另外，检查是否在 RDGW 服务器设置（SSL 证书选项卡）中设置了此证书。如果可能，请使用通配符证书。