在 Debian 上手动安装 Linux 虚拟桌面代理
重要提示：
对于全新安装，我们建议您使用 easy install 进行快速安装。Easy install 比本文中详述的手动安装更省时省力，且不易出错。
步骤 1：准备配置信息和 Linux 计算机
步骤 1a：设置主机名
为确保正确报告计算机的主机名，请更改 /etc/hostname 文件，使其仅包含计算机的主机名。
hostname
步骤 1b：为主机名分配环回地址
确保正确报告计算机的 DNS 域名和完全限定域名 (FQDN)。方法是更改 /etc/hosts 文件的以下行，以将 FQDN 和主机名作为前两个条目包括在内：
127.0.0.1 hostname-fqdn hostname localhost
例如：
127.0.0.1 vda01.example.com vda01 localhost
从文件中的其他条目中删除对 hostname-fqdn 或 hostname 的任何其他引用。
注意：
Linux VDA 当前不支持 NetBIOS 名称截断。主机名不得超过 15 个字符。
提示：
仅使用 a–z、A–Z、0–9 和连字符 (-) 字符。避免使用下划线 (_)、空格和其他符号。主机名不能以数字开头，也不能以连字符结尾。此规则也适用于 Delivery Controller 主机名。
步骤 1c：检查主机名
重新启动计算机并验证主机名是否已正确设置：
hostname
<!--NeedCopy-->
此命令仅返回计算机的主机名，而非其 FQDN。
验证 FQDN 是否已正确设置：
hostname -f
<!--NeedCopy-->
此命令返回计算机的 FQDN。
步骤 1d：禁用多播 DNS
默认设置已启用多播 DNS (mDNS)，这可能会导致名称解析结果不一致。
要禁用 mDNS 功能，请编辑 /etc/nsswitch.conf 文件，并修改其中的以下行：
hosts: files mdns_minimal [NOTFOUND=return] dns
更改为：
hosts: files dns
步骤 1e：检查名称解析和服务可达性
验证您是否能够解析 FQDN，并 ping 通域控制器和交付控制器™：
nslookup domain-controller-fqdn
ping domain-controller-fqdn
nslookup delivery-controller-fqdn
ping delivery-controller-fqdn
<!--NeedCopy-->
如果您无法解析 FQDN 或 ping 通其中任何一台计算机，请在继续操作之前检查这些步骤。
步骤 1f：配置时钟同步 (chrony)
保持 VDA、Delivery Controller 和域控制器之间准确的时钟同步至关重要。将 Linux VDA 作为虚拟机 (VM) 托管可能会导致时钟偏差问题。因此，首选与远程时间服务同步时间。
安装 chrony 服务：
apt-get install chrony
<!--NeedCopy-->
以 root 用户身份，编辑 /etc/chrony/chrony.conf 并为每个远程时间服务器添加一个服务器条目：
server peer1-fqdn-or-ip-address iburst
server peer2-fqdn-or-ip-address iburst
在典型部署中，应从本地域控制器同步时间，而不是直接从公共 NTP 池服务器同步。为域中的每个 Active Directory 域控制器添加一个服务器条目。
删除所有其他列出的 server 或 pool 条目，包括环回 IP 地址、localhost 和公共服务器 *.pool.ntp.org 条目。
保存更改并重新启动 Chrony 守护程序：
sudo systemctl restart chrony
<!--NeedCopy-->
步骤 1g：安装软件包
sudo apt-get install -y libsasl2-2
sudo apt-get install -y libgtk2.0-0
<!--NeedCopy-->
步骤 1h：添加存储库以安装必要的依赖项
For Debian 11, add the deb http://deb.debian.org/debian/ bullseye main line to the /etc/apt/sources.list file.
步骤 1i：安装并指定要使用的数据库
注意：
我们建议您仅在 VDI 模式下使用 SQLite，并为托管共享桌面交付模型使用 PostgreSQL 或内置注册表服务。
对于简易安装和 MCS，您可以指定使用 SQLite、PostgreSQL 或内置注册表服务，而无需手动安装它们。除非通过 /etc/xdl/db.conf 另行指定，否则 Linux VDA 默认使用内置注册表服务。如果您需要自定义版本的 PostgreSQL 而不是 Linux 发行版提供的版本，则必须手动安装指定版本，编辑
/etc/xdl/db.conf以反映新版本，并在运行简易安装脚本 (ctxinstall.sh) 或 MCS 脚本 (deploymcs.sh) 之前启动 PostgreSQL 服务。对于手动安装，您必须手动安装 SQLite、PostgreSQL 或两者，或者内置注册表服务相关的依赖项。您可以使用自定义版本的 PostgreSQL，而不是 Linux 发行版提供的版本。如果您同时安装了 SQLite 和 PostgreSQL，则可以在安装 Linux VDA 软件包后，通过编辑 /etc/xdl/db.conf 来指定使用其中一个。
Install PostgreSQL
本节介绍如何安装 Linux 发行版提供的 PostgreSQL 版本。如果需要自定义版本的 PostgreSQL，您可以根据您的特定要求进行安装。
运行以下命令安装 PostgreSQL：
sudo apt-get update
sudo apt-get install -y postgresql
sudo apt-get install -y libpostgresql-jdbc-java
<!--NeedCopy-->
运行以下命令以分别在计算机启动时或立即启动 PostgreSQL：
sudo systemctl enable postgresql
sudo systemctl start postgresql
<!--NeedCopy-->
安装 SQLite 数据库
对于 Debian，运行以下命令安装 SQLite：
sudo apt-get install -y sqlite3
<!--NeedCopy-->
安装内置注册表服务
运行以下命令安装内置注册表服务相关的依赖项：
sudo apt-get install -y liblmdb0
<!--NeedCopy-->
指定要使用的数据库
如果您同时安装了 SQLite、PostgreSQL 和内置注册表服务，则可以在安装 Linux VDA 软件包后，通过编辑 /etc/xdl/db.conf 来指定使用其中一个。
- 请运行 /opt/Citrix/VDA/sbin/ctxcleanup.sh。如果这是全新的安装，那么您可以选择跳过此步骤。
-
编辑 /etc/xdl/db.conf 以指定要使用的数据库。以下是 db.conf 文件的示例：
# database configuration file for Linux VDA ## database choice # possible choices are: # SQLite # PostgreSQL # ctxregd - use the built-in registry service # default choice is ctxregd DbType="ctxregd" ## database port # specify database port for the database. # if not specified, default port will be used: # SQLite: N/A # PostgreSQL: 5432 DbPort=5432 ## PostgreSQL customized # only the following value means true, otherwise false: # true # yes # y # YES # Y # default is false DbCustomizePostgreSQL=false ## PostgreSQL service name # specify the service name of PostgreSQL for Linux VDA # default is "postgresql" DbPostgreSQLServiceName="postgresql" <!--NeedCopy-->为了能够使用自定义版本的 PostgreSQL 数据库，您需要将 DbCustomizePostgreSQL 的值设置为布尔值 true。
- Run ctxsetup.sh.
注意：
您还可以使用 /etc/xdl/db.conf 文件来配置 PostgreSQL 的端口号。
步骤 2: 准备管理程序
在受支持的管理程序上将 Linux VDA 作为 VM 运行时，需要进行一些更改。请根据所使用的管理程序平台进行以下更改。如果您在裸机硬件上运行 Linux 计算机，则无需进行任何更改。
Fix time synchronization on XenServer (formerly Citrix Hypervisor™)
启用 XenServer® 时间同步功能后，在每个半虚拟化 Linux VM 中，您会遇到 NTP 和 XenServer 的问题。两者都尝试管理系统时钟。为避免时钟与其他服务器不同步，请确保每个 Linux 访客中的系统时钟与 NTP 同步。此情况需要禁用主机时间同步。在 HVM 模式下无需进行任何更改。
如果您正在运行安装了 XenServer VM Tools 的半虚拟化 Linux 内核，您可以从 Linux VM 中检查 XenServer 时间同步功能是否存在并已启用：
su -
cat /proc/sys/xen/independent_wallclock
<!--NeedCopy-->
此命令返回 0 或 1：
- 0 - 时间同步功能已启用，必须禁用。
- 1 - 时间同步功能已禁用，无需进一步操作。
If the /proc/sys/xen/independent_wallclock file is not present, the following steps are not required.
如果已启用，请通过将 1 写入文件来禁用时间同步功能：
sudo echo 1 > /proc/sys/xen/independent_wallclock
<!--NeedCopy-->
要使此更改在重启后永久生效，请编辑 /etc/sysctl.conf 文件 并添加以下行：
xen.independent_wallclock = 1
要验证这些更改，请重新启动系统：
su -
cat /proc/sys/xen/independent_wallclock
<!--NeedCopy-->
此命令返回值为 1。
Fix time synchronization on Microsoft Hyper-V
安装了 Hyper-V Linux 集成服务的 Linux 虚拟机可以使用 Hyper-V 时间同步功能来使用主机操作系统的时钟。为确保系统时钟保持准确，请在启用 NTP 服务的同时启用此功能。
从管理操作系统执行以下操作：
- 打开 Hyper-V 管理器控制台。
- 对于 Linux 虚拟机的设置，选择 集成服务。
- 确保已选择 时间同步。
注意：
此方法与 VMware 和 XenServer（以前称为 Citrix Hypervisor）不同，在 VMware 和 XenServer 中，为避免与 NTP 冲突，会禁用主机时间同步。Hyper-V 时间同步可以与 NTP 时间同步共存并对其进行补充。
修复 ESX 和 ESXi 上的时间同步
当启用 VMware 时间同步功能时，在每个半虚拟化 Linux 虚拟机中，您会遇到 NTP 和管理程序的问题。两者都尝试同步系统时钟。为避免时钟与其他服务器不同步，请确保每个 Linux 访客中的系统时钟与 NTP 同步。此情况需要禁用主机时间同步。
如果您正在运行安装了 VMware Tools 的半虚拟化 Linux 内核：
- 打开 vSphere 客户端。
- 编辑 Linux 虚拟机的设置。
- 在“虚拟机属性”对话框中，打开“选项”选项卡。
- 选择 VMware 工具。
- 在“高级”框中，取消选中“将客户机时间与主机同步”。
步骤 3：将 Linux 虚拟机添加到 Windows 域
以下方法可用于将 Linux 计算机添加到 Active Directory (AD) 域：
根据您选择的方法遵循说明。
注意：
当 Linux VDA 中的本地帐户和 AD 中的帐户使用相同的用户名时，会话启动可能会失败。
桑巴 温拜德
安装或更新所需的软件包
sudo apt-get install winbind samba libnss-winbind libpam-winbind krb5-config krb5-locales krb5-user
<!--NeedCopy-->
启用 Winbind 守护程序在计算机启动时启动
必须将 Winbind 守护程序配置为在计算机启动时启动：
sudo systemctl enable winbind
<!--NeedCopy-->
注意：
确保
winbind脚本位于/etc/init.d下。
配置 凯柏罗斯
以 root 用户身份打开 /etc/krb5.conf，并进行以下设置：
注意：
根据您的 AD 基础结构配置 Kerberos。以下设置适用于单域、单林模型。
[libdefaults]
default_realm = REALM
dns_lookup_kdc = false
[realms]
REALM = {
admin_server = domain-controller-fqdn
kdc = domain-controller-fqdn
}
[domain_realm]
domain-dns-name = REALM
.domain-dns-name = REALM
在此上下文中，domain-dns-name 参数是 域名系统 域名，例如 example.com。REALM 是大写的 凯柏罗斯 领域名称，例如 EXAMPLE.COM。
配置 Winbind 身份验证
请使用 vim /etc/samba/smb.conf 命令来打开 /etc/samba/smb.conf 配置文件。完成打开操作后，请根据以下说明进行必要的配置设置：
[global]
workgroup = WORKGROUP
security = ADS
realm = REALM
encrypt passwords = yes
idmap config *:range = 16777216-33554431
kerberos method = secrets and keytab
winbind refresh tickets = yes
template shell = /bin/bash
WORKGROUP 是 REALM 中的第一个字段，而 REALM 是一个大写的 Kerberos 领域名称。
配置 nsswitch 相关设置
打开 /etc/nsswitch.conf 文件，然后将 winbind 内容附加到以下行中：
passwd: files systemd winbind
group: files systemd winbind
加入到 Windows 域中
您的域控制器必须可访问，并且您必须拥有一个具有将计算机添加到域权限的 Active Directory 用户帐户：
sudo net ads join <Kerberos realm name in uppercase> -U <domain user with permission to add computers to the domain>
<!--NeedCopy-->
重新启动 Winbind 服务
sudo systemctl restart winbind
<!--NeedCopy-->
配置 Winbind 的可插拔身份验证模块 (PAM)
运行以下命令，并确保选中 Winbind NT/Active Directory 身份验证和登录时创建主目录选项：
sudo pam-auth-update
<!--NeedCopy-->
提示：
仅当计算机加入域时，winbind 守护程序才会保持运行。
验证域成员身份
Delivery Controller 要求所有 VDA 计算机（无论是 Windows 还是 Linux）在 Active Directory 中都有一个计算机对象。
运行 Samba 的 net ads 命令以验证计算机是否已加入域：
sudo net ads testjoin
<!--NeedCopy-->
运行以下命令以验证额外的域和计算机对象信息：
sudo net ads info
<!--NeedCopy-->
验证科尔贝罗斯配置
要验证 Kerberos 是否已正确配置以与 Linux VDA 配合使用，请验证系统 keytab 文件是否已创建并包含有效密钥：
sudo klist -ke
<!--NeedCopy-->
此命令显示可用于主体名称和密码套件的各种组合的密钥列表。运行 Kerberos kinit 命令以使用这些密钥向域控制器验证计算机身份：
sudo kinit -k MACHINE\$@REALM
<!--NeedCopy-->
计算机和领域名称必须以大写形式指定。美元符号 ($) 必须用反斜杠 (\) 转义，以防止 shell 替换。在某些环境中，DNS 域名与 Kerberos 领域名称不同。请确保使用领域名称。如果此命令成功，则不显示任何输出。
使用以下命令验证计算机帐户的 TGT 票证是否已缓存：
sudo klist
<!--NeedCopy-->
使用以下命令检查计算机的帐户详细信息：
sudo net ads status
<!--NeedCopy-->
验证用户身份验证
使用 wbinfo 工具验证域用户是否可以向域进行身份验证：
wbinfo --krb5auth=domain\\username%password
<!--NeedCopy-->
此处指定的域是 AD 域名，而不是 Kerberos 领域名称。对于 bash shell，反斜杠 (\) 字符必须用另一个反斜杠转义。此命令返回指示成功或失败的消息。
要验证 Winbind PAM 模块是否已正确配置，请使用以前未使用的域用户帐户登录到 Linux VDA。
ssh localhost -l domain\\username
id -u
<!--NeedCopy-->
注意：
要成功运行 SSH 命令，请确保 SSH 已启用并正常工作。
验证是否为 id -u 命令返回的 uid 创建了相应的 Kerberos 凭据缓存文件：
ls /tmp/krb5cc_uid
<!--NeedCopy-->
验证用户 Kerberos 凭据缓存中的票证是否有效且未过期：
klist
<!--NeedCopy-->
退出会话。
exit
<!--NeedCopy-->
通过直接登录 Gnome 或 KDE 控制台，可以执行类似的测试。在完成域加入验证后，继续执行(/zh-cn/linux-virtual-delivery-agent/current-release/installation-overview/manual-installation-overview/debian.html#step-6-install-the-linux-vda)。
提示：
如果您成功通过用户身份验证，但使用域帐户登录时无法显示桌面，请重新启动计算机并重试。
Quest 身份验证服务
在域控制器上配置 Quest
假设您已在 Active Directory 域控制器上安装并配置了 Quest 软件，并且已获得在 Active Directory 中创建计算机对象的管理权限。
启用域用户登录 Linux VDA 计算机
要使域用户能够在 Linux VDA 计算机上建立 HDX™ 会话，请执行以下操作：
- 在 Active Directory 用户和计算机管理控制台中，打开该用户帐户的 Active Directory 用户属性。
- 选择Unix 帐户选项卡。
- 选中启用 Unix。
- 将主 GID 号设置为实际域用户组的组 ID。
注意：
这些说明等同于使用控制台、RDP、SSH 或任何其他远程协议设置域用户登录的说明。
在 Linux VDA 上配置奎斯特
解决 SELinux 策略强制执行问题
默认的 RHEL 环境会完全强制执行 SELinux。此强制执行会干扰 Quest 使用的 Unix 域套接字 IPC 机制，并阻止域用户登录。
解决此问题的便捷方法是禁用 SELinux。作为 root 用户，编辑 /etc/selinux/config 并更改 SELinux 设置：
SELINUX=disabled
此更改需要重新启动计算机：
reboot
<!--NeedCopy-->
重要：
请谨慎使用此设置。禁用后重新启用 SELinux 策略强制执行可能会导致完全锁定，即使是 root 用户和其他本地用户也无法登录。
配置 VAS 守护程序
必须启用 Kerberos 票证的自动续订并断开连接。必须禁用身份验证（脱机登录）：
sudo /opt/quest/bin/vastool configure vas vasd auto-ticket-renew-interval 32400
sudo /opt/quest/bin/vastool configure vas vas_auth allow-disconnected-auth false
<!--NeedCopy-->
此命令将续订间隔设置为九小时（32,400 秒），比默认的 10 小时票证有效期少一小时。在票证有效期较短的系统上，请将此参数设置为较低的值。
Configure PAM and NSS
要通过 HDX 和其他服务（例如 su、ssh 和 RDP）启用域用户登录，请运行以下命令手动配置 PAM 和 NSS：
sudo /opt/quest/bin/vastool configure pam
sudo /opt/quest/bin/vastool configure nss
<!--NeedCopy-->
加入微软 Windows 域
使用 Quest vastool 命令将 Linux 计算机加入活动目录域：
sudo /opt/quest/bin/vastool -u user join domain-name
<!--NeedCopy-->
该用户是具有将计算机加入 Active Directory 域权限的任何域用户。domain-name 是域的 DNS 名称，例如 example.com。
加入域后，重新启动 Linux 计算机。
验证域成员身份
Delivery Controller 要求所有 VDA 计算机（无论是 Windows 还是 Linux）在 Active Directory 中都具有计算机对象。要验证已加入 Quest 的 Linux 计算机是否在域中，请执行以下操作：
sudo /opt/quest/bin/vastool info domain
<!--NeedCopy-->
如果计算机已加入域，此命令将返回域名。如果计算机未加入任何域，则会显示以下错误：
ERROR: No domain could be found.
ERROR: VAS_ERR_CONFIG: at ctx.c:414 in _ctx_init_default_realm
default_realm not configured in vas.conf. Computer may not be joined to domain
验证用户身份验证
要验证 Quest 是否可以通过 PAM 验证域用户身份，请使用以前未曾使用过的域用户帐户登录到 Linux VDA。
ssh localhost -l domain\\username
id -u
<!--NeedCopy-->
验证是否已为 id -u 命令返回的 UID 创建了相应的 Kerberos 凭据缓存文件：
ls /tmp/krb5cc_uid
<!--NeedCopy-->
验证 Kerberos 凭据缓存中的票证是否有效且未过期：
/opt/quest/bin/vastool klist
<!--NeedCopy-->
退出会话。
exit
<!--NeedCopy-->
在域加入验证后，继续执行 步骤 6：安装 Linux VDA。
森特利直接控制
加入视窗域
With the Centrify DirectControl Agent installed, join the Linux machine to the Active Directory domain using the Centrify adjoin command:
su –
adjoin -w -V -u user domain-name
<!--NeedCopy-->
参数 user 是具有将计算机加入 Active Directory 域权限的任何 Active Directory 域用户。参数 domain-name 是要将 Linux 计算机加入的域的名称。
验证域成员身份
Delivery Controller 要求所有 VDA 计算机（无论是 Windows 还是 Linux）在 Active Directory 中都具有计算机对象。要验证已加入 Centrify 的 Linux 计算机是否在域中，请执行以下操作：
su –
adinfo
<!--NeedCopy-->
验证 Joined to domain 值是否有效，并且 CentrifyDC mode 返回 connected。如果模式停留在启动状态，则 Centrify 客户端正在遇到服务器连接或身份验证问题。
可以使用以下方式获取更全面的系统和诊断信息：
adinfo --sysinfo all
adinfo --diag
<!--NeedCopy-->
测试与各种活动目录和 Kerberos 服务的连接。
adinfo --test
<!--NeedCopy-->
在域加入验证之后，继续执行步骤 6：安装 Linux VDA。
SSSD
配置科尔贝罗斯
运行以下命令安装 Kerberos：
sudo apt-get install krb5-user
<!--NeedCopy-->
要配置 Kerberos，请以根用户身份打开 /etc/krb5.conf 并设置参数：
注意：
根据您的 AD 基础结构配置 Kerberos。以下设置适用于单域、单林模型。
[libdefaults]
default_realm = REALM
dns_lookup_kdc = false
rdns = false
[realms]
REALM = {
admin_server = domain-controller-fqdn
kdc = domain-controller-fqdn
}
[domain_realm]
domain-dns-name = REALM
.domain-dns-name = REALM
在此上下文中，domain-dns-name 参数是 DNS 域名，例如 example.com。REALM 是 Kerberos 领域名称的大写形式，例如 EXAMPLE.COM。
加入到域中
必须将 SSSD 配置为使用 Active Directory 作为其身份提供程序，并使用 Kerberos 进行身份验证。但是，SSSD 不提供用于加入域和管理系统密钥表文件的 AD 客户端功能。您可以使用 adcli、realmd 或 Samba。
注意：
本节仅提供有关 adcli 和 Samba 的信息。
- 如果您使用 adcli 加入域，请完成以下步骤：
-
安装 adcli 工具。
sudo apt-get install adcli <!--NeedCopy--> -
使用 adcli 加入域。
删除旧的系统 keytab 文件并使用以下命令加入域：
su - rm -rf /etc/krb5.keytab adcli join domain-dns-name -U user -H hostname-fqdn <!--NeedCopy-->user 是一个域用户，具有将计算机添加到域的权限。hostname-fqdn 是计算机的 FQDN 格式主机名。
-H 选项是必不可少的，因为 adcli 需要它来生成
host/hostname-fqdn@REALM格式的 SPN，而 Linux VDA 系统也要求使用这种格式的 SPN。 -
验证系统 keytab。
运行
sudo klist -ket命令以确保已创建系统 keytab 文件。验证每个密钥的时间戳是否与计算机加入域的时间匹配。
- 如果您使用 Samba 加入域，请完成以下步骤：
-
安装软件包。
sudo apt-get install samba krb5-user <!--NeedCopy--> -
配置 Samba 服务。
打开 /etc/samba/smb.conf 文件，并按照以下说明进行配置：
[global]workgroup =WORKGROUPsecurity = ADSrealm =REALMclient signing = yesclient use spnego = yeskerberos method = secrets and keytabWORKGROUP 是 REALM 中的第一个字段，并且 REALM 是大写的 Kerberos 领域名称。
-
使用 Samba 加入域。
您的域控制器必须可访问，并且您必须拥有一个具有将计算机添加到域的权限的 Windows 帐户。
sudo net ads join <the Kerberos realm name in uppercase> -U <domain user with permission to add computers to the domain> <!--NeedCopy-->
Set up SSSD
安装或更新所需的软件包：
如果尚未安装，请安装所需的 SSSD 和配置软件包：
sudo apt-get install sssd
<!--NeedCopy-->
如果软件包已安装，建议进行更新：
sudo apt-get install --only-upgrade sssd
<!--NeedCopy-->
对 SSSD 进行配置
在启动 SSSD 守护程序之前，需要进行 SSSD 配置更改。对于某些版本的 SSSD，/etc/sssd/sssd.conf 配置文件默认未安装，必须手动创建。以 root 身份，创建或打开 /etc/sssd/sssd.conf 并进行以下设置：
[sssd]
services = nss, pam
config_file_version = 2
domains = domain-dns-name
[domain/domain-dns-name]
id_provider = ad
access_provider = ad
auth_provider = krb5
krb5_realm = REALM
# Set krb5_renewable_lifetime higher if TGT renew lifetime is longer than 14 days
krb5_renewable_lifetime = 14d
# Set krb5_renew_interval to lower value if TGT ticket lifetime is shorter than 2 hours
krb5_renew_interval = 1h
krb5_ccachedir = /tmp
krb5_ccname_template = FILE:%d/krb5cc_%U
# This ldap_id_mapping setting is also the default value
ldap_id_mapping = true
override_homedir = /home/%d/%u
default_shell = /bin/bash
ad_gpo_map_remote_interactive = +ctxhdx
注意：
ldap_id_mapping 设置为 true，以便 系统安全服务守护进程 (SSSD) 自身负责将 Windows 安全标识符映射到 Unix 用户标识符。否则，
Active Directory必须能够提供 可移植操作系统接口 (POSIX) 扩展。PAM 服务ctxhdx已添加到 ad_gpo_map_remote_interactive。The domain-dns-name parameter in this context is the DNS domain name, such as example.com. The REALM is the Kerberos realm name in uppercase, such as EXAMPLE.COM. There is no requirement to configure the NetBIOS domain name.
有关配置设置的信息，请参阅 sssd.conf 和
sssd-ad的手册页。
SSSD 守护程序要求配置文件必须仅具有所有者读取权限：
sudo chmod 0600 /etc/sssd/sssd.conf
<!--NeedCopy-->
启动 SSSD 守护程序
运行以下命令以立即启动 SSSD 守护程序，并使守护程序在计算机启动时启动：
sudo systemctl start sssd
sudo systemctl enable sssd
<!--NeedCopy-->
PAM 配置
运行以下命令并确保选中 SSS 身份验证和登录时创建主目录选项：
sudo pam-auth-update
<!--NeedCopy-->
验证域成员身份
交付控制器要求所有虚拟投递代理计算机（Windows 和 Linux 虚拟投递代理）在 Active Directory 中都有一个计算机对象。
-
如果您使用 adcli 验证域成员身份，请运行
sudo adcli info domain-dns-name命令以显示域信息。 -
如果您使用 Samba 验证域成员身份，请运行
sudo net ads testjoin命令以验证计算机是否已加入域，并运行sudo net ads info命令以验证额外的域和计算机对象信息。
验证 科尔贝罗斯 配置
要验证 Kerberos 是否已正确配置以与 Linux VDA 配合使用，请验证系统 keytab 文件是否已创建并包含有效密钥：
sudo klist -ke
<!--NeedCopy-->
此命令显示主体名称和密码套件的各种组合可用的密钥列表。运行 Kerberos kinit 命令以使用这些密钥向域控制器验证计算机身份：
sudo kinit -k MACHINE\$@REALM
<!--NeedCopy-->
计算机和领域名称必须以大写形式指定。美元符号 ($) 必须用反斜杠 (\) 转义，以防止 shell 替换。在某些环境中，DNS 域名与 Kerberos 领域名称不同。请确保使用领域名称。如果此命令成功，则不显示任何输出。
使用以下命令验证计算机帐户的 TGT 是否已缓存：
sudo klist
<!--NeedCopy-->
验证用户身份验证
SSSD 不提供用于直接通过守护程序测试身份验证的命令行工具，只能通过 PAM 完成。
要验证 SSSD PAM 模块是否已正确配置，请使用以前未使用的域用户帐户登录到 Linux VDA。
ssh localhost -l domain\\username
id -u
klist
exit
<!--NeedCopy-->
验证 klist 命令返回的 Kerberos 票证对于该用户是否正确且未过期。
作为 root 用户，验证是否为上一个 id -u 命令返回的 uid 创建了相应的票证缓存文件：
ls /tmp/krb5cc_uid
<!--NeedCopy-->
可以通过登录 KDE 或 Gnome 显示管理器执行类似的测试。在完成域加入验证后，继续执行 步骤 6：安装 Linux VDA。
身份服务
下载所需的 PBIS 软件包
sudo wget https://github.com/BeyondTrust/pbis-open/releases/download/9.1.0/pbis-open-9.1.0.551.linux.x86_64.deb.sh
<!--NeedCopy-->
使 PBIS 安装脚本可执行
sudo chmod +x pbis-open-9.1.0.551.linux.x86_64.deb.sh
<!--NeedCopy-->
运行 PBIS 安装脚本
sudo sh pbis-open-9.1.0.551.linux.x86_64.deb.sh
<!--NeedCopy-->
加入视窗域
您的域控制器必须可访问，并且您必须拥有一个具有将计算机添加到域权限的 Active Directory 用户帐户：
sudo /opt/pbis/bin/domainjoin-cli join domain-name user
<!--NeedCopy-->
用户是一个域用户，拥有将计算机添加到 Active Directory 域的权限。域名是域的 DNS 名称，例如 example.com。
Note: To set Bash as the default shell, run the sudo /opt/pbis/bin/config LoginShellTemplate/bin/bash command.
验证域成员身份
交付控制器要求所有 VDA 计算机（Windows VDA 和 Linux VDA）在 Active Directory 中具有计算机对象。要验证已加入 PBIS 的 Linux 计算机是否在域中：
/opt/pbis/bin/domainjoin-cli query
<!--NeedCopy-->
如果计算机已加入域，此命令将返回有关当前加入的 AD 域和 OU 的信息。否则，只显示主机名。
验证用户身份验证
要验证 PBIS 是否可以通过 PAM 验证域用户，请使用以前未使用的域用户帐户登录到 Linux VDA。
sudo ssh localhost -l domain\\user
id -u
<!--NeedCopy-->
验证是否为 id -u 命令返回的 UID 创建了相应的 Kerberos 凭据缓存文件：
ls /tmp/krb5cc_uid
<!--NeedCopy-->
退出会话。
exit
<!--NeedCopy-->
在域加入验证后，继续执行 步骤 6：安装 Linux VDA。
步骤 4：安装 .NET
在安装 Linux VDA 软件包之前，请根据系统要求安装 .NET(/zh-cn/linux-virtual-delivery-agent/current-release/system-requirements.html#net-requirements)
安装 .NET 后，运行 which dotnet 命令以查找您的运行时路径。
根据命令输出，设置 .NET 运行时二进制路径。例如，如果命令输出为 /aa/bb/dotnet，则使用 /aa/bb 作为 .NET 二进制路径。
步骤 5：下载 Linux VDA 软件包
- 转到 思杰虚拟应用和桌面下载页面。
- 展开相应版本的思杰虚拟应用和桌面。
-
展开组件以查找 Linux VDA。例如：
-
单击 Linux VDA 链接，即可访问 Linux VDA 下载内容。
-
下载与您的 Linux 发行版匹配的 Linux VDA 软件包。
-
下载 GPG 公钥，您可以使用它来验证 Linux VDA 软件包的完整性。例如：
要验证 Linux VDA 软件包的完整性，请运行以下命令将公钥导入 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 虚拟交付代理
步骤 6a：安装 Linux 虚拟交付代理
使用 Debian 软件包管理器安装 Linux VDA 软件：
适用于 Debian 12 操作系统：
sudo dpkg -i xendesktopvda_<version>.debian12_amd64.deb
<!--NeedCopy-->
适用于 Debian 11 操作系统：
sudo dpkg -i xendesktopvda_<version>.debian11_amd64.deb
<!--NeedCopy-->
Debian 12 的依赖项列表：
openjdk-17-jdk >= 17
imagemagick >= 8:6.9.11
ufw >= 0.36
desktop-base >= 12.0.6
libxrandr2 >= 2:1.5.2
libxtst6 >= 2:1.2.3
libxm4 >= 2.3.8
util-linux >= 2.38
gtk3-nocsd >= 3
bash >= 5.2
findutils >= 4.9.0
sed >= 4.9
cups >= 2.4
ghostscript >= 10.0.0~
libmspack0 >= 0.11
ibus >= 1.5
libgoogle-perftools4 >= 2.10~
libpython3.11 >= 3.11~
libsasl2-modules-gssapi-mit >= 2.1.~
libnss3-tools >= 2:3.87
libqt5widgets5 >= 5.15~
mutter >= 43.8
libqrencode4 >= 4.1.1
libimlib2 >= 1.10.0
libfuse2 >= 2.9.9
pulseaudio-utils >= 16.1
<!--NeedCopy-->
Debian 11 的依赖项列表：
libnss3-tools >= 2:3.61
libfuse2 >= 2.9
openjdk-17-jdk >= 17
imagemagick >= 8:6.9.10
ufw >= 0.36
desktop-base >= 10.0.2
libxrandr2 >= 2:1.5.1
libxtst6 >= 2:1.2.3
libxm4 >= 2.3.8
util-linux >= 2.33
gtk3-nocsd >= 3
bash >= 5.0
findutils >= 4.6.0
sed >= 4.7
cups >= 2.2
ghostscript >= 9.53~
libmspack0 >= 0.10
ibus >= 1.5
libgoogle-perftools4 >= 2.7~
libpython3.9 >= 3.9~
libsasl2-modules-gssapi-mit >= 2.1.~
libqt5widgets5 >= 5.5~
mutter >= 3.38.6~
libqrencode4 >= 4.0.0
libimlib2 >= 1.5.1
<!--NeedCopy-->
注意：
有关此版本的 Linux VDA 支持的 Linux 发行版和 Xorg 版本的矩阵，请参阅系统要求。
步骤 6b：升级 Linux VDA（可选）
Linux VDA 支持从最新版本进行升级。例如，您可以将 Linux VDA 从 2308 升级到 2311，以及从 1912 LTSR 升级到 2203 LTSR。
sudo dpkg -i <PATH>/<Linux VDA deb>
sudo apt-get install -f
<!--NeedCopy-->
注意：
升级现有安装会覆盖 /etc/xdl 下的配置文件。在执行升级之前，请务必备份文件。
从 2407 版本开始，Linux VDA 将软件包管理器 rpm 或 dpkg 委托给在升级期间处理配置文件。以下描述了 rpm 和 dpkg 如何与配置文件的更改进行交互：
rpm：默认情况下保留本地版本，并将软件包中的新版本保存为 .rpmnew 扩展名。
dpkg：以交互方式提示您选择如何继续。要在保留本地配置文件并将新软件包版本保存为 .dpkg-new 或 .dpkg-dist 的同时静默升级 Linux VDA，请使用以下命令：
dpkg --force-confold -i package.deb # Always keep your version, then save new package's version as *.dpkg-new or *.dpkg-dist <!--NeedCopy-->
步骤 7：安装 NVIDIA GRID 驱动程序
要启用 HDX 3D Pro，您需要在管理程序和 VDA 计算机上安装 NVIDIA GRID 驱动程序。
要在特定管理程序上安装和配置 NVIDIA GRID 虚拟 GPU 管理器（主机驱动程序），请参阅以下指南：
要安装和配置 NVIDIA GRID 客户机 VM 驱动程序，请执行以下常规步骤：
- 确保客户机 VM 已关闭。
- 在管理程序控制面板中，为 VM 分配一个 GPU。
- 启动 VM。
- 在 VM 上安装客户机 VM 驱动程序（从您的云供应商或 NVIDIA 获取）。
步骤 8：配置 Linux 虚拟投递代理
注意：
在设置运行时环境之前，请确保您的操作系统上已安装 en_US.UTF-8 区域设置。如果您的操作系统上没有此区域设置，请运行 sudo locale-gen en_US.UTF-8 命令。对于 Debian，请通过取消注释 # en_US.UTF-8 UTF-8 行来编辑 /etc/locale.gen 文件，然后运行 sudo locale-gen 命令。
安装软件包后，您必须通过运行 ctxsetup.sh 脚本来配置 Linux VDA。在进行任何更改之前，脚本会验证环境并确保所有依赖项都已安装。如有必要，您可以随时重新运行该脚本以更改设置。
您可以手动运行脚本并进行提示，也可以使用预配置的响应自动运行脚本。在继续之前，请查看有关该脚本的帮助信息：
sudo /opt/Citrix/VDA/sbin/ctxsetup.sh --help
<!--NeedCopy-->
提示引导式配置
运行带有提示问题的手动配置：
sudo /opt/Citrix/VDA/sbin/ctxsetup.sh
<!--NeedCopy-->
自动化的配置
对于自动化安装，可以通过环境变量提供安装脚本所需的选项。如果所有必需的变量都存在，脚本将不会提示用户输入任何信息，从而实现脚本化安装过程。
支持的环境变量包括：
-
CTX_XDL_NON_DOMAIN_JOINED=’y|n’ – 是否将计算机加入 域。默认值为 ‘n’。对于已加入域的场景，请将其设置为 ‘n’。
-
CTX_XDL_AD_INTEGRATION=’winbind|sssd|centrify|pbis|quest’ – Linux 虚拟投递代理需要 Kerberos 配置设置才能与投递控制器进行身份验证。Kerberos 配置由系统上已安装和配置的活动目录集成工具确定。
-
CTX_XDL_DDC_LIST=’<list-ddc-fqdns>‘ – The Linux VDA requires a space-separated list of Delivery Controller Fully Qualified Domain Names (FQDNs) to use for registering with a Delivery Controller. At least one FQDN or CNAME must be specified.
-
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’ – Determines whether the Linux VDA services are started when the configuration is complete.
-
CTX_XDL_REGISTER_SERVICE=’y|n’ – The Linux Virtual Desktop services are started after machine startup.
-
CTX_XDL_ADD_FIREWALL_RULES=’y|n’ – Linux VDA 服务要求允许传入网络连接通过系统防火墙。您可以自动在系统防火墙中为 Linux Virtual Desktop 打开所需的端口（默认端口为 80 和 1494）。
-
CTX_XDL_DESKTOP_ENVIRONMENT=gnome/gnome-classic/kde/mate/’<none>‘ – Specifies the GNOME, GNOME Classic, or MATE desktop environment to use in sessions. If you set it to ‘<none>‘, the default desktop configured on the VDA is used.
-
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.
-
CTX_XDL_SITE_NAME=<dns-name> – Linux VDA 通过 DNS 发现 LDAP 服务器。要将 DNS 搜索结果限制到本地站点，请指定一个 DNS 站点名称。如果不需要，请设置为 ‘<none>‘。
-
CTX_XDL_LDAP_LIST=’<list-ldap-servers>‘ – The Linux VDA queries DNS to discover LDAP servers. If DNS cannot provide LDAP service records, you can provide a space-separated list of LDAP FQDNs with LDAP ports. For example, ad1.mycompany.com:389 ad2.mycompany.com:3268 ad3.mycompany.com:3268. To enable faster LDAP queries within an Active Directory forest, enable Global Catalog on a domain controller and specify the relevant LDAP port number as 3268. This variable is set to ‘<none>‘ by default.
-
CTX_XDL_SEARCH_BASE=search-base-set – The Linux VDA queries LDAP through a search base set to the root of the Active Directory Domain (for example, DC=mycompany,DC=com). To improve search performance, you can specify a search base (for example, OU=VDI,DC=mycompany,DC=com). If unnecessary, set to ‘<none>‘.
-
CTX_XDL_SUPPORT_DDC_AS_CNAME=’y|n’ – The Linux VDA supports specifying a Delivery Controller name using a DNS CNAME record.
请按照以下步骤设置环境变量并运行配置脚本：
export CTX_XDL_NON_DOMAIN_JOINED='n'
export CTX_XDL_AD_INTEGRATION=sssd|winbind|centrify|pbis|quest
export CTX_XDL_DDC_LIST='<list-ddc-fqdns>'
export CTX_XDL_VDI_MODE='y|n'
export CTX_XDL_HDX_3D_PRO='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_DESKTOP_ENVIRONMENT=gnome|gnome-classic|kde|mate|'<none>'
export CTX_XDL_DOTNET_RUNTIME_PATH='<path-to-install-dotnet-runtime>'
export CTX_XDL_VDA_PORT='<port-number>'
export CTX_XDL_SITE_NAME='<dns-site-name>'|'<none>'
export CTX_XDL_LDAP_LIST='<list-ldap-servers>'|'<none>'
export CTX_XDL_SEARCH_BASE='<search-base-set>'|'<none>'
export CTX_XDL_SUPPORT_DDC_AS_CNAME='y|n'
sudo -E /opt/Citrix/VDA/sbin/ctxsetup.sh --silent
<!--NeedCopy-->
运行 sudo 命令时，键入 -E 选项以将现有环境变量传递给它创建的新 shell。建议您从前面的命令创建一个 shell 脚本文件，并将 #!/bin/bash 作为第一行。
或者，您可以使用单个命令指定所有参数：
sudo CTX_XDL_NON_DOMAIN_JOINED='n' \
CTX_XDL_AD_INTEGRATION=sssd|winbind|centrify|pbis|quest \
CTX_XDL_DDC_LIST='<list-ddc-fqdns>' \
CTX_XDL_VDI_MODE='y|n' \
CTX_XDL_HDX_3D_PRO='y|n' \
CTX_XDL_START_SERVICE='y|n' \
CTX_XDL_REGISTER_SERVICE='y|n' \
CTX_XDL_ADD_FIREWALL_RULES='y|n' \
CTX_XDL_DESKTOP_ENVIRONMENT=gnome|gnome-classic|kde|mate|'<none>' \
CTX_XDL_DOTNET_RUNTIME_PATH='<path-to-install-dotnet-runtime>' \
CTX_XDL_VDA_PORT='<port-number>' \
CTX_XDL_SITE_NAME='<dns-site-name>'|'<none>' \
CTX_XDL_LDAP_LIST='<list-ldap-servers>'|'<none>' \
CTX_XDL_SEARCH_BASE='<search-base-set>'|'<none>' \
CTX_XDL_SUPPORT_DDC_AS_CNAME='y|n' \
/opt/Citrix/VDA/sbin/ctxsetup.sh --silent
<!--NeedCopy-->
移除配置所做的更改
在某些情况下，您可能需要删除由 ctxsetup.sh 脚本所做的配置更改，而无需卸载 Linux VDA 软件包。
在继续操作之前，请查看有关此脚本的帮助：
sudo /opt/Citrix/VDA/sbin/ctxcleanup.sh --help
<!--NeedCopy-->
要删除配置更改：
sudo /opt/Citrix/VDA/sbin/ctxcleanup.sh
<!--NeedCopy-->
重要：
此脚本会删除数据库中的所有配置数据，并使 Linux VDA 无法运行。
配置日志文件
ctxsetup.sh 和 ctxcleanup.sh 脚本会在控制台上显示错误，并将更多信息写入配置日志文件 /tmp/xdl.configure.log。
重新启动 Linux VDA 服务以使更改生效。
Uninstall the Linux VDA software
要检查 Linux VDA 是否已安装以及查看已安装软件包的版本：
dpkg -l xendesktopvda
<!--NeedCopy-->
要查看更多详细信息：
apt-cache show xendesktopvda
<!--NeedCopy-->
To uninstall the Linux VDA software:
dpkg -r xendesktopvda
<!--NeedCopy-->
注意：
卸载 Linux VDA 软件会删除关联的 PostgreSQL 和其他配置数据。但是，在安装 Linux VDA 之前设置的 PostgreSQL 软件包和其他依赖软件包不会被删除。
提示：
本节中的信息不包括删除依赖软件包（包括 PostgreSQL）。
步骤 9：运行 XDPing
运行 sudo /opt/Citrix/VDA/bin/xdping 以检查 Linux VDA 环境中的常见配置问题。有关详细信息，请参阅 XDPing。
步骤 10: 启动 Linux VDA 应用程序
使用 ctxsetup.sh 脚本配置 Linux VDA 后，您可以使用以下命令来控制 Linux VDA。
启动 Linux 虚拟交付代理：
要启动 Linux VDA 服务，请执行以下步骤：
sudo systemctl start ctxhdx
sudo systemctl start ctxvda
<!--NeedCopy-->
停止 Linux 虚拟交付代理：
要停止 Linux VDA 服务，请执行以下操作：
sudo systemctl stop ctxvda
sudo systemctl stop ctxhdx
<!--NeedCopy-->
注意：
在停止 ctxvda 和 ctxhdx 服务之前，请运行 systemctl stop ctxmonitord 命令以停止监视服务守护程序。否则，监视服务守护程序会重新启动您已停止的服务。
重新启动 Linux 虚拟投递代理：
要重新启动 Linux VDA 服务：
sudo systemctl stop ctxvda
sudo systemctl restart ctxhdx
sudo systemctl restart ctxvda
<!--NeedCopy-->
检查 Linux VDA 的运行状态：
要检查 Linux VDA 服务的运行状态：
sudo systemctl status ctxvda
sudo systemctl status ctxhdx
<!--NeedCopy-->
步骤 11：创建计算机目录
创建计算机目录和添加 Linux VDA 计算机的过程与传统的 Windows VDA 方法类似。有关如何完成这些任务的更详细说明，请参阅创建计算机目录 和管理计算机目录。
对于创建包含 Linux VDA 计算机的计算机目录，有一些限制使其与为 Windows VDA 计算机创建计算机目录的过程有所不同：
- 对于操作系统，请选择：
- 托管共享桌面交付模型的多会话操作系统选项。
- VDI 专用桌面交付模型的单会话操作系统选项。
- 请勿在同一计算机目录中混合使用 Linux 和 Windows VDA 计算机。
注意：
早期版本的 Citrix Studio 不支持“Linux 操作系统”的概念。但是，选择Windows Server OS或Server OS选项意味着等效的托管共享桌面交付模型。选择Windows Desktop OS或Desktop OS选项意味着每台计算机一个用户的交付模型。
提示：
如果从 Active Directory 域中移除计算机并重新加入，则必须再次从计算机目录中移除并添加该计算机。
步骤 12：创建交付组
创建交付组并添加包含 Linux VDA 计算机的计算机目录的过程与 Windows VDA 计算机几乎相同。有关如何完成这些任务的更详细说明，请参阅创建交付组。
对于创建包含 Linux VDA 计算机目录的交付组，适用以下限制：
- 确保您选择的 AD 用户和组已正确配置为登录到 Linux VDA 计算机。
- 不允许未经身份验证（匿名）用户登录。
- 请勿将交付组与包含 Windows 计算机的计算机目录混合使用。
有关如何创建计算机目录和交付组的信息，请参阅Citrix Virtual Apps and Desktops 7 2503。