使用轻松安装创建非域加入的 Linux VDA

本文将指导您使用轻松安装方法，在 Citrix DaaS 或 Citrix Virtual Apps and Desktops™ 2407 及更高版本中创建并注册非域加入的 Linux VDA 到计算机目录中。

重要提示：

• 对于 Citrix 桌面即服务™ 客户：
  • 您可以在公共云或本地数据中心部署非域加入的 VDA。非域加入的 VDA 由 Citrix DaaS 中的控制平面管理。
  • 要创建非域加入的 VDA，使用 Citrix Gateway 服务的客户必须确保 Rendezvous V2 已启用。仅当您计划在本地管理程序上预配计算机或希望在 Workspace 中使用 Active Directory 作为身份提供程序时，才需要 Cloud Connector。
• 要创建非域加入的 VDA，您还可以使用 MCS。有关详细信息，请参阅 使用 MCS 创建非域加入的 Linux VDA。
  • MCS 不支持裸机服务器。
• 非域加入的 Linux VDA 提供以下功能：
  • 在非域加入的 VDA 上创建具有指定属性的本地用户
  • 非 SSO 身份验证
  • 使用 Azure 活动目录 进行身份验证
  • 会合 V2(/zh-cn/linux-virtual-delivery-agent/2511/configure/session/rendezvous-v2.html)

步骤 1：创建空计算机目录

登录到 Citrix Web Studio™ 并创建一个不包含任何计算机的空计算机目录。Linux VDA 不支持使用令牌文件注册到电源管理的计算机目录。

创建计算机目录和添加 Linux VDA 计算机的过程与传统的 Windows VDA 方法类似。有关如何完成这些任务的更详细说明，请参阅创建计算机目录和管理计算机目录。

对于包含 Linux VDA 计算机的计算机目录，存在一些限制，这些限制使该过程与为 Windows VDA 计算机创建计算机目录的过程有所不同：

• 对于操作系统，请选择：

  • 对于托管共享桌面交付模型，选择“多会话操作系统”选项。
  • 对于 VDI 专用桌面交付模型，选择“单会话操作系统”选项。
• 请勿在同一计算机目录中混合使用 Linux 和 Windows VDA 计算机。
• 请勿在同一计算机目录中混合使用已加入域和未加入域的计算机。
• 要创建令牌注册计算机目录，请在“计算机类型”页面上选择“单会话操作系统”或“多会话操作系统”，然后在“计算机管理”页面上选择“未进行电源管理的计算机（例如，物理机）”。

注意：

早期版本的 Citrix Studio 不支持“Linux 操作系统”的概念。但是，选择“Windows Server 操作系统”或“服务器操作系统”选项意味着等效的托管共享桌面交付模型。选择“Windows 桌面操作系统”或“桌面操作系统”选项意味着每个计算机一个用户的交付模型。

步骤 2：创建注册令牌

要使用简易安装创建未加入域的 VDA，您需要一个令牌文件来将 VDA 注册到计算机目录，并将 VDA 验证到云或本地交付控制器。Linux VDA 不支持使用令牌文件注册到电源管理的计算机目录。

要在 Citrix Web Studio 中创建注册令牌，请完成以下步骤：

提示：

在 思杰 DaaS 中，Web Studio 称为完整配置。

1. 选择您之前创建的空计算机目录，然后在操作栏中选择 管理注册令牌。

2. 在 管理注册令牌 页面上，单击 生成 以创建注册令牌。或者，您可以选择处于有效状态的现有令牌。

3. 请按照向导的指示完成相关设置。

4. 下载成功创建的令牌，并以最低权限将其保存在安全位置。稍后运行轻松安装脚本时，CTX_XDL_NDJ_ENROLLMENT_TOKEN_FILE 变量允许您指定令牌文件的路径以注册 VDA。

步骤 3：安装 .NET

除了 .NET 运行时，您必须在安装或升级 Linux VDA 之前，在所有受支持的 Linux 发行版上安装 .ASP.NET Core 运行时版本 8。

如果您的 Linux 发行版包含所需的 .NET 版本，请从内置源安装。否则，请从 Microsoft 包源安装 .NET。有关详细信息，请参阅 https://docs.microsoft.com/zh-cn/dotnet/core/install/linux-package-managers。

安装 .NET 后，运行 which dotnet 命令以查找运行时路径。

根据命令输出，设置 .NET 运行时二进制路径。例如，如果命令输出为 /aa/bb/dotnet，则使用 /aa/bb 作为 .NET 二进制路径。

步骤 4：添加自签名 CA 证书

有关配置自签名 CA 证书的详细信息，请参阅 为 WebSocket 配置自签名证书。本节涉及在 Linux VDA 上放置和更新 CA 证书。

• For RHEL and Rocky Linux:

  将自签名 CA 证书保存到 Linux VDA 上的 /etc/pki/ca-trust/source/anchors 目录，然后运行以下命令更新证书：

   sudo update-ca-trust
   <!--NeedCopy-->
  

• 对于 SUSE、乌班图和德比安：

  Place the root CA certificate in the /usr/local/share/ca-certificates directory. Then, run the update-ca-certificate command.

   sudo update-ca-certificates
   <!--NeedCopy-->
  

步骤 5：下载 Linux VDA 软件包

1. 转到 思杰虚拟应用和桌面下载页面。
2. 展开相应版本的思杰虚拟应用和桌面™。

3. 展开 组件 以查找 Linux VDA。例如：

   

4. 点击 Linux 虚拟投递代理链接以访问 Linux 虚拟投递代理下载。

   

5. 下载与您的 Linux 发行版匹配的 Linux VDA 软件包。

6. 下载 GPG 公钥，您可以使用它来验证 Linux VDA 软件包的完整性。例如：

   

   要使用公钥验证 Linux VDA 软件包的完整性：

   • 对于 RPM 软件包，运行以下命令将公钥导入 RPM 数据库并检查软件包完整性：

      rpmkeys --import <path to the public key>
      rpm --checksig --verbose <path to the Linux VDA package>
      <!--NeedCopy-->
     

   • 对于 DEB 软件包，运行以下命令将公钥导入 DEB 数据库并检查软件包完整性：

      sudo apt-get install dpkg-sig
      gpg --import <path to the public key>
      dpkg-sig --verify <path to the Linux VDA package>
      <!--NeedCopy-->
     

步骤 6：安装 Linux VDA 软件包

要为 Linux VDA 设置环境，请运行以下命令。

For RHEL and Rocky Linux distributions:

注意：

• 对于 RHEL 和 CentOS，请在成功安装 Linux VDA 之前安装 EPEL 存储库。有关如何安装 EPEL 的信息，请参阅 https://docs.fedoraproject.org/zh-cn/epel/ 处的说明。

• 在 RHEL 9.x 和 Rocky Linux 9.x 操作系统上安装 Linux VDA 之前，请将 libsepol 软件包更新到版本 3.4 及更高版本。

sudo yum  -y localinstall   <PATH>/<Linux VDA RPM>
<!--NeedCopy-->

注意：

在 GCP 上托管的 RHEL 8.x/9.x 和 Rocky Linux 8.x/9.x 上安装 Linux VDA 后，以太网连接可能会丢失，并且在 VM 重启后 Linux VDA 可能无法访问。要解决此问题，请在首次登录 VM 时设置 root 密码，并确保您可以以 root 身份登录 VM。然后，在重启 VM 后，在控制台中运行以下命令：

nmcli dev connect eth0
systemctl restart NetworkManager
<!--NeedCopy-->

对于 Ubuntu/Debian 这样的分发版本：

sudo dpkg -i <PATH>/<Linux VDA deb>
sudo apt-get install -f
<!--NeedCopy-->

注意：

• 要为 Debian 11 发行版安装必要的依赖项，请将 deb http://deb.debian.org/debian/ bullseye main 行添加到 /etc/apt/sources.list 文件中。

• For Ubuntu 24.04/22.04 on GCP, disable RDNS. To do so, add the rdns = false line under [libdefaults] in /etc/krb5.conf.

适用于 SUSE 发行版：

1. 对于在亚马逊网络服务、Azure 和谷歌云平台上的 SUSE 15.6，请确保：

   • 您正在使用 libstdc++6 版本 12 或更高版本。
   • The Default_WM parameter in /etc/sysconfig/windowmanager is set to “gnome”.

2. 运行以下命令以安装 Linux VDA：

   zypper -i install <PATH>/<Linux VDA RPM>
   <!--NeedCopy-->
   

步骤 7：安装 NVIDIA GRID 驱动程序

要启用 HDX™ 3D Pro，您需要在管理程序和 VDA 计算机上安装 NVIDIA GRID 驱动程序。

要在特定管理程序上安装和配置 NVIDIA GRID 虚拟 GPU 管理器（主机驱动程序），请参阅以下指南：

• 思杰 管理程序
• 威睿 易思艾克斯
• 能腾 阿赫维

要安装和配置 NVIDIA GRID 客户机 VM 驱动程序，请执行以下常规步骤：

1. 确保客户机 VM 已关闭。
2. 在管理程序控制面板中，为 VM 分配一个 GPU。
3. 启动 VM。
4. 在 VM 上安装客户机 VM 驱动程序（从您的云供应商或 NVIDIA 获取）。

步骤 8：指定要使用的数据库

在安装 Linux VDA 软件包后，您可以通过编辑 /etc/xdl/db.conf 文件来指定使用 SQLite 或 PostgreSQL 数据库。

To do so, edit /etc/xdl/db.conf before running sudo /opt/Citrix/VDA/sbin/ctxinstall.sh or /opt/Citrix/VDA/bin/easyinstall.

注意：

• 我们建议您仅在 VDI 模式下使用 SQLite。
• 对于轻松安装和 MCS，您可以指定使用 SQLite 或 PostgreSQL，而无需手动安装它们。除非通过 /etc/xdl/db.conf 另行指定，否则 Linux VDA 默认使用 PostgreSQL。
• 您还可以使用 /etc/xdl/db.conf 用于配置 PostgreSQL 数据库的端口号。

步骤 9：运行轻松安装脚本以配置环境和 VDA 以完成安装

安装 Linux VDA 软件包后，使用 ctxinstall.sh 脚本配置运行环境。

注意：

在设置运行时环境之前，请确保您的操作系统中已安装 en_US.UTF-8 区域设置。如果您的操作系统中没有该区域设置，请运行 sudo locale-gen en_US.UTF-8 命令。对于 Debian，请编辑 /etc/locale.gen 文件，取消注释 # en_US.UTF-8 UTF-8 行，然后运行 sudo locale-gen 命令。

ctxinstall.sh

ctxinstall.sh 是一个轻松安装脚本，用于执行一些预配置并设置 VDA 运行环境变量。

• 只有 root 用户才能运行此脚本。

• 轻松安装使用 /opt/Citrix/VDA/sbin/ctxinstall.conf 作为其配置文件，用于设置、保存和同步所有使用的环境变量的值。我们建议您仔细阅读模板 (ctxinstall.conf.tmpl)，然后自定义您自己的 ctxinstall.conf。首次创建配置文件时，请使用以下任一方法：
  • By copying the /opt/Citrix/VDA/sbin/ctxinstall.conf.tmpl template file and saving it as /opt/Citrix/VDA/sbin/ctxinstall.conf.
  • By running ctxinstall.sh. Each time you run ctxinstall.sh, your input is saved in /opt/Citrix/VDA/sbin/ctxinstall.conf.

• 轻松安装支持模块化运行。模块包括预检查、安装、域配置、设置和验证。

• 此脚本的调试详细信息可在 /var/log/xdl/ctxinstall.log 中找到。

有关详细信息，请使用帮助命令 ctxinstall.sh -h。

注意：

• 遵循最小权限原则，确保只有 root 用户可以读取 /opt/Citrix/VDA/sbin/ctxinstall.conf，因为该文件中可能设置了域加入密码。
• 卸载 Linux VDA 将会移除 /opt/Citrix/VDA 路径下的所有相关文件。我们强烈建议您在执行 VDA 卸载操作之前，务必备份 /opt/Citrix/VDA/sbin/ctxinstall.conf 配置文件。

您可以在交互模式或静默模式下运行 ctxinstall.sh。运行脚本之前，请设置以下环境变量：

• CTX_XDL_NON_DOMAIN_JOINED=’y|n’ – 是否将计算机加入 域。默认值为“n”。对于未加入域的场景，请将其设置为“y”。

• CTX_XDL_NDJ_ENROLLMENT_TOKEN_FILE=’<path-to-token-file-on-vda-machine>‘ – 要使用简易安装创建未加入域的 VDA，您需要一个令牌文件才能将 VDA 注册到交付控制器的计算机目录中。请以最小权限将令牌保存在安全位置。

• CTX_XDL_VDI_MODE=’y|n’ – 是将计算机配置为专用桌面交付模型 (VDI) 还是托管共享桌面交付模型。对于 HDX 3D Pro 环境，请将该值设置为“y”。

• CTX_XDL_HDX_3D_PRO=’y|n’ – Linux VDA 支持 HDX 3D Pro，这是一组旨在优化富图形应用程序虚拟化的 GPU 加速技术。如果选择 HDX 3D Pro，VDA 将配置为 VDI 桌面（单会话）模式 -（即 CTX_XDL_VDI_MODE=’y’）。

• CTX_XDL_START_SERVICE=’y|n’ – 此参数用于确定在完成配置过程之后，Linux VDA 的相关服务是否应该自动启动。

• CTX_XDL_REGISTER_SERVICE=’y|n’ – 此设置控制 Linux 虚拟桌面服务是否在机器启动后自动启动。

• CTX_XDL_ADD_FIREWALL_RULES=’y|n’ – Linux VDA 服务要求允许传入网络连接通过系统防火墙。您可以自动在系统防火墙中为 Linux Virtual Desktop 打开所需的端口（默认情况下为端口 80 和 1494）。

• CTX_XDL_DESKTOP_ENVIRONMENT=gnome/gnome-classic/mate – 指定会话中使用的格诺姆、格诺姆经典版或马特桌面环境。如果未指定该变量，则使用 VDA 上配置的默认桌面。

• CTX_XDL_DESKTOP_ENVIRONMENT=gnome/gnome-classic/kde/mate/xfce/’<none>‘ – 指定在会话中使用的 GNOME、GNOME Classic、KDE、MATE 或 Xfce 桌面环境。如果将其设置为“’<none>‘”，则使用 VDA 上配置的默认桌面。您可以使用 CTX_XDL_DESKTOP_ENVIRONMENT 变量指定在会话中使用的桌面环境。您还可以通过运行命令或使用系统托盘在桌面环境之间切换。有关详细信息，请参阅桌面切换命令和系统托盘。

• CTX_XDL_DOTNET_RUNTIME_PATH=’<path-to-install-dotnet-runtime>‘ – The path to install .NET for supporting the new broker agent service (ctxvda). The default path is ‘/usr/bin’.

• CTX_XDL_VDA_PORT=’<port-number>‘ – The Linux VDA communicates with Delivery Controllers through a TCP/IP port.

交互模式

要以交互模式运行 ctxinstall.sh 脚本，请使用不带 -S 选项的 sudo /opt/Citrix/VDA/sbin/ctxinstall.sh 命令。在命令行界面中的每个提示符处键入相关的变量值。如果变量已设置，ctxinstall.sh 会询问您是否要更改它以进行确认。

静默模式

在静默模式下，您必须使用 /opt/Citrix/VDA/sbin/ctxinstall.conf 或 export 命令设置上述变量。之后，运行 ctxinstall.sh -S（请注意，这里的字母 S 为大写）。如果并非所有必需变量都已设置或某些值无效，ctxinstall.sh 将中止执行，除非存在默认值。

如果您设置了此项，则每个变量的导出值将自动覆盖 /Citrix/VDA/sbin/ctxinstall.conf 文件中当前配置的值。所有经过更新的值都将最终保存到 /Citrix/VDA/sbin/ctxinstall.conf 文件中。

export CTX_XDL_NON_DOMAIN_JOINED='y'
export CTX_XDL_NDJ_ENROLLMENT_TOKEN_FILE='<token-file-path>'
export CTX_XDL_VDI_MODE='y|n'
export CTX_XDL_START_SERVICE='y|n'
export CTX_XDL_REGISTER_SERVICE='y|n'
export CTX_XDL_ADD_FIREWALL_RULES='y|n'
export CTX_XDL_HDX_3D_PRO='y|n'
export CTX_XDL_DESKTOP_ENVIRONMENT=gnome|gnome-classic|kde|mate|xfce|'<none>'
export CTX_XDL_DOTNET_RUNTIME_PATH='<path-to-install-dotnet-runtime>'
export CTX_XDL_VDA_PORT='<port-number>'
sudo -E /opt/Citrix/VDA/sbin/ctxinstall.sh -S
<!--NeedCopy-->

运行 sudo 命令时，键入 -E 选项以将现有环境变量传递给它创建的新 shell。建议您使用上述命令创建一个 shell 脚本文件，并将 #!/bin/bash 作为第一行。

或者，您可以使用单个命令指定所有变量。

要设置 VDA 运行环境变量（以“CTX_XDL_”开头的变量），您可以运行 ctxinstall.sh -s（请注意，这里的字母 s 为小写）。

步骤 10：运行 XDPing

运行 sudo /opt/Citrix/VDA/bin/xdping 以检查 Linux VDA 环境中的常见配置问题。有关详细信息，请参阅 XDPing。

步骤 11：运行 Linux VDA 实例

启动 Linux 虚拟投递代理：

要启动 Linux 虚拟投递代理服务：

sudo systemctl start ctxhdx.service

sudo systemctl start ctxvda.service
<!--NeedCopy-->

停止 Linux 虚拟桌面代理：

要停止 Linux VDA 服务，请执行以下操作：

sudo systemctl stop ctxvda.service

sudo systemctl stop ctxhdx.service
<!--NeedCopy-->

注意：

在停止 ctxvda 和 ctxhdx 服务之前，请运行 systemctl stop ctxmonitord 命令停止监视服务守护程序。否则，监视服务守护程序会重新启动您已停止的服务。

重新启动 Linux 虚拟桌面代理：

要重新启动 Linux VDA 服务，请执行以下操作：

sudo systemctl stop ctxvda.service

sudo systemctl restart ctxhdx.service

sudo systemctl start ctxvda.service
<!--NeedCopy-->

检查 Linux VDA 实例的状态：

要检查 Linux VDA 服务的运行状态，请执行以下操作：

sudo systemctl status ctxvda.service

sudo systemctl status ctxhdx.service
<!--NeedCopy-->

步骤 12：创建交付组

创建交付组和添加包含 Linux VDA 计算机的计算机目录的过程与 Windows VDA 计算机几乎相同。有关如何完成这些任务的详细说明，请参阅创建交付组。

对于创建包含 Linux VDA 计算机目录的交付组，适用以下限制：

• 确保您选择的 AD 用户和组已正确配置为登录到 Linux VDA 计算机。
• 不允许未经身份验证（匿名）的用户登录。
• 请勿将交付组与包含 Windows 计算机的计算机目录混合使用。

重要：

Linux VDA 1.4 版及更高版本支持发布应用程序。但是，Linux VDA 不支持将桌面和应用程序交付到同一台计算机。

有关如何创建计算机目录和交付组的信息，请参阅 Citrix Virtual Apps and Desktops 7 2503。

步骤 13: 启用本地帐户映射

如果未启用本地帐户映射会怎样

在未加入域的 VDA 上托管的会话登录失败，显示密码提示但不接受正确的密码。在 hdx.log 中可以找到与以下内容类似的错误：

2024-09-25 06:40:30.767979 [LOGIN_BOX:ERROR] <P124211:T58675:S4> citrix-ctxlogin: PamAuthenticate: pam authentication: Authentication failure. Can retry for user 'user3'
2024-09-25 06:40:30.768431 [LOGIN:ERROR] <P124211:T58675:S4> citrix-ctxlogin: LoginBoxValidate: Failed to validate user 'user3'. Due to INVALID_PASSWORD
2024-09-25 06:40:30.768947 [LOGIN_AUTH:INFO] <P124218:T58682:S4> citrix-ctxloginui: CalLabelFormat: Update username label on LoginUI from 'user3' to 'user3' (18)
2024-09-25 06:41:18.766196 [GFX_SLIDER:ERROR] <P124161:T58699:S4> citrix-ctxgfx: GfxCreateSliderListener: Failed to get user home dir.
<!--NeedCopy-->

启用本地帐户映射

为确保用户可以登录到未加入域的 Linux VDA，请使用以下命令启用本地帐户映射：

Set-BrokerDesktopGroup -Name "<your delivery group name>" -MachineLogOnType LocalMappedAccount
<!--NeedCopy-->

对于本地部署，请直接在交付控制器上运行该命令。对于 Citrix DaaS 部署，请通过 Citrix Virtual Apps 和 Desktops 远程 PowerShell SDK 运行该命令。