通过 StoreFront 进行混合启动的应用程序保护支持

Last published : Nov 03, 2026
Citrix Virtual Apps and Desktops 的混合启动是指您通过在本地浏览器中键入应用商店 URL 登录 StoreFront for Web,并通过本地 Citrix Workspace 应用程序及其 HDX 引擎启动虚拟应用程序和桌面。术语“混合”是使用 StoreFront for Web 和本地 Citrix Workspace 应用程序组合连接和使用资源的结果。
注意:
当端点上未安装任何本地 Citrix Workspace 应用程序组件时,这是一种零安装配置,其中 Citrix Workspace 应用商店和 HDX 引擎都在浏览器中。此场景称为 Citrix Workspace app for HTML5,它托管在 Citrix Workspace 或 Citrix StoreFront 上。本文档不涉及此场景。
通过 StoreFront 进行混合启动的应用程序保护支持,使启用了应用程序保护的资源能够从浏览器中显示和启动。
注意:
如果您选择使用精简版(使用 HTML5 客户端)或已安装选项,则启用了应用程序保护的会话将被阻止,因为浏览器中未成功检测到 Citrix Workspace 应用程序。
如果您使用的是 StoreFront 2308 或更高版本,则在 StoreFront 配置正确且浏览器成功检测到本地 Citrix Workspace 应用程序的情况下,您可以使用 Web 浏览器访问启用了应用程序保护策略的应用程序和桌面。如果您使用的是 StoreFront 1912 到 2203 之间的版本,则必须按照 (/zh-cn/citrix-workspace-app/app-protection/app-protection-hybrid-launch-storefront.html#how-to-deploy) 部分中所述应用自定义。
限制:
StoreFront 在您首次登录网站时确定 Citrix Workspace 应用程序版本。如果您以后安装了不同版本的 Citrix Workspace 应用程序,则 StoreFront 不会知道此更改。因此,它可能会错误地允许或禁止启动启用了应用程序保护策略的虚拟应用程序和桌面。Citrix 建议配置应用程序保护姿态检查,该检查会阻止从不支持应用程序保护的早期版本 Citrix Workspace 应用程序启动虚拟应用程序和桌面。有关姿态检查的详细信息,请参阅 (/zh-cn/citrix-workspace-app/app-protection/features.html#posture-check)。

通过 StoreFront 2308 或更高版本进行混合启动

StoreFront 2308 版本包含对启用了应用程序保护策略的虚拟应用程序和桌面混合启动的支持,但此功能默认禁用。有关在 StoreFront 2308 或更高版本上启用应用程序保护以进行混合启动的详细信息,请参阅 (/zh-cn/storefront/current-release/manage-citrix-receiver-for-web-site/app-protection)。

通过 StoreFront 1912 到 2203 版本进行混合启动

StoreFront 1912 到 2203 版本支持通过以下自定义启用启用了应用程序保护策略的虚拟应用程序和桌面的混合启动:
Citrix 建议在升级到 StoreFront 2308 或更高版本时删除此自定义。

先决条件

有关 Citrix 组件的应用程序保护所需版本的信息,请参阅系统要求。

如何部署

  1. 下载名为 stf-customization-AppP.zip 的 Zip 文件,其中包含您必须部署到 StoreFront 服务器计算机的所有必需文件。从 Citrix 下载 下载该文件。该文件包括以下内容:
    • 必须复制到商店 bin 文件夹的 DLL
    • 使解决方案正常工作所需的 JavaScript 文件和其他文件
    • deploy-solution.ps1 PowerShell 脚本,StoreFront 管理员使用该脚本部署解决方案
  2. 解压缩 stf-customization-AppP.zip 文件,并在文件解压缩的位置打开新的管理员 PowerShell。运行 deploy-solution.ps1 命令,该命令接受以下参数:
    • -Action:脚本执行的操作。允许的值如下:
      • Deploy 操作以无缝方式部署解决方案。它会创建此解决方案更改的文件的备份,复制解决方案文件,然后重新启动服务。以下屏幕截图描述了在 StoreFront 服务器上部署解决方案的命令:
        部署
      • ApplyUICustomization 操作在商店 UI 上应用自定义,这样您就不会看到 Already installed(已安装)和 Use light version(使用精简版)选项。此操作强制在浏览器中检测本机 Citrix Workspace 应用程序,并确保您绕过被阻止或不受支持的场景。
        UI 自定义
      • RemoveUICustomization 操作撤消 ApplyUICustomization 的操作,并且 Already Installed(已安装)和 Use light version(使用精简版)选项再次出现。
    • -StoreName:必须对其执行操作的商店的名称。此参数是强制性的,必须与 Deploy 操作一起传递。
    • -BackupDir:可与 Deploy 操作一起传递的参数,用于在所需目录创建备份。如果未传递,则在桌面创建备份。此参数为可选参数。
注意:
如果 StoreCustomization_Input.dll 或 StoreCustomization_Launch.dll 中存在任何现有自定义项,部署此解决方案将覆盖它们。
启用了应用程序保护的应用程序和桌面仅在部署自定义项后显示。如果未部署,则应用程序和桌面不会显示。

如何还原 StoreFront 自定义项

执行以下步骤以还原上述 StoreFront 自定义项:
  1. 转到 \Desktop\StoreBackup\<store name> 目录并将以下文件复制到相应的目录:
    • StoreCustomization_Input.dll 和 StoreCustomization_Launch.dll 文件到 IISINETPub\Citrix\<store name>\bin 目录
    • web.config 文件到 IISINETPub\Citrix\StoreWeb 目录
    • *.js 和 style.css 文件到 IISINETPub\Citrix\StoreWeb\Custom 目录
      注意:
      如果 \Desktop\StoreBackup\<store name> 目录中存在除上述文件之外的自定义文件,请根据需要将这些文件和目录复制到相关目录。
  2. 打开 PowerShell。
  3. 通过运行以下命令停止 IISADMIN 和 CitrixSubscriptionsStore 服务:
    sc stop IISADMIN
    sc stop CitrixSubscriptionsStore
  4. 通过运行以下命令再次启动 IISADMIN 和 CitrixSubscriptionsStore 服务:
    sc start IISADMIN
    sc start CitrixSubscriptionsStore

保护资源的混合启动的最终用户体验

  1. 在管理员在 StoreFront 服务器上部署解决方案后,在客户端登录到您的应用商店,然后使用 Web 浏览器中的 URL 访问 StoreFront。
  2. 要查看 Citrix Workspace 应用程序是否在浏览器中成功检测到,请检查您的“帐户设置”中的“当前状态”。
    当前状态
    检测到 Citrix Workspace 应用程序后,您可以查看并启动所有已启用应用程序保护的虚拟应用程序和桌面。

在 StoreFront 上启用跟踪

要在 StoreFront 中启用跟踪,请参阅 StoreFront 文档。此跟踪可用于验证配置的 NetScaler Gateway 会话策略标签是否正确传递到应用商店。

故障排除

启动启用应用程序保护的会话时,有时可能会遇到以下错误:
错误
出现此错误的可能原因如下:
  • 应用程序和桌面配置为在浏览器中打开。
    故障排除 1
    如果您在检测 Citrix Workspace 应用程序时单击了“使用精简版”,如以下屏幕所示,则会遇到此情况:
    选项
  • 浏览器未检测到 Citrix Workspace 应用程序。
    故障排除 2
    如果您在检测 Citrix Workspace 应用程序时点击了已安装,则会出现此情况,如下屏幕所示:
    选项
解决方案:要纠正上述情况并启动启用了应用程序保护的会话,请在帐户设置中单击更改 Citrix Workspace 应用程序,然后等待 Citrix Workspace 应用程序被检测到。

优化

必须检测到 Citrix Workspace 应用程序才能启动启用了应用程序保护的会话。为避免在混合启动受保护会话期间出现故障,StoreFront 管理员可以使用 deploy-solution.ps1 命令的 ApplyUICustomization 操作来隐藏使用精简版和已安装选项。