适用于 HTML5 的 Citrix Workspace 应用程序

配置

August 31, 2021

贡献者:

C G

Content Collaboration Service 集成

此版本引入了 Citrix Content Collaboration Service 与 Citrix Workspace 应用程序的集成。您可以利用 Citrix Content Collaboration 轻松、安全地交换文档、通过电子邮件发送大型文档、安全地处理向第三方的文档传输以及访问协作空间。Citrix Content Collaboration 提供了多种工作方式，包括基于 Web 的界面、移动客户端、桌面应用程序以及与 Microsoft Outlook 和 Gmail 的集成。

可以使用 Citrix Workspace 应用程序中显示的文件选项卡从 Citrix Workspace 应用程序访问 Citrix Content Collaboration 功能。仅当在 Citrix Cloud 控制台中的 Workspace 配置中启用了 Content Collaboration Service 时，才能看到文件选项卡。

注意：Windows Server 2012 和 Windows Server 2016 不支持 Citrix Workspace 应用程序中的 Citrix Content Collaboration 集成，这是因为操作系统中设置了一个安全选项。

下图显示了新 Citrix Workspace 应用程序的文件选项卡的示例内容：

“文件”选项卡

限制：

重置Citrix Workspace 应用程序不会注销 Citrix Content Collaboration。
在 Citrix Workspace 应用程序中切换应用商店不会注销 Citrix Content Collaboration。

要使用户能够在其浏览器中访问 Citrix Virtual Apps and Desktops 上托管的资源，必须创建 StoreFront 应用商店并启用适用于 HTML5 的 Citrix Workspace 应用程序。您还必须根据需要在 Citrix Gateway、Citrix Virtual Apps 和 Citrix Virtual Apps and Desktops 上启用 WebSocket 连接。此外，可以通过在提供桌面和应用程序的计算机上安装可选组件来增强用户体验。

多显示器显示

多显示器显示允许您创建一个所连接到的桌面或应用程序会话的辅助窗口。之后可以将辅助窗口拖动到辅助显示器。

多显示器显示同时适用于桌面和应用程序会话。

要切换到多显示器模式，请单击工具栏中的多显示器。这样将创建一个分辨率为 1024x768 的辅助窗口。此外，还将使用双显示器信息更新服务器。可以拖动辅助窗口以及调整其大小，甚至可以在一个或两个显示器上转至全屏模式。每次调整窗口大小时，都会在服务器上更新辅助窗口分辨率。要退出多显示器模式，请关闭辅助窗口。

“多显示器”示意图

即使辅助显示器的分辨率详细信息对 Citrix Workspace 而言是未知的，多显示器模式也会向您提供灵活调整大小的功能以调整到您更喜欢的分辨率。

要使会话获得焦点，请单击工具栏中的显示器。

默认情况下启用此功能。

要禁用此功能，请编辑 configuration.js 文件并将 multiMonitor 属性的值设置为 false。

    'ui' : {
          'toolbar' : {
             'multiMonitor' : true
      },
<!--NeedCopy-->

在双监视器上使用 Citrix Virtual Desktops：

单击工具栏中的多监视器 。
此时将创建一个扩展窗口。将该窗口拖动到扩展的监视器。

屏幕现在将扩展到两个监视器。

多显示器性能

适用于 HTML5 的 Citrix Workspace 应用程序提高了多显示器场景中会话的总体性能和稳定性。在早期版本中，当一个会话在多个显示器上运行时，您会遇到性能低下问题。

限制：

此功能在除 Internet Explorer 和 Edge 外的桌面浏览器中受支持。
在 Mac 中，辅助窗口在 Chrome 中作为新选项卡打开。直接将此辅助窗口拖动到辅助显示器并调整大小时，该窗口可能会变得不可见，并在 Chrome 任务栏中显示一个条目。

解决方法：将该窗口拖动到主显示器，然后拖动回辅助显示器。

功能标志管理

如果生产环境中的 Citrix Workspace 应用程序出现问题，我们可以在 Citrix Workspace 应用程序中动态禁用受影响的功能，即使该功能已发布亦如此。为此，我们将使用功能标志以及名为 LaunchDarkly 的第三方服务。不需要做任何配置即可启用传输到 LaunchDarkly 的流量，但当您配置了阻止出站流量的防火墙或代理时除外。在这种情况下，您根据策略要求通过特定 URL 或 IP 地址启用传输到 LaunchDarkly 的流量。

迄今为止，对于云客户，无法访问 StoreFront 以自定义适用于 HTML5 的 Citrix Workspace 应用程序。在此期间，可以利用 LaunchDarkly 根据特定客户的应用商店 URL 为其打开或关闭功能。

可以通过以下方式启用传输到 LaunchDarkly 的流量和通信：

启用传输到以下 URL 的流量

events.launchdarkly.com
app.launchdarkly.com

在允许列表中列出 IP 地址

如果必须在允许列表中列出 IP 地址，请参阅 LaunchDarkly public IP list（LaunchDarkly 公用 IP 列表），获取当前所有 IP 地址范围的列表。此列表可用于确保您的防火墙配置自动更新，以便与基础结构更新保持一致。有关基础结构变更的状态的详细信息，请参阅 LaunchDarkly 状态页面。

如何收集日志

要收集适用于 HTML5 的 Citrix Workspace 应用程序的客户端日志，请执行以下操作：

登录适用于 HTML5 的 Citrix Workspace 应用程序。
按如下所示访问日志文件页面：
- 对于 Citrix Workspace 应用程序 HTML5 版本 1908 及更高版本，打开一个新选项卡并导航到 siteurl/Clients/HTML5Client/src/SessionWindow.html#engineType=log，其中 siteurl 为适用于 Web 的 Citrix Workspace 站点的 URL (https://server.domain/Citrix/StoreWeb)。
- 对于 Citrix Workspace 应用程序 HTML5 版本 1907 及早期版本，打开一个新选项卡并导航到 siteurl/Clients/HTML5Client/src/ViewLog.html，其中 siteurl 为适用于 Web 的 Citrix Workspace 站点的 URL (https://server.domain/Citrix/StoreWeb)。
在日志文件页面上，单击启动日志记录。将为后续的会话启动启用日志记录，而不为当前的活动会话（如果有的）启用日志记录。
请登录 Citrix Workspace 应用程序虚拟桌面，启动您的虚拟应用程序会话并重现问题以收集日志。继续处理会话以重现该问题。
重现问题后关闭会话。
日志记录页面中会显示为适用于 HTML5 的 Citrix Workspace 应用程序会话生成的日志文件。
单击箭头按钮以下载并保存日志文件。

注意:

对于适用于 HTML5 的 Citrix Workspace 应用程序 2.2 及更高版本，添加了工具栏菜单中的日志记录以启用和查看适用于 HTML5 的 Citrix Workspace 应用程序的日志。

要收集适用于 HTML5 的 Citrix Workspace 应用程序控制台日志，请执行以下操作：

在运行会话的浏览器选项卡上打开开发者工具。例如，在 Google Chrome 浏览器上，可以在更多工具选项下找到开发者工具。
在打开的开发者工具中单击控制台。
单击鼠标右键并选择另存为选项，保存所有日志。

对于与 USB 重定向相关的问题：

要收集与 USB 重定向相关的问题的日志，请执行以下操作：

请按照面向 HTML5 的使用 webconfig 中的步骤进行操作，通过以下方法为 USB 启用 moreLogs：将 moreLogs 配置值添加到 StoreFront 上的 web.config 文件中的 chromeAppPreferences： chromeAppPreferences ='{"moreLogs":{"usb":true}}'
然后，在 Google Chrome 浏览器中打开一个新选项卡，输入 chrome://device-log 并共享日志。

USB 设备重定向

通用 USB 设备重定向在 Chrome、Mac 和 Linux 操作系统上运行的 Chrome 浏览器（版本 61 及更高版本）中受支持。通过安全 HTTPS 连接启动的会话支持此功能。此功能支持同时重定向两个 USB 设备。

重定向 USB 设备 作为必备条件，请在服务器上启用 USB 重定向策略。有关详细信息，请参阅在服务器上启用 USB 重定向。
将 USB 设备连接到计算机。
单击会话中工具栏上提供的 USB 图标图标。
在 USB 设备对话框中，单击添加。

此操作将打开显示设备列表的 Chrome 对话框。

注意:

Chrome 对话框显示的 USB 设备可能并不总是通过适用于 HTML5 的 Citrix Workspace 应用程序重定向。可通过适用于 HTML5 的 Citrix Workspace 应用程序重定向的 USB 设备显示在应用程序的 USB 设备对话框中。
选择要重定向的设备，然后单击连接。成功重定向后，您将返回到 USB 设备对话框，并且设备将显示为已连接。
尝试重定向适用于 HTML5 的 Citrix Workspace 应用程序不支持的 USB 设备时将显示以下错误消息。
单击版本以从远程会话释放设备。
如果启动多个会话，则在不同会话内连接的 USB 设备将显示为 Already in use（已在使用中）。单击在此传输可将设备传输到当前会话。
将多个 USB 设备重定向到会话时，单击释放所有设备可从会话中删除设备。
在不单击版本的情况下断开重定向的 USB 设备与计算机的连接时，将显示以下错误消息。

USB 设备重定向功能仅适用于默认情况下客户端操作系统（例如 Mac 和 Chrome）不为其加载设备驱动程序的 USB 设备。例如，此功能适用于 Brother QL-580N 标签打印机。

如果您无法在 Linux 操作系统中重定向 USB 设备，请尝试设置用户帐户并提供打开 USB 设备的权限，如 Google 开发人员文档 https://developers.google.com/web/fundamentals/native-hardware/build-for-webusb#linux 中所述。

在服务器上启用 USB 重定向

请执行以下操作以在服务器上启用 USB 设备重定向：

在域控制器上启用 USB 设备重定向策略。

为 Citrix HTML5 客户端配置 USB 重定向

默认情况下，如果在服务器上启用了 USB 设备重定向策略，则在客户端上启用了 USB 设备重定向功能。

要将其禁用，请编辑 configuration.js 文件并将 toolbar 下 usb 的值设置为 false。此设置适用于 StoreFront。configuration.js 文件位于 C:\program Files\Citrix 实际路径\HTML5Client 中。

    'ui' : {
        'toolbar' : {
                'usb' : false
        },
    }
<!--NeedCopy-->

Chrome 浏览器的行为

单击挂锁图标时，浏览器选项卡会显示“安全连接”对话框。您可以看到浏览器选项卡已获得用户权限的 USB 设备。尽管有多个 USB 设备，但只有 Citrix HTML5 客户端可以重定向的设备显示在 Citrix USB 设备对话框中。这些设备可以在远程会话中使用。
如果您想撤销授予浏览器选项卡的访问权限，请单击 USB 设备旁边的 x 图标。因此，将显示重新加载按钮。如果单击重新加载，会话将关闭。重新启动会话以使更改生效。

限制：

USB 设备重定向功能不适用于默认情况下客户端操作系统（例如 Windows）为其加载设备驱动程序的某些 USB 设备。
只有 USB A 型设备可以重定向到会话。但是，您可以通过 C 型连接器连接 A 型设备。
释放 USB 集线器设备可能不会导致释放连接的 USB 类型 A 设备。
HID 设备、大容量存储设备和 Web 摄像机重定向可能不起作用。
此功能已经过测试，在 Windows 10 上运行的 VDA 上受支持。
此功能已同时测试多达两个 USB 设备。

指定叠加会话的持续时间

作为管理员，您可以使用 configuration.js 文件中的 resizeOverlayDuration 值来指定叠加会话的持续时间。该值默认为 3500 毫秒。可以将其设置为 0 到 3500 范围内的值。调整会话大小时，将生成 onResize 事件。此功能仅适用于通过适用于 HTML5 的 HDX SDK 启动的会话。

    'ui' : {
        'resizeOverlayDuration': 3500
            }
<!--NeedCopy-->

DPI 缩放

适用于 HTML5 的 Citrix Workspace 应用程序支持在单个显示器上针对应用程序和桌面会话进行 DPI 扩展。

适用于 HTML5 的 Citrix Workspace 应用程序允许您在具有高像素率的显示器上设置 VDA 分辨率。默认情况下，“DPI 缩放”功能对应用程序和桌面会话禁用。

对于适用于 HTML5 的 Citrix Workspace 应用程序 1908 及更早版本，请转到会话工具栏，然后选择工具栏 > 更多 > 首选项 > 显示分辨率以设置应用程序和桌面会话的分辨率。在 VDA 上设置正确的分辨率。

对于适用于 HTML5 的 Citrix Workspace 应用程序 1909 及更高版本，请转到会话工具栏，然后选择工具栏 > 更多 > 显示分辨率 > 设备像素率缩放以设置应用程序和桌面会话的分辨率。在 VDA 上设置正确的分辨率。

对 VDA 正确设置分辨率之后，模糊的文本将变得更清晰。

限制：

高 DPI 缩放功能在触摸屏设备上处于禁用状态。

自定义光标

适用于 HTML5 的 Citrix Workspace 应用程序现在支持在 Microsoft Internet Explorer 中使用自定义光标。此增强功能可确保您在多个浏览器之间具有一致的浏览体验。默认启用自定义光标。

使用 configuration.js 在 Microsoft Internet Explorer 或 Edge 中禁用自定义光标

configuration.js 文件位于 HTML5Client 文件夹中。可以通过执行以下步骤来编辑此文件，以配置适用于 HTML5 的 Citrix Workspace 应用程序：

打开 configuration.js 文件并将 ui 下的 ‘handleMouseCursorUsingDivForIE’ 的值设置为 false。

‘ui’: { ‘handleMouseCursorUsingDivForIE’ : false }

客户体验改善计划 (CEIP)

收集的数据	说明	我们用它来做什么
配置和使用数据	Citrix 客户体验改善计划 (CEIP) 从适用于 HTML5 的 Citrix Workspace 应用程序收集匿名配置和使用数据，并自动将数据发送到 Citrix 和 Google Analytics。	此数据可帮助 Citrix 提高 Citrix Workspace 应用程序的质量、可靠性和性能。

其他信息

Citrix 将根据与 Citrix 签订的合同条款处理您的数据，并按照 Citrix Trust Center 提供的 Citrix Services Security Exhibit 中所指定的方式对其进行保护。

Citrix 还使用 Google Analytics 从 Citrix Workspace 应用程序收集某些数据作为 CEIP 的一部分。请查看 Google 如何处理处理为 Google Analytics 收集的数据。

可以关闭将 CEIP 数据发送到 Citrix 和 Google Analytics 的功能。要执行此操作，请使用下列方法之一：

使用图形用户界面禁用 CEIP
使用 configuration.js 禁用 CEIP

注意:

为版本 2006 及更早版本禁用了 CEIP 时，将上载仅包含安装的适用于 HTML5 的 Citrix Workspace 应用程序版本的最少信息。此最少信息对 Citrix 非常有价值，因为这可以提供客户使用的不同版本的分布情况。

使用图形用户界面禁用 CEIP

注意:

仅当管理员使用 configuration.js 启用了 CEIP 设置时才能使用图形用户界面对其进行修改。

启动适用于 HTML5 的 Citrix Workspace 应用程序。
从工具栏中选择首选项。
取消选中通过发送匿名使用情况统计信息来帮助改进 Citrix Workspace。

注意:

重新启动会话以使更改生效。

使用图形用户界面禁用 CEIP

注意:

仅当管理员使用 configuration.js 启用了 CEIP 设置时才能使用图形用户界面对其进行修改。

启动适用于 HTML5 的 Citrix Workspace 应用程序。
从工具栏中选择首选项。
取消选中通过发送匿名使用情况统计信息来帮助改进 Citrix Workspace。

注意:

重新启动会话以使更改生效。

使用 configuration.js 禁用 CEIP

在适用于 HTML5 的 Citrix Workspace 应用程序中，configuration.js 文件位于 HTML5Client 文件夹中。可编辑此文件来配置适用于 HTML5 的 Citrix Workspace 应用程序。

注意:

Citrix 建议您在做出任何更改之前备份 configuration.js 文件。

编辑 configuration.js 文件需要管理员级别的凭据。

对于版本 1905 及早期版本，在 configuration.js 文件中将 ceip 下的 enabled 属性设置为 false。

'ceip':{
    'enabled':false,
}

<!--NeedCopy-->

对于版本 1906 及更高版本，在 configuration.js 文件中将 analytics 下的 enabled 属性设置为 false。

'analytics':{
    'enabled':false,
}

<!--NeedCopy-->

阻止 CEIP

对于版本 2007 及更高版本，管理员可以通过 configuration.js 文件阻止 CEIP。此配置的优先级高于通过图形用户界面所做的配置，并且 CEIP 数据不会发送到 Citrix。

打开 configuration.js 文件，添加 connectionEnabled 属性，然后将该属性设置为 false：
```
 'analytics':{
 'connectionEnabled':false,
             }

 
```

选择性 H.264

使用 configuration.js 文件配置选择性 H.264

注意:

Citrix 建议您在做出任何更改之前备份 configuration.js 文件。

Citrix 建议您仅在为用户重新封装适用于 HTML5 的 Citrix Workspace 应用程序时使用此方法。

需要使用管理员级别的凭据才能编辑 configuration.js 文件；编辑此文件后，请重新封装该应用程序以使所做的更改生效。

默认情况下，selectiveH264 设置为 true。

configuration.js 文件位于 C:\program Files\Citrix\HTML5Client 下。按如下所示编辑此文件并将 **selectiveH264** 更改为 **false**。实际路径>

“h264 代码段”示意图

PDF 打印

配置 PDF 打印

通过 Citrix PDF 通用打印机驱动程序，用户可以打印使用托管应用程序或使用 XenApp 和 XenDesktop 7.6 提供的虚拟桌面上运行的应用程序打开的文档。当用户选择 Citrix PDF 打印机选项时，驱动程序会将该文件转换为 PDF 并将该 PDF 传输至本地设备。随后 PDF 会在新的浏览器选项卡中打开，以从本地连接的打印机进行查看和打印。

如果希望使用户可以打印使用托管应用程序或 XenDesktop 7.6 和 XenApp 7.6 提供的虚拟桌面上运行的应用程序打开的文档，请完成以下步骤。

在为适用于 HTML5 的 Citrix Workspace 应用程序用户提供桌面或应用程序的每台计算机上，下载 Citrix PDF Printing Feature Pack 并安装 Citrix PDF 通用打印机驱动程序。安装打印机驱动程序后，重新启动计算机。
在 Citrix Studio 中，在左侧窗格中选择策略节点，然后创建新策略或编辑现有策略。有关配置 Citrix Virtual Apps and Desktops 策略的详细信息，请参阅策略。
将自动创建 PDF 通用打印机策略设置设为已启用。

注意:

在从适用于 HTML5 的 Citrix Workspace 应用程序启动的会话中使用 Citrix PDF 打印机时，请将客户端打印机名称设置设为默认设置或选择标准打印机名称。选择旧版打印机名称以使用旧式客户端打印机名称，并保留与产品的 XenApp 和 XenDesktop 版本中存在的旧版打印机名称的向后兼容性。您可以将此选项与产品的当前 Citrix Virtual Apps and Desktops 版本结合使用。

使用添加的 CSP 标头进行配置

除非为用户添加 Content-Security-Policy (CSP) 标头，否则可以使用 PDF 打印。

CSP 响应标头是浏览器用来避免跨站点脚本攻击的一组策略。

如果在 Citrix Gateway Rewrite Policies（重写策略）中添加了 CSP 标头，PDF 打印将不起作用。

请按如下所述进行配置，以使 PDF 打印正常运行：

img-src ‘self’ data: blob:

（blob： 此参数允许加载打印预览并继续执行打印功能）

增强的 PDF 打印体验

在早期版本中，尝试打印 PDF 时，将显示继续打印对话框，提示您确认打印。

在此版本中，打印窗口显示在您的 Citrix Workspace 会话中。可以从打印窗口直接打印文档。

此增强功能在 Chrome 和 Firefox 中完全受支持并且默认处于启用状态。要在 Chrome 和 Firefox 中禁用此增强功能，请在 configuration.js 文件中将 supportedBrowsers 的值设置为 false。configuration.js 文件位于 C:\program Files\Citrix\HTML5Client 下。实际路径>

此增强功能在 Internet Explorer 11 中部分受支持，并具有某些已知限制，默认处于禁用状态。要在 Internet Explorer 中启用此功能，请在 configuraton.js 文件中将 IE 的值设置为 true。configuration.js 文件位于 C:\program Files\Citrix\HTML5Client 下。实际路径>

    'pdfPrinting' : {
                  'directPrint' : {


     'supportedBrowsers':true,


                                          'IE':false
                                       }
                                     }
<!--NeedCopy-->

优化的分辨率

在早期版本中，当您尝试使用 Citrix PDF 打印机打印文档时，文档中的内容显示得模糊不清。

此版本引入了优化以改善用户体验。printResolution 值默认设置为 150。此外，为使内容更加清晰，可以根据您的要求将 configuration.js 文件中的值更改为 300 或 600：

'pdfPrinting' : {
    'directPrint' :
        {'printResolution' :150 }

<!--NeedCopy-->

限制：

在 Internet Explorer 中，打印的 PDF 的内容将缩小，并且不适合页面。
在 Internet Explorer 中，打印大型文件或包含大量页面的文件时，浏览器可能会停止响应，或者打印操作可能会间歇性失败。
通过 HTML5 HDX SDK 启动的会话不支持此增强功能。

隐藏“继续”打印对话框

禁用了增强的打印体验功能时，可以通过禁止显示继续打印对话框来打印 PDF。

默认情况下，请将 hide 对象的 printDialog 属性设置为 false。

configuration.js 文件位于 C:\program Files\Citrix\HTML5Client 下。实际路径>

为此，请将 hide 对象的 printDialog 属性设置为 true。

注意:

Citrix 建议您在做出任何更改之前备份 configuration.js 文件。

Citrix 建议您仅在为用户重新封装适用于 HTML5 的 Citrix Workspace 应用程序时使用此方法。

需要使用管理员级别的凭据才能编辑 configuration.js 文件；编辑此文件后，请重新封装该应用程序以使所做的更改生效。

    {

       'ui' : {

         "hide":{

            'printDialog': true

         }

       }

     }
<!--NeedCopy-->

阻止 PDF 打印

作为管理员，您现在可以阻止以下跨平台的浏览器上的 PDF 打印：Internet Explorer、Google Chrome、Firefox、Safari 和 Microsoft Edge（包括 Microsoft Edge Chromium）。

默认情况下，允许在所有浏览器中打印 PDF。要禁止 PDF 打印，请按照以下步骤进行操作：

导航到 configuration.js 文件，该文件位于 C:\Program Files\Citrix\Receiver StoreFront\HTML5Client。
编辑该文件并将 disableForBrowsers 的值设置为 ‘ALL’。
- 要在特定浏览器上禁用 PDF 打印，请将 disableForBrowsers 的值设置为 ‘MSIE’、‘Chrome’、‘FIREFOX’、‘FIREFOX’、‘CHROMIUMEDGE’ 或 ‘MSEDGE’。

    'pdfPrinting' : {
        'disableForBrowsers' : ['All']

    or

        'disableForBrowsers' : ['MSIE', 'Chrome', ‘CHROMIUMEDGE’, 'MSEDGE']

                    }

<!--NeedCopy-->

下面详细描述了每个值：

‘MSIE’：Internet Explorer 的所有版本
‘MSEDGE’： Microsoft Edge 的所有版本
‘CHROMIUMEDGE’：Microsoft Edge Chromium 的所有版本
‘Chrome’：Google Chrome 的所有版本
‘FIREFOX：Firefox 的所有版本
‘SAFARI’：Safari 的所有版本

会话可靠性

会话可靠性可使会话在服务器上保持活动状态。为指示连接已断开，用户的显示内容将冻结，直至用户到达通道的另一端后恢复连接。用户在连接中断期间可继续访问显示内容，在网络连接恢复后可继续与应用程序交互。会话可靠性可重新连接用户而不提示进行重新身份验证。

注意:

适用于 HTML5 的 Citrix Workspace 应用程序用户无法覆盖服务器设置。

结合使用会话可靠性与传输层安全性 (TLS)。

注意:

TLS 仅对用户设备和 Citrix Gateway 之间发送的数据进行加密。

有关配置会话可靠性的详细信息，请参阅 Citrix Virtual Apps and Desktops 文档中的会话可靠性策略设置。

移动支持

启用自动软键盘弹出

要启用此功能，请将自动键盘策略配置为在单击任何可编辑区域时显示软键盘：

在 DDC 上打开 Citrix Studio。
选择策略。
单击创建策略。
搜索自动显示键盘并选择允许。

文件传输

默认情况下，用户可以执行以下操作：

上载本地下载文件夹或连接的外围设备中的文件以及无缝访问 Citrix Virtual Apps and Desktops 会话中的数据。
将文件从 Citrix Virtual Apps and Desktops 会话下载到用户设备上的文件夹或外围设备。

管理员可以通过 Citrix Studio 中的策略选择性启用或禁用文件传输、上载或下载。

适用于 HTML5 的 Citrix Workspace 应用程序支持在 MacBook 上使用 Safari 浏览器下载文件。

要求

XenApp 或 XenDesktop 7.6 或更高版本，并且：
- 在服务器操作系统 VDA（Windows 2008 R2 或 Windows 2012 R2）上安装修补程序 ICATS760WX64022.msp
- 在客户端操作系统 VDA（Windows 7 或 Windows 8.1）上安装修补程序 ICAWS760WX86022.msp 或 ICAWS760WX64022.msp
要更改文件传输策略，请：在运行 Citrix Studio 的计算机上安装组策略管理 (GPM) 修补程序 GPMx240WX64002.msi 或 GPMx240WX86002.msi

限制：

用户一次最多可以上载或下载 10 个文件。
最大文件大小：
- 对于上载：2147483647 字节 (2 GB)
- 对于下载：262144000 字节 (250 MB)

文件传输策略

默认启用文件传输。使用 Citrix Studio 可更改这些策略（位于用户设置 < ICA\文件重定向下）。使用文件传输策略时，请注意以下事项：

允许在桌面与客户端之间传输文件。允许或阻止用户在 Citrix Virtual Apps and Desktops 会话与其设备之间传输文件。
将文件上载到桌面。允许或阻止用户将文件从其设备上载到 Citrix Virtual Apps and Desktops 会话。
从桌面下载文件。允许或阻止用户将文件从 Citrix Virtual Apps and Desktops 会话下载到其设备。

剪贴板

引入此功能之前，Citrix Workspace 不支持使用选择性粘贴功能将 HTML 格式的文本从本地应用程序复制并粘贴到其他应用程序（例如 Microsoft Excel）。因此，目标应用程序（在此示例中为 Microsoft Excel）将不保留其 HTML 格式特征。

除纯文本外，适用于 HTML5 的 Citrix Workspace 应用程序还支持在客户端与会话之间使用 HTML 格式。此支持功能对 Office 应用程序和浏览器非常有用。增强的剪贴板支持功能仅在 Chrome 和 Safari 浏览器上可用。可以复制 HTML 内容并保留格式。在 Chrome 中复制链接时，将在 HTML 格式中添加一个 <img> 标记，这使您可以有效地复制图片及文本。此功能比纯文本更强大，但并非在所有应用程序中都起作用。

要配置剪贴板支持，请向 VDA 中添加以下注册表项：

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\wfshell\Virtual Clipboard\Additional Formats\HTML Format “Name”=”HTML Format”

有关引入此功能后解决的问题的其他信息，请参阅知识中心文章 CTX086028。

警告：

注册表编辑器使用不当可能导致严重问题，可能需要重新安装操作系统。Citrix 无法保证因注册表编辑器使用不当导致出现的问题能够得以解决。使用注册表编辑器需自担风险。请确保在编辑注册表之前进行备份。

增强的剪贴板体验

使用适用于 HTML5 的基于浏览器的 Citrix Workspace 应用程序在 Windows、Mac 或 Chrome 操作系统中启动多个虚拟桌面托管应用程序或桌面时，您可能希望在会话与客户端设备之间复制和粘贴文本。使用此功能，您可以使用 Ctrl C 和 Ctrl V 热键（适用于 Windows 或 Chrome 操作系统）以及 CMD C 和 CMD V 热键（适用于 Mac 操作系统）来复制和粘贴。

默认情况下启用此功能。

在 Firefox 和 Edge 浏览器上，要将文本从远程会话复制到本地设备，请按下 Ctrl C，然后单击确认。

通过选择工具栏上首选项中的禁用复制确认复选框来禁用复制确认对话框。清除此复选框可重新启用该选项。

禁用增强的剪贴板体验

要禁用此功能，请编辑位于 HTML5Client 文件夹 (C:\Program Files\Citrix\Receiver StoreFront\HTML5Client) 中的 configuration.js 文件，并将 directClipboard 值设置为 false。

限制：

只能复制和粘贴纯文本，不能复制和粘贴图像和文件。
不支持大数据。
Ctrl 键可能会停留在按下位置。当您按下右侧 Ctrl 键很长一段时间，然后按 C 以复制文本时会出现此问题。解决方法：多次单击右侧 Ctrl 键。
从辅助显示器复制文本需要对 Google Chrome 和 Safari 浏览器进行额外的单击（通过复制确认对话框）。对于 Edge 和 Firefox 浏览器，从单个和辅助显示器复制文本需要额外的单击。
使用 Ctrl c 或 CMD C 和 Ctrl V 或 CMD V 键进行复制和粘贴。使用编辑菜单或右键单击选项复制文本可能需要使用确认对话框进行额外单击。

工具栏

默认启用增强的工具栏功能。

要隐藏工具栏，请执行以下操作：

以管理员身份登录时，访问 **C:\ProgramFiles\Citrix\HTML5Client** 中的 **configuration.js** 文件。实际路径>
搜索 configuration.js 文件以找到 menubar key。
在 configuration.js 文件中，设置 “menubar”:false。

还可以隐藏各个图标以阻止其在工具栏中显示。例如，要在工具栏中隐藏 Ctrl+Alt+Del 按钮，请执行以下操作：

以管理员身份登录时，访问 **C:\ProgramFiles\Citrix\HTML5Client** 中的 **configuration.js** 文件。实际路径>
搜索 configuration.js 文件以查找 lock。
在 configuration.js 文件中，设置 lock:false。

会话共享

为了能够进行会话共享，必须在同一计算机上托管这些应用程序，并且必须使用相同的参数（如窗口大小、颜色深度和加密）设置以无缝窗口模式配置这些应用程序。提供托管应用程序时，会默认启用会话共享。

如果在提供这些应用程序的计算机上安装了 App Switcher，则会在窗口底部显示一个任务栏。该任务栏会显示会话中当前正在运行的所有应用程序，用户可以在这些应用程序之间进行切换。用户可以将此任务栏配置为自动隐藏以及切换至小图标，从而将此任务栏占用的空间量降至最低。

包含适用于 HTML5 的 Citrix Workspace 应用程序控件的浮动工具栏将显示在浏览器选项卡中，如下图所示。借助剪贴板按钮，用户可以在设备的本地剪贴板和浏览器中运行的资源之间复制和粘贴 Unicode 纯文本。用户可以使用标准的 Windows 快捷方式在处于同一会话中或不同会话中的托管应用程序之间复制数据（包括文本、表格和图像）。用户还可以使用工具栏上的按钮将 CTRL+ALT+DELETE 组合键发送到其桌面和应用程序。

“Chrome html5 工具栏”示意图

打印使用托管应用程序或在虚拟桌面上运行的应用程序打开的文档时，用户可以选择将文档打印为 PDF。随后 PDF 会传输到本地设备以从本地连接的打印机进行查看和打印。用户关闭 PDF 时，文件会从设备删除。

单击使用托管应用程序所打开文档中链接的用户可以选择是在会话中的托管浏览器应用程序中打开 URL，还是使用本地设备上的浏览器打开 URL。

增强的应用程序切换器支持

自本版本起，当您在全屏模式或 kiosk 模式下启动已发布的应用程序会话时，该会话不会与桌面任务栏重叠。应用程序切换器将不再隐藏会话。此增强功能仅在单显示器模式下受支持。

HTML5 日志

适用于 HTML5 的 Citrix Workspace 应用程序提供用户设备生成的日志的时间戳。

要帮助对问题进行故障排除，可以查看适用于 HTML5 的 Citrix Workspace 应用程序会话日志。

日志页面允许用户执行以下操作：

启用日志记录：启用日志记录以查看 HMTL5 日志。
禁用日志记录：禁用日志记录以停止在会话中记录日志。
查看日志：查看针对会话生成的日志。
清除日志：删除在会话中生成的日志文件。
下载日志文件：将日志文件下载到所需位置。

通过导航到日志页面来查看适用于 HTML5 的 Citrix Workspace 应用程序日志

登录到 Citrix Receiver for Web 站点。
- 对于适用于 HTML5 的 Citrix Workspace 应用程序 1908 及更高版本，打开一个新选项卡并导航到 siteurl/Clients/HTML5Client/src/SessionWindow.html#engineType=log，其中 siteurl 是 Citrix Receiver for Web 站点的 URL <http://server.domain/Citrix/StoreWeb>。
- 对于适用于 HTML5 的 Citrix Workspace 应用程序 1907 及早期版本，打开一个新选项卡并导航到 siteurl/Clients/HTML5Client/src/ViewLog.html，其中 siteurl 是 Citrix Receiver for Web 站点的 URL <http://server.domain/Citrix/StoreWeb>。
在登录页面上，单击 Start Logging（开始登录）。
在 Citrix Receiver for Web 站点上，使用适用于 HTML5 的 Citrix Workspace 应用程序访问桌面或应用程序。

登录页面上会显示为适用于 HTML5 的 Citrix Workspace 应用程序会话生成的日志文件。您也可以下载日志文件供进一步分析。

使用工具栏查看适用于 HTML5 的 Citrix Workspace 应用程序日志

登录到 Citrix Receiver for Web 站点。
在 Citrix Receiver for Web 站点中，访问桌面或应用程序。
在会话工具栏中，选择日志记录。
单击启动日志记录。

音频

为使音频在 VDA 2008 及更早版本中运行，请按如下所示进行配置，作为临时解决方法：

在 chrome.exe 启动参数的末尾添加以下内容：

–disable-features=AudioServiceSandbox
您无法在 Safari macOS 上播放会话中的音频文件。

主机到客户端重定向

内容重定向功能允许您控制用户是使用在服务器上发布的应用程序来访问信息，还是使用用户设备上本地运行的应用程序来访问信息。主机到客户端重定向是一种内容重定向。仅在服务器操作系统 VDA（而非桌面操作系统 VDA）上受支持。启用了主机到客户端重定向时，URL 在服务器 VDA 上被截获并发送至用户设备。适用于 HTML5 的 Citrix Workspace 应用程序将显示一个对话框，提示用户选择是在会话中打开 URL 还是在本地设备上打开 URL。该对话框针对每个 URL 显示。禁用了主机到客户端重定向时，用户使用服务器 VDA 上的 Web 浏览器或多媒体播放器打开 URL。启用了主机到客户端重定向时，用户无法将其禁用。

主机到客户端重定向以前称为服务器到客户端重定向。

有关详细信息，请参阅常规内容重定向。

通用客户端 IME

必备条件：

启用“客户端键盘布局同步和 IME 改进功能”策略。
使用 Citrix Linux VDA 版本 2012 或更高版本。
浏览器语言必须是日语、中文(简体)、中文(繁体) 或韩语。
使用 Google Chrome、Mozilla Firefox、Apple Safari 13 或更高版本或者 Microsoft Edge。

配置：

自版本 2105 起，默认情况下启用通用客户端 IME 功能。作为管理员，您可以使用 StoreFront 服务器上的 configuration.js 文件启用或禁用此功能 (%ProgramFiles%\Citrix\Receiver StoreFront\HTML5Client)。

要为浏览器语言禁用此功能，请编辑 configuration.js 文件并将 features.ime.mode.<languageID> 设置为“seamlessIme”。如果设置了“seamlessIme”，通用客户端 IME 功能将被禁用。

configuration.js：

    var HTML5_CONFIG = {
    ...
    'features': {
        ...
        ime: {
            mode: {
                "ja": "seamlessIme",
                "zh": "seamlessIme",
                "ko": "seamlessIme"
            }
    ...
        }
    }
}

<!--NeedCopy-->

要为浏览器语言启用此功能，请编辑 configuration.js 文件并将 features.ime.mode.<languageID> 设置为“ctxIme”，或者将 mode 属性保留为空 ({})，这是默认行为。

configuration.js：

var HTML5_CONFIG = {
    ...
    'features': {
        ...
        ime: {
            mode: {
                "ja": "ctxIme",
                "zh": "ctxIme",
                "ko": "ctxIme"
            }
    ...
        }
    }
}

<!--NeedCopy-->

安全设置

Citrix 建议使用安全的应用商店。此外，最好为安全的应用商店启用 HTTP 严格传输安全性 (HSTS) 设置。

执行以下步骤以启用 HSTS 设置：

在 Citrix StoreFront 中的应用商店下，单击特定应用商店的链接以启用安全设置。
此时将显示管理 Receiver for Web 站点对话框。
单击 Configure（配置）。
此时将显示编辑 Receiver for Web 站点对话框。
单击高级设置选项卡，然后选择启用严格传输安全性。

安全设置

本内容的正式版本为英文版。部分 Citrix 文档内容采用了机器翻译，仅供您参考。Citrix 无法控制机器翻译的内容，这些内容可能包含错误、不准确或不合适的语言。对于从英文原文翻译成任何其他语言的内容的准确性、可靠性、适用性或正确性，或者您的 Citrix 产品或服务沿用了任何机器翻译的内容，我们均不作任何明示或暗示的保证，并且适用的最终用户许可协议或服务条款或者与 Citrix 签订的任何其他协议（产品或服务与已进行机器翻译的任何文档保持一致）下的任何保证均不适用。对于因使用机器翻译的内容而引起的任何损害或问题，Citrix 不承担任何责任。

配置

August 31, 2021

贡献者:

C G

August 31, 2021

贡献者:

C G

配置

Content Collaboration Service 集成

多显示器显示

多显示器性能

功能标志管理

启用传输到以下 URL 的流量

在允许列表中列出 IP 地址

如何收集日志

USB 设备重定向

在服务器上启用 USB 重定向

为 Citrix HTML5 客户端配置 USB 重定向

Chrome 浏览器的行为

指定叠加会话的持续时间

DPI 缩放

自定义光标

使用 configuration.js 在 Microsoft Internet Explorer 或 Edge 中禁用自定义光标

客户体验改善计划 (CEIP)

其他信息

使用图形用户界面禁用 CEIP

使用图形用户界面禁用 CEIP

使用 configuration.js 禁用 CEIP

阻止 CEIP

选择性 H.264

使用 configuration.js 文件配置选择性 H.264

PDF 打印

配置 PDF 打印

使用添加的 CSP 标头进行配置

增强的 PDF 打印体验

优化的分辨率

隐藏“继续”打印对话框

阻止 PDF 打印

会话可靠性

移动支持

启用自动软键盘弹出

文件传输

要求

文件传输策略

剪贴板

增强的剪贴板体验

禁用增强的剪贴板体验

工具栏

会话共享

增强的应用程序切换器支持

HTML5 日志

通过导航到日志页面来查看适用于 HTML5 的 Citrix Workspace 应用程序日志

使用工具栏查看适用于 HTML5 的 Citrix Workspace 应用程序日志

音频

主机到客户端重定向

通用客户端 IME

安全设置

本文中包含的内容