Citrix DaaS™

本地主机缓存

August 20, 2026

投稿者:

C C

本文全面概述了本地主机缓存 (LHC) 功能，重点介绍了其维护业务连续性的能力。它解释了 LHC 在正常工作操作期间和 LHC 模式激活时的功能。此外，本文还提供了有关配置检查、故障排除、用于 LHC 管理的 PowerShell 命令以及用于 LHC 运行状况的事件日志监控的指导。

概述

当 Cloud Connector 因网络中断或 Citrix Cloud™ 问题而与 Citrix Cloud™ 失去连接时，LHC 可维护最终用户对应用程序和桌面的访问。当 LHC 模式激活时，活动会话不受影响，并且新会话通过在 Cloud Connector 上运行的 LHC 代理进行代理。

LHC 默认启用，但确保您的环境为 LHC 正确配置非常重要。虽然配置错误可能不会中断正常的代理，但它们可能会阻碍 LHC 性能，从而在 LHC 模式处于活动状态时对最终用户造成中断。为确保 LHC 功能最佳，请检查 Studio 中的区域节点，以查找 Citrix 检测到的与区域相关的错误和警告。此外，请查阅检查弹性配置指南和避免可能对 DaaS 弹性产生负面影响的常见配置错误文章，以获取全面的 LHC 配置清单。

重要提示：

仅当 Cloud Connector 接收来自 StoreFront 的流量或启用了服务连续性时，LHC 才会启用。有关服务连续性如何在服务中断期间使用本地主机缓存来维护用户对应用程序和桌面的访问的更多信息，请参阅服务连续性。

工作原理

在正常操作期间，Cloud Connector 上的远程代理提供程序服务与 Citrix Cloud 通信以进行所有代理操作。Citrix 配置同步服务 (CSS) 定期检查 Citrix Cloud 中的配置更改，并将此数据同步到 Cloud Connector 上的 LHC 代理。如果 Cloud Connector 失去与 Citrix Cloud 的连接或 Citrix Cloud 遇到问题，则 LHC 模式将激活并确保持续访问应用程序和桌面。

正常代理操作期间

Cloud Connector 上的 Citrix 远程代理提供程序服务接受来自 StoreFront 的连接请求。远程代理提供程序服务与 Citrix Cloud 通信，以将用户与已向 Citrix Cloud 注册的 VDA 连接起来。
CSS 大约每 5 分钟检查一次 Citrix Cloud 中的云代理，以查看是否进行了任何配置更改。这些更改可以是管理员发起的（例如更改交付组属性）或系统操作（例如计算机分配）。
如果自上次检查以来发生了配置更改，CSS 会将信息同步到 Cloud Connector 上的 LHC 代理。（LHC 代理也称为高可用性服务或 HA 代理）。

所有配置数据都会被复制，而不仅仅是自上次检查以来发生更改的项目。CSS 将配置数据导入到 Cloud Connector 上的 Microsoft SQL Server Express LocalDB 数据库中。此数据库称为本地主机缓存数据库。CSS 确保本地主机缓存数据库中的信息与 Citrix Cloud 中站点数据库中的信息匹配。

在安装 Cloud Connector 时会自动安装 Microsoft SQL Server Express LocalDB（LHC 数据库使用）。LHC 数据库不能在 Cloud Connector 之间共享。您无需备份 LHC 数据库。每次检测到配置更改时，都会重新创建它。
如果自上次检查以来没有发生任何更改，则不会复制配置数据。

LHC 模式何时变为活动状态

LHC 代理开始侦听连接信息并处理连接请求。
当 Cloud Connector 首次失去与 Citrix Cloud 的连接时，LHC 代理没有当前的 VDA 注册数据，但当 VDA 与其通信时，会触发注册过程。在此过程中，LHC 代理还会获取该 VDA 的当前会话信息。
当 LHC 代理正在处理连接时，远程代理提供程序服务会继续监视与 Citrix Cloud 的连接。当连接恢复时，远程代理提供程序服务会指示 LHC 代理停止侦听连接信息，Citrix Cloud 会恢复代理操作。下次 VDA 通过远程代理提供程序服务与 Citrix Cloud 通信时，会触发注册过程。LHC 代理会删除 LHC 模式处于活动状态时留下的所有 VDA 注册。当 CSS 得知 Citrix Cloud 中发生了配置更改时，它会恢复同步信息。

万一 LHC 在同步期间启动，则会丢弃当前导入并使用上次已知的配置。

事件日志会指示同步发生的时间以及 LHC 模式激活的时间。

在 LHC 模式下运行没有时间限制。

您还可以手动触发 LHC 模式。有关执行此操作的原因和方法，请参阅强制 LHC 模式。

具有多个 Cloud Connector 的区域

除其他任务外，CSS 会定期向 LHC 代理提供有关区域中所有 Cloud Connector 的信息。有了这些信息，每个 LHC 代理都会了解区域中其他 Cloud Connector 上运行的所有对等 LHC 代理。

LHC 代理通过单独的通道相互通信。这些代理使用其运行所在计算机的 FQDN 名称的字母顺序列表来确定（选举）如果区域进入 LHC 模式，哪个 LHC 代理将代理区域中的操作。在 LHC 模式下，所有 VDA 都会向选定的 LHC 代理重新注册。区域中未选定的 LHC 代理会主动拒绝传入的连接和 VDA 注册请求。

重要提示：

区域内的连接器必须能够通过 http://<FQDN_OF_PEER_CONNECTOR>:80/Citrix/CdsController/ISecondaryBrokerElection 相互访问。如果连接器无法通过此地址进行通信，则在 LHC 模式下可能会选举出多个代理并发生启动失败。

在 LHC 模式下，如果 Cloud Connector 重启或 LHC 代理失败：

如果该 Cloud Connector 不是选定的 LHC 代理，则重启没有影响。
如果该 Cloud Connector 是选定的 LHC 代理，则下一个 Cloud Connector 上的 LHC 代理将被选中，导致 VDA 注册。选举顺序基于 Cloud Connector FQDN 的字母顺序。一旦 LHC 代理再次变为活动状态，LHC 操作将继续在按字母顺序排列的第一个连接器上进行，这可能导致 VDA 再次注册。在这种情况下，注册期间的性能可能会受到影响。

有关 LHC 代理选举相关事件的更多信息，请参阅事件日志。

本地主机缓存数据内容

LHC 数据库包含以下数据，这些数据是主数据库中数据的子集：

被授予站点发布资源权限的用户和组的身份。
当前正在使用或最近使用过站点发布资源的用户身份。
站点中配置的 VDA 计算机（包括远程 PC 访问计算机）的身份。
正在积极用于连接已发布资源的客户端 Citrix Workspace™ 应用程序计算机的身份（名称和 IP 地址）。

它还包含在 LHC 模式下建立的当前活动连接的以下信息：

Citrix Workspace 应用程序执行的任何客户端计算机端点分析结果。
与站点相关的基础架构计算机（例如 Citrix Gateway 和 StoreFront 服务器）的身份。
用户最近活动的日期、时间和类型

本地主机缓存状态

在进入和退出 LHC 模式的整个周期中，有几种状态。下图描述了进入和退出 LHC 模式的状态。

LHC 状态(/en-us/citrix-daas/media/lhc-states.png)

在正常工作状态下，所有组件都正常运行，所有代理事务都由云代理处理。- - CSS 正在主动将配置从云代理复制到云连接器。如果任何健康检查失败，云连接器将转换为待定 HA状态。在此状态下，将启动全面的健康检查以确定下一步行动方案。连接器与区域中的其他连接器交互以确定其健康状况。
从待定 HA转换为初始 HA的决定基于给定区域中所有连接器的健康状况。如果健康检查成功，连接器/控制器将转换回正常工作状态。否则，如果健康检查继续失败，连接器/控制器将转换为初始 HA状态。
在初始 HA状态期间，选定连接器上的 LHC 代理接管代理职责。当前区域中所有之前注册的 VDA 现在将向云连接器上的 LHC 代理注册。所有 VDA 重新向 HA 服务注册可能需要长达 5 分钟。在初始 HA结束时，将启动健康检查。如果所有健康检查都成功，状态将转换为待定恢复，否则状态将转换为扩展 HA。
在扩展 HA期间，健康检查将继续进行。当健康检查在扩展 HA期间成功时，状态将转换为待定恢复。连接器在扩展 HA状态下停留没有最长时间限制。
待定恢复充当缓冲期，以确保服务在退出 LHC 模式之前完全正常。如果在待定恢复期间任何健康检查失败，状态将转换回扩展 HA。
如果在整个 10 分钟的待定恢复期间所有健康检查都成功，则状态将转换为正常工作。随着此转换，LHC 模式结束，并且区域中所有之前向 LHC 代理注册的 VDA 现在将重新向云代理注册。此重新注册可能再次需要长达 5 分钟。

LHC 模式期间的重要注意事项

在 LHC 模式期间，请考虑以下影响：

方面	LHC 模式期间的影响
Studio 访问	可能无法访问，具体取决于中断的性质。在 LHC 模式下运行的区域中的 VDA 在 Studio 中显示为未注册，因为它们已向 LHC 代理注册。
远程 PowerShell SDK 访问	访问受限。设置 SDK 身份验证：运行 `Get-XDAuthentication -ProfileName WindowsCurrentUser` 以防止 SDK 代理重定向 cmdlet 调用。进行这些更改后，您可以使用所有 `Get-Broker` cmdlet。注意：在初始 cmdlet 调用中包含 `-AdminAddress localhost:89` 参数。示例：`Get-BrokerMachine -AdminAddress localhost:89`



监控数据	当 LHC 模式处于活动状态时，监控功能不显示活动。监控器中趋势页面的本地主机缓存控制板中提供了部分监控数据。
管理程序凭据	无法从主机服务获取。处于未知电源状态的计算机无法执行电源操作。已开机的 VM 可用于连接。
分配的计算机	仅在正常操作期间分配后才可用。在 LHC 模式下无法进行新分配。
远程电脑访问计算机	不支持自动注册和配置。在正常操作期间注册和配置的计算机可用。
服务器托管的应用程序和桌面会话限制	如果资源位于不同的区域，用户使用的会话数可能超过其配置的会话限制。
区域行为	每个区域独立运行。如果启用了 StoreFront 的高级运行状况检查功能，StoreFront 能够在 LHC 模式期间将启动请求路由到相应的区域，并避免会话启动失败。
计划的 VDA 重启	如果在交付组中 VDA 的计划重启开始之前进入 LHC 模式，则重启将在 LHC 模式退出且正常代理操作恢复时开始，这可能会在区域退出 LHC 模式时导致意外重启。有关更多信息以及可以更改此行为的配置，请参阅因数据库中断而延迟的计划重启。
区域首选项	会话启动不考虑区域首选项配置。
标签限制	对于在多个区域中包含 VDA 的交付组，如果标记的 VDA 不存在于所有区域中，则标签限制可能会导致启动失败。

注意：

从 2025 年 6 月起，$XDSDKAuth 用于 SDK 身份验证的功能已弃用。有关详细信息，请参阅弃用。

应用程序和桌面支持

LHC 支持以下类型的 VDA 和交付模型：

VDA 类型	交付模型	LHC 模式下的 VDA 可用性
多会话操作系统	应用程序和桌面	始终可用。
单会话操作系统静态（已分配）	桌面	始终可用。
电源管理单会话操作系统随机（池化）	桌面	默认情况下仅对一个会话可用。您可以将它们配置为在 LHC 期间始终可用于新会话。有关详细信息，请参阅使用 Studio 启用和使用 PowerShell 启用。重要提示：启用对电源管理的单会话池化计算机的访问可能会导致来自先前用户会话的数据和更改出现在后续会话中。

注意：

在池化交付组中启用对电源管理的桌面 VDA 的访问不会影响配置的 ShutdownDesktopsAfterUse 属性在正常操作期间的工作方式。当在 LHC 期间启用对这些桌面的访问时，VDA 在返回正常代理操作后不会自动重新启动。池化交付组中的电源管理的桌面 VDA 可以保留来自先前会话的数据，直到 VDA 重新启动。VDA 重新启动可能发生在用户在非 LHC 操作期间注销 VDA 时，或者管理员重新启动 VDA 时。

使用 Studio 为电源管理的单会话操作系统池化 VDA 启用 LHC

使用 Studio，您可以在 LHC 模式下，按交付组使这些计算机可用于新连接：

要在创建交付组期间启用此功能，请参阅创建交付组。
要为现有交付组启用此功能，请参阅管理交付组

注意：

此设置仅在 Studio 中适用于提供电源管理的 VDA 的池化桌面交付组。

使用 PowerShell 为电源管理的单会话操作系统池化 VDA 启用 LHC

要在特定交付组中为 VDA 启用 LHC，请执行以下步骤：

通过运行此命令在站点级别启用此功能：

Set-BrokerSite -ReuseMachinesWithoutShutdownInOutageAllowed $true
<!--NeedCopy-->

通过运行此命令并指定交付组名称来为交付组启用 LHC：

Set-BrokerDesktopGroup -Name "name" -ReuseMachinesWithoutShutdownInOutage $true
<!--NeedCopy-->

要更改新创建的、具有电源管理的 VDA 的池式交付组的默认 LHC 可用性，请运行以下命令：

Set-BrokerSite -DefaultReuseMachinesWithoutShutdownInOutage $true
<!--NeedCopy-->

注意：

更改默认设置不会更改现有交付组的设置，并且仅影响使用 PowerShell 创建的交付组。

StoreFront 配置

如果使用本地 StoreFront 部署，请查看以下内容：

如果使用负载平衡虚拟服务器，请将虚拟服务器配置为根据代理功能监视连接器（例如，在 NetScaler® 上使用内置的 CITRIX-XD-DDC 监视器进行连接器负载平衡）。
将单个云租户中的所有 Cloud Connector 作为 StoreFront 中的单个站点包含在内。
在 StoreFront 中查看 NetScaler Gateway 配置，并确保所有连接器都列为 STA 服务器。检查 NetScaler 设备，并确保 StoreFront 中列出的所有 STA 在 NetScaler Gateway 虚拟服务器中采用相同的格式。STA 服务运行状况也可以在 Gateway 虚拟服务器中进行监视。
将所有连接器添加到 StoreFront 中的资源源，并确保 StoreFront 可以通过资源源中指定的端口与所有 Cloud Connector 进行通信。

注意：

对于拥有许多连接器的客户，为每个区域配置负载平衡虚拟服务器可能有助于减少管理开销并简化故障排除。有关详细信息，请参阅 Citrix TIPs: Integrating Citrix Virtual Apps and Desktops service and StoreFront。

验证本地主机缓存是否正常工作

要验证 LHC 是否已正确设置并正常工作：

确保同步导入成功完成。有关如何监视 LHC 同步的更多信息，请查看事件日志。
确保在每个 Cloud Connector 上都创建了本地主机缓存数据库。这确认了高可用性服务可以在需要时接管。
- 在 Cloud Connector 服务器上，浏览到 c:\Windows\ServiceProfiles\NetworkService。
- 验证是否已创建 HaDatabaseName.mdf 和 HaDatabaseName_log.ldf。
强制 LHC 模式在区域中的所有 Cloud Connector 上：验证本地主机缓存正常工作后，请记住将所有 Cloud Connector 恢复到正常模式。有关退出 LHC 模式所需时间的更多信息，请参阅本地主机缓存状态。

监视本地主机缓存

事件日志

事件日志提供有关 LHC 运行状况和性能的关键信息。

配置同步器服务

在正常操作期间，当 CSS 使用 LHC 代理将配置数据导入 LHC 数据库时，可能会发生以下事件。

事件 ID	描述
503	指示 CSS 已收到更新的配置。每次从 Citrix Cloud 收到更新的配置时，都会发生此事件。这表示同步过程的开始。
504	指示 CSS 已导入更新的配置。配置导入成功完成。
505	指示 CSS 导入失败。配置导入未成功完成。如果存在以前成功的配置，则在进入 LHC 模式时会使用该配置。但是，它将与当前配置不同步。如果没有可用的以前配置，则服务在 LHC 模式期间无法参与会话代理。在这种情况下，请参阅故障排除部分，并联系 Citrix 支持。
507	指示 CSS 放弃了导入，因为系统处于 LHC 模式，并且正在使用 LHC 代理进行代理。服务收到了新的配置，但由于进入了 LHC 模式，导入被放弃。这是预期行为。
510	指示未从主配置服务接收到 CSS 配置数据。
517	指示与主代理服务通信时出现问题。
518	指示 CSS 脚本中止，因为 LHC 代理（高可用性服务）未运行。

高可用性服务

此服务也称为 LHC 代理。

事件 ID	描述
3502	指示发生中断，并且 LHC 代理正在执行代理操作。
3503	表示中断已解决，正常操作已恢复。
3504	指示已选定的 LHC 代理以及参与选举的其他 LHC 代理。
3507	指示 LHC 模式在选定的 LHC 代理上处于活动状态。包含中断摘要，包括中断持续时间、VDA 注册和会话信息。
3508	指示 LHC 在选定的 LHC 代理上不再处于活动状态，并且正常操作已恢复。包含中断摘要，包括中断持续时间、LHC 事件期间注册的计算机数量以及 LHC 模式期间成功启动的数量。
3509	指示 LHC 在未选定的 LHC 代理上处于活动状态。包含每 2 分钟的中断持续时间，并指示选定的 LHC 代理。
3510	指示 LHC 在未选定的 LHC 代理上不再处于活动状态。包含中断持续时间，并指示选定的 LHC 代理。

远程代理提供程序

此服务充当 Citrix Cloud 与您的 VDA 和 Cloud Connector 之间的代理。

事件 ID	描述
3001	首次检测到导致 Cloud Connector 进入 Pending HA 状态的故障。运行状况检查开始评估故障是暂时性的还是持久性的。在 Pending HA 状态的分配时间过后，最新的运行状况检查结果会指示是否需要进入 LHC 模式，或者是否可以恢复正常操作。
3002	指示 Cloud Connector 无法进入 LHC 模式。原因包含在事件信息中。
3003	指示 Cloud Connector 正在经历 LHC 模式状态转换。该事件提供以下详细信息： Cloud Connector 正在从中转换的状态正在转换到的状态上一个状态的持续时间

注意：

Cloud Connector 上全天定期出现的 3001 事件通常无需担忧。但是，如果它们每小时出现多次，则表明存在网络问题，可能需要进一步调查。

Citrix 监控

Citrix Monitor 包含有关环境中不同区域的 LHC 模式条目和性能的集中信息。

DaaS 监控 LHC

有关详细信息，请参阅监视站点的历史趋势。

强制本地主机缓存模式

在以下情况下，您可能需要有意强制使用本地主机缓存模式：

如果您的网络反复出现故障：强制使用 LHC 直到网络问题解决，可防止在正常模式和 LHC 模式之间持续切换（以及由此导致的频繁 VDA 注册风暴）。
测试灾难恢复计划。
帮助确保本地主机缓存正常工作。

要强制使用 LHC 模式，请执行以下操作：

编辑 HKLM\Software\Citrix\DesktopServer\LHC 中每个 Cloud Connector 服务器的注册表：创建 OutageModeForced 并将其设置为 REG_DWORD，值为 1。
- 将值设置为 1 会指示 LHC 代理进入 LHC 模式，无论与 Citrix Cloud 的连接状态如何。
- 将值设置为 0 会指示 LHC 代理退出 LHC 模式并恢复正常操作。

要验证事件，请执行以下操作：

监视 C:\ProgramData\Citrix\workspaceCloud\Logs\Plugins\HighAvailabilityService 中的 Current_HighAvailabilityService 日志文件。

解决同步导入失败问题

当同步导入到 LHC 数据库失败并记录 505 事件时，您可以使用以下故障排除工具：

CDF 跟踪：
- 为 ConfigSyncServer 和 BrokerLHC 模块启用跟踪。
- 与其他代理模块一起使用以识别问题。
CSS 跟踪报告：
- 生成详细报告，指出导致同步失败的对象。
  
  注意：
  
  启用此报告可能会影响同步速度。在不主动进行故障排除时将其禁用。
要启用和生成 CSS 跟踪报告：
1. 启用报告：运行以下命令：
```
New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\DesktopServer\LHC -Name EnableCssTraceMode -PropertyType DWORD -Value 1

```
2. 查找报告：HTML 报告在 C:\Windows\ServiceProfiles\NetworkService\AppData\Local\Temp\CitrixBrokerConfigSyncReport.html 生成。
3. 禁用报告：生成报告后，运行以下命令禁用报告功能：
```
Set-ItemProperty -Path HKLM:\SOFTWARE\Citrix\DesktopServer\LHC -Name EnableCssTraceMode -Value 0

```

本地主机缓存 PowerShell 命令

您可以使用 PowerShell 命令在您的 Cloud Connector 上管理本地主机缓存。

PowerShell 模块位于 Cloud Connector 上的以下位置：

C:\Program Files\Citrix\Broker\Service\ControlScripts

重要：

仅在 Cloud Connector 上运行此模块。

导入 PowerShell 模块

要导入模块，请在 Cloud Connector 上运行以下命令：

Import-Module "C:\Program Files\Citrix\Broker\Service\ControlScripts\HighAvailabilityServiceControl.psm1
<!--NeedCopy-->

用于管理 LHC 的 PowerShell 命令

以下 cmdlet 可帮助您在 Cloud Connector 上激活和管理 LHC 模式。

命令集	功能
`Enable-LhcForcedOutageMode`	将 Broker 置于 LHC 模式。CSS 必须已成功创建本地主机缓存数据库文件，`Enable-LhcForcedOutageMode` 才能正常运行。此 cmdlet 仅在运行它的 Cloud Connector 上强制启用 LHC。要使 LHC 处于活动状态，必须在区域内的所有 Cloud Connector 上运行此 cmdlet。
`Disable-LhcForcedOutageMode`	使 Broker 退出 LHC 模式。此 cmdlet 仅在运行它的 Cloud Connector 上禁用 LHC 模式。必须在区域内的所有 Cloud Connector 上运行 `Disable-LhcForcedOutageMode`。
`Set-LhcConfigSyncIntervalOverride`	设置 CSS 检查 Citrix DaaS™ 站点内配置更改的间隔。时间间隔范围为 60 秒（一分钟）到 3600 秒（一小时）。此设置仅适用于运行它的 Cloud Connector。为了在所有 Cloud Connector 之间保持一致性，请考虑在每个 Cloud Connector 上运行此 cmdlet。例如：`Set-LhcConfigSyncIntervalOverride -Seconds 1200`
`Clear-LhcConfigSyncIntervalOverride`	将 CSS 检查 Citrix DaaS 站点内配置更改的间隔设置为默认值 300 秒（五分钟）。此设置仅适用于运行它的 Cloud Connector。为了在所有 Cloud Connector 之间保持一致性，请考虑在每个 Cloud Connector 上运行此 cmdlet。
`Enable-LhcHighAvailabilitySDK`	启用对运行它的 Cloud Connector 中所有 `Get-Broker*` cmdlet 的访问。
`Disable-LhcHighAvailabilitySDK`	禁用对运行它的 Cloud Connector 中 Broker PowerShell 命令的访问。

注意：

在 Cloud Connector 上运行 Get-Broker* cmdlet 时，请使用端口 89。例如：

Get-BrokerMachine -AdminAddress localhost:89

当不在 LHC 模式下时，Cloud Connector 上的 LHC Broker 仅保存配置信息。

在 LHC 模式下，LHC Broker 保存以下信息：

资源状态

会话详细信息

VDA 注册

配置信息