Skip to main content

2026 年 10 月 2 日

Horizon Recording 设置

本主题介绍了 Horizon Recording 功能的设置。

Web 界面中的 Horizon Recording 设置

在管理员 > 管理代理中,您可以查看向此 Recording Server 实例注册的计算机的详细信息。

在管理员 > 服务设置中,您可以更改录制应用程序的身份验证、客户端和服务器设置,以及录制标准。

以下凭据存储在数据库中。默认情况下,管理员可以完全控制服务设置,而查看者只能查找、观看和下载录制内容。

用户名/密码:administrator/Recording123

用户名/密码:viewer/Recording456

您可以在身份验证设置中选择用户并更改这些密码:

身份验证设置描述
LDAPS 集成禁用或启用 LDAPS 集成。如果启用,请输入以下信息:
  • LDAPS URL
  • 绑定用户 DN
  • 绑定用户密码
  • 搜索库
  • 用户搜索筛选器
  • 组搜索筛选器
本地用户选择用户,然后单击更改密码以更改该用户的密码。

在客户端设置下,以下设置会影响 Horizon Recording Agent 的行为:

客户端设置描述
通知消息录制用户会话时向用户显示的消息。
按持续时间拆分录制启用/禁用
最长录制持续时间 停止录制并开始新录制之前的最长录制持续时间(以分钟为单位)。最小值为 30;最大值为 600。 注意:仅当启用按持续时间拆分录制选项时,才会显示此设置。
区块大小每个录制屏幕的 Horizon Recording Agent 上的缓冲区大小。填充此缓冲区后,会将数据提交至 Horizon Recording Server。
上载时间间隔尚未填充缓冲区时活动录制块将上载到服务器的时间长度。例如,如果将间隔设置为 5 分钟,并且尚未填充缓冲区,则在此时间段过后,会将当前录制屏幕数据上载到服务器,并创建一个新区块。此设置可确保在 Horizon Recording Agent 遇到故障时,丢失录制的时段较短。

在录制标准下,以下设置指示记录的会话类型:

录制标准描述
记录本地会话指示 Horizon Recording Agent 录制从 LAN 上的内部连接服务器代理的所有会话。
记录远程会话指示 Horizon Recording Agent 录制通过 Unified Access Gateway 代理的所有会话。
要录制的组列出要使用会话类型录制标准录制的特定用户组。如果不添加组,将评估所有用户以进行录制。

在本地服务器设置下,以下设置会影响当前连接到数据库的本地服务器。要更改本地服务器设置,请使用编辑部署向导(请参阅下文)。

本地服务器设置描述
数据库连接类型此本地服务器设置从本地服务器上的 servicesettings.json 文件读取。支持的数据库类型:
  • SQLite(本地文件)
  • MSSQL (Microsoft SQL) - 必须是与用作连接服务器事件数据库的相同版本的 MSSQL 数据库。
  • PostgreSQL - 必须是与用作连接服务器事件数据库的相同版本的 PostgreSQL 数据库。
如果不需要对数据库连接类型进行任何更改,请选择跳过以绕过数据库配置。
如果需要更改,请根据您的数据库类型按照以下说明进行操作:

MSSQL 数据库配置
选择“连接到现有数据库”或“连接到新数据库”
  • 如果用户想要使用现有数据库,请选择“连接到现有数据库”。如果用户尝试将当前 Recording Server 作为对等节点添加到集群中,则应选择此选项。
  • 如果用户想要使用新数据库,请选择“连接到新数据库”。如果当前服务器将是唯一的 Recording Server,或者它是集群中的第一个 Recording Server,且该集群将来可能会扩展,则应选择此选项。
提供数据库恢复密码
  • 如果在上面选择了“连接到现有数据库”,则此密码必须与首次配置此共享数据库时指定的数据库恢复密码相匹配。
  • 如果在上面选择了“连接到新数据库”,则请提供新的数据库恢复密码
在服务器丢失时,将使用此密码来恢复加密数据。请将其安全地存储在组织的密码保管库中。
如果需要使用密码身份验证建立连接,请执行以下操作:
  • 启用“数据库连接需要密码”,然后在提供的字段中输入密码。
  • 在“连接字符串”字段中,指定不含“密码”参数的连接字符串,因为密码已在上面的密码字段中指定。
例如: ``` User id=UserName;Server=servername.domain.local;Database=DatabaseName;Trusted_Connection=no;Encrypt=False ``` 如果需要在不使用密码(例如,集成 Windows 身份验证)的情况下建立连接,请执行以下操作:
  • 禁用“数据库连接需要密码”
  • 在“连接字符串”字段中,指定不含“用户 ID”和“密码”参数的连接字符串,因为不需要这些参数。
例如: ``` Server=servername.domain.local;Database=DatabaseName;Trusted_Connection=yes;Encrypt=False;TrustServerCertificate=True; ```
PostgreSQL 数据库配置
选择“连接到现有数据库”或“连接到新数据库”
  • 如果用户想要使用现有数据库,请选择“连接到现有数据库”。如果用户尝试将当前 Recording Server 作为对等节点添加到集群中,则应选择此选项。
  • 如果用户想要使用新数据库,请选择“连接到新数据库”。如果当前服务器将是唯一的 Recording Server,或者它是集群中的第一个 Recording Server,且该集群将来可能会扩展,则应选择此选项。
提供数据库恢复密码
  • 如果在上面选择了“连接到现有数据库”,则此密码必须与首次配置此共享数据库时指定的数据库恢复密码相匹配。
  • 如果在上面选择了“连接到新数据库”,则请提供新的数据库恢复密码。
在服务器丢失时,将使用此密码来恢复加密数据。请将其安全地存储在组织的密码保管库中。
如果需要使用密码身份验证建立连接,请执行以下操作:
  • 启用“数据库连接需要密码”,然后在密码字段中输入密码。
  • 在“连接字符串”字段中,指定不含“密码”参数的连接字符串,因为密码已在上面的密码字段中指定。
例如: ``` Host=servername.domain.local;Port=5432;Username=UserName;Database=DatabaseName; ``` 如果需要在不使用密码(例如,本地信任)的情况下建立连接,请执行以下操作:
  • 禁用“数据库连接需要密码”
  • 在“连接字符串”字段中,指定不含“用户名”和“密码”参数的连接字符串,因为不需要这些参数。
例如: ``` Host=servername.domain.local;Port=5432;Database=DatabaseName; ``` 注意:可以通过多种方式为 MSSQL 和 PostgreSQL 数据库设置无密码身份验证。根据您的配置,连接字符串中的键值参数可能会有所不同。请参阅相应的供应商文档,为您的设置指定适当的键值参数。
数据库连接字符串标识服务器实例和数据库连接。示例:Data Source=Local.db

在集群设置下,以下设置会影响连接到数据库的所有服务器。要更改集群存储位置,请使用编辑部署向导(请参阅下文)。

集群设置描述
记录存储文件夹Horizon Recording Server 在其中存储活动录制数据或已完成录制的文件夹的文件路径。此文件夹的位置取决于部署类型:NTFS 共享或本地。必须手动保护此文件夹。
加密录制启用/禁用
注意:启用此选项会先对录制进行加密,然后再将其存储到文件系统上。无法播放文件系统上的录制,因为它们已加密且采用的是 .bin 格式。只有可以登录到 Web 控制台的管理员用户才应能够查看和播放这些录制,因为只有在从 Web 控制台中请求播放它们时才会对其解密。
转换区块大小用于将活动录制转换为已完成录制的缓冲区大小。默认值为 10。
转换线程计数专用于将完成的原始录制转换为 MP4/二进制格式的线程数。请勿更改此值,除非要求这样做。
转换等待时间等待处理的录制转换在尝试将文件从活动状态转换为已完成状态之前需要等待的时间。默认值为 10 分钟。
原始文件此设置会同时影响 Horizon Recording Agent 和 Horizon Recording Server。
  • Horizon Recording Agent:指示代理在成功将数据上载到服务器后删除录制。
  • Horizon Recording Server:指示服务器在转换为 MP4 后保留原始文件。
默认情况下启用该设置。禁用此设置会危及文件的安全性。
保留设置录制在服务器上保留的天数,Web 服务会在该天数之后删除录制。锁定的录制将从保留规则中排除,但保留在服务器上。

将从本地计算机证书存储中检索 Horizon Recording Server 所使用的 SSL 证书。它具有友好名称和私钥。如果 SSL 证书不存在,则会在服务启动时创建该证书。要安装自定义证书,请将现有证书重命名为 HorizonRecordingServer,并将证书安装到计算机存储。重新启动 Horizon Recording Server 服务以使更改生效。

**注意:**SSL 证书必须受 Horizon Recording Agent 信任;否则您在安装期间添加的受信任指纹将不包含新证书的指纹。

您可以在安装目录的 servicesettings.json 文件中配置其他设置,例如 JWT 令牌超时和 SSL/TLS 端口。您必须在修改此文件之前停止此服务,并且这些设置将仅影响您修改的服务器。这些设置必须在加入集群的所有录制服务器上都匹配。

{
"HTTPSPort": 9443,
"DBConnectionString": "GlmrgliM0TpWt5nbC1RQyjoG]
"JWTTokenLifeSpan": 60,
"DBType": 1,
"ConnectionStringIsEncrypted": true
}

编辑部署向导

您可以使用编辑部署向导修改 Horizon Recording Server 设置。

修改 Horizon Recording Server 设置会影响本地服务器设置(如数据库连接)和集群存储位置。向导完成后,将重新启动本地 Web 服务以更新数据库。对存储位置所做的任何更改会立即影响集群中的所有服务器。

**注意:**修改部署时,绝不会迁移数据。将仅迁移服务配置和用户身份验证详细信息。确保在数据库中备份所有录制,方法是下载录制,然后提前删除会话,以避免产生不需要的数据。

另请注意以下内容:

  • 在独立模式下,如果没有正在进行的活动会话,您只能修改本地服务器的数据库连接。
  • 您可以选择数据库类型和连接字符串。这些设置将被加密并存储在服务器安装目录中的 servicesettings.json 文件。如果在连接字符串中指定的用户具有创建数据库的权限,则 Web 服务将创建数据库。否则,请预先创建具有所需名称的空数据库,并确认提供的帐户能够创建所需的表。
  • 帐户必须能够对数据库布局进行更改,以便在将来的升级中更改数据库模式,并且 Web 服务将自动执行迁移。
  • 在实例化数据库并迁移本地用户和设置后,将重新启动 Web 服务。
  • 修改集群的存储位置会立即影响集群中的所有服务器。发生活动录制时,请勿修改存储位置。修改存储位置时不会迁移数据。

日志记录

默认情况下,Horizon Recording Server 日志位于 C:\programdata\Omnissa\Horizon Recording 中。

对于 Windows 桌面,Horizon Recording Agent 日志位于 C:\programdata\Omnissa\Horizon Recording 中。

对于 Linux 桌面,Horizon Recording Agent 日志位于 /var/log/omnissa/horizonrecording 中。

要对任何问题进行故障排除,可以通过修改 NLog.config file 并将日志级别从“信息”更改为“跟踪”来扩展日志记录。

<rules>
    <!-- Web service loggers -->
    <logger name="Horizon.*" minlevel="Trace" writeTo="WebServiceLogging" final="true" />

  	<!-- ASP.NET Core / API framework loggers -->
    <logger name="Microsoft.AspNetCore.Hosting.Diagnostics" minlevel="Trace" writeTo="WebServiceLogging" final="true" />
    <logger name="Microsoft.AspNetCore.Mvc.Infrastructure.ControllerActionInvoker" minlevel="Trace" writeTo="WebServiceLogging" final="true" />

    <!-- Service life cycle loggers -->
    <logger name="Microsoft.Hosting.Lifetime" minlevel="Trace" writeTo="WebServiceLogging" final="true" />

    <!-- Ignore noisy Microsoft/System below Warn by NOT setting writeTo target -->
    <logger name="Microsoft.*" maxlevel="Trace" final="true" />
    <logger name="System.*" maxlevel="Trace" final="true" />

    <!-- Warn and above from Microsoft/System -->
    <logger name="Microsoft.*" minlevel="Warn" writeTo="FrameworkLogging" final="true" />
    <logger name="System.*" minlevel="Warn" writeTo="FrameworkLogging" final="true" />

    <!-- Everything else -->
    <logger name="*" minlevel="Trace" writeTo="FrameworkLogging" />
    <!--<logger name="*" minlevel="Trace" writeTo="syslog" />-->
  </rules>

注意:跟踪级别的日志记录会生成大量日志,并且可能会导致日志轮换加快。在收集所需的日志后,请将日志级别恢复为“信息”。

此页面对您有帮助吗?

对本主题提供反馈

本主题对您有帮助吗?

请勿填写任何个人信息或机密信息。

正在生成链接…