EnglishFrançaisDeutschEspañolItaliano日本語한국어NederlandsPortuguês (Brasil)中文 (简体)中文 (繁體, 台灣)
Skip to main content

2026 年 4 月 14 日

Horizon Agent for Linux 的系統需求

若要安裝 Horizon Agent for Linux，您必須符合 Linux 作業系統、Linux 虛擬機器、Horizon 8 系統元件以及 vSphere 平台的特定需求。

Horizon Agent 支援的 Linux 發行版

請參閱 Horizon Linux Agent for Horizon 支援的客體作業系統知識庫文章，以查看已針對 Horizon Agent 測試並受支援的 Linux 作業系統清單。

**附註：**Horizon Agent 在某些 Linux 發行版上具有相依性套件。如需詳細資訊，請參閱安裝 Horizon Agent 的相依性套件。

部分功能僅支援有限的部分 Linux 作業系統。如需詳細資訊，請參閱此文件中討論特定功能的小節。

install_viewagent.sh 安裝指令碼提供一個 --force 參數，可強制在未列於測試支援對照表中的 Linux 發行版上安裝 Horizon Agent。請參閱安裝 Horizon Agent for Linux 的命令列選項。

所需的平台和軟體版本

若要安裝並使用 Horizon Agent for Linux，您的部署必須符合 vSphere 平台、Horizon Connection Server 與 Horizon Client 軟體的特定需求。

平台和軟體支援的版本
vSphere 平台版本
  • vSphere 8.0 或更新版本
  • vSphere 7.0 或更新版本
Horizon 8 環境
  • 適用於您 Horizon 8 版本的 Horizon Connection Server
Horizon Client 軟體
  • 使用適用於您 Horizon 8 版本的 Horizon Client。


    • 附註：Horizon Web Client 可在 Horizon 8 版本 2412 及更新版本中使用。在 Horizon 8 版本 2412 及更早版本中，Horizon Web Client 稱為「HTML Access」。此頁面使用「Horizon Web Client」這個名稱來同時指稱 Horizon Web Client 和 HTML Access。
  • 支援 Horizon Blast 通訊協定的零用戶端 附註：不支援 Teradici PCoIP 零用戶端。

Linux 桌面平台使用的連接埠

若要啟用連線工作階段，Linux 桌面平台必須支援來自 Horizon Client 裝置、Unified Access Gateway 和 Horizon Connection Server 的傳入 TCP 連線。

在 Ubuntu 和 Debian 發行版本中，iptables 防火牆的預設輸入原則設定為 ACCEPT。

在 RHEL 和 Rocky Linux 發行版中，Horizon Agent 安裝指令碼會在可能的情況下，將 iptables 防火牆設定為輸入原則 ACCEPT。為確保支援傳入連線，請確認 iptables 已將 Blast 連接埠 22443 的新連線輸入原則設為 ACCEPT。

啟用 Blast 安全閘道 (BSG) 時，用戶端連線會從 Horizon Client 裝置透過 Horizon Connection Server 上的 BSG 傳送至 Linux 桌面平台。若未啟用 BSG，連線則會直接從 Horizon Client 裝置連至 Linux 桌面平台。

如需 Horizon Agent 在 Linux 桌面平台上所使用連接埠的詳細資訊，請參閱*《Horizon 安全性》*文件與《Horizon 中的網路連接埠》指南。

確認 Linux 虛擬機器使用的 Linux 帳戶

下表列出 Linux 虛擬機器使用的帳戶名稱和帳戶類型。

帳戶名稱和帳戶類型

帳戶名稱帳戶類型使用者
根Linux 作業系統內建Java Standalone Agent、mksvchanserver、Shell 指令碼
hznblast由 Linux 代理程式安裝程式建立BlastServer
<current login user>Linux 作業系統內建、AD 使用者或 LDAP 使用者Python 指令碼

桌面平台環境

Horizon Agent for Linux 支援不同 Linux 發行版上的多種桌面平台環境。下表列出了各 Linux 發行版的預設桌面平台環境，以及 Horizon Agent for Linux 支援的其他桌面平台環境。

支援的桌面平台環境

Linux 發行版預設桌面平台環境Horizon Agent for Linux 支援的桌面平台環境
UbuntuGnomeGnome Ubuntu、K Desktop Environment (KDE)、MATE
DebianGnomeGnome、KDE、MATE
RHEL 和 Rocky Linux 8.x/9.xGnomeGnome
SLED/SLESGnomeGnome

**附註：**在使用 Ubuntu 發行版時，SSO 無法解除鎖定已鎖定的 KDE 工作階段。您必須手動輸入密碼，才能將鎖定的工作階段解除鎖定。

若要變更其中一個支援的 Linux 發行版上使用的預設桌面平台環境，您必須使用下列適用於您的 Linux 桌面平台的步驟和命令。

  1. 使用預設桌面平台環境設定，安裝支援的 Linux 發行版作業系統。

  2. 針對您的特定 Linux 發行版，執行下表所述的適當命令。

  3. 若要開始使用新的預設桌面平台環境，請重新啟動桌面平台。

    用來安裝桌面平台環境的命令

    Linux 發行版新的預設桌面平台環境用來變更預設桌面平台環境的命令
    UbuntuKDE 
    apt install plasma-desktop
    UbuntuMATE 
    apt install ubuntu-mate-desktop

如果您在安裝了多個桌面平台環境的 Linux 桌面平台上啟用 SSO，請使用下列資訊，選取要在 SSO 工作階段中使用的桌面平台環境。

  • 對於 Ubuntu，請使用下表中的資訊，在 /etc/omnissa/viewagent-custom.conf 檔案中設定 SSODesktopType 選項，以指定要搭配 SSO 使用的桌面平台環境。

    SSODesktopType 選項

    桌面平台類型SSODesktopType 選項設定
    MATESSODesktopType=UseMATE
    GnomeUbuntuSSODesktopType=UseGnomeUbuntu
    GnomeFlashbackSSODesktopType=UseGnomeFlashback
    KDESSODesktopType=UseKdePlasma
    GnomeClassicSSODesktopType=UseGnomeClassic

  • 對於 RHEL 和 Rocky Linux 9.x/8.x，若要讓 SSO 登入工作階段使用 Gnome Classic，請從 /usr/share/xsession 目錄中移除所有桌面平台啟動檔案，只保留 Gnome Classic 的啟動檔案。例如，以 root 使用者身分，執行下列這一組命令：

    cd /usr/share/xsessions
mkdir backup
mv *.desktop backup
mv backup/gnome-classic.desktop ./

    使用者在初始設定之後必須將其 Linux 桌面平台登出或重新開機，才能使用 Gnome Classic 作為其下一個 SSO 工作階段中的預設桌面平台。

如果在 Ubuntu 24.04 上出現空白畫面，原因可能與 Wayland 組態有關。請參閱以下內容以修正空白畫面問題：

  • 編輯 /etc/gdm3/custom.conf。

    • 在 [daemon] 區段下，輸入註解：WaylandEnable=false 或 WaylandEnable=true。

      • 範例：

        [daemon]

        #WaylandEnable=false

  • 重新啟動 GDM 伺服器。

    • service gdm3 restart

如果您在安裝了多個桌面平台環境的 Linux 桌面平台上停用 SSO，則不需要執行任何前述步驟。使用者在登入該 Linux 桌面平台時，必須選取其所需的桌面平台環境。

網路需求

Horizon Blast Extreme 同時支援使用者資料包通訊協定 (UDP) 和傳輸控制通訊協定 (TCP)。網路狀況會影響 UDP 和 TCP 的效能。若要獲得最優質的使用者體驗，請根據網路狀況選取 UDP 或 TCP。

  • 如果網路狀況良好 (例如，在區域網路 (LAN) 環境中)，請選取 TCP。
  • 如果網路狀況不佳 (例如，在封包遺失且時間延遲的廣域網路 (WAN) 環境中)，請選取 UDP。

使用網路分析工具 (例如 Wireshark)，以判斷 Horizon Blast Extreme 使用的是 TCP 或是 UDP。使用下列參考範例中使用 Wireshark 的一組步驟。

  1. 在您的 Linux 虛擬機器上下載並安裝 Wireshark。

    針對 RHEL 和 Rocky Linux：

    sudo yum install wireshark

    針對 Ubuntu：

    sudo apt install tshark

  2. 使用 Omnissa Horizon Client 連線至 Linux 桌面平台。

  3. 開啟終端機視窗並執行下列命令，以顯示 Horizon Blast Extreme 所使用的 TCP 套件或 UDP 套件。

    sudo tshark -i any | grep 22443

網路狀況牽動著 USB 重新導向和用戶端磁碟機重新導向 (CDR) 功能的效用。如果網路狀況不佳 (例如，因頻寬受限而導致時間延遲和封包遺失)，使用者體驗就會變差。在這種情況下，使用者可能會遇到下列其中一種狀況。

  • 遠端檔案的複製可能會很慢。在此情況下，請改為傳輸較小的檔案。
  • USB 裝置未出現在遠端 Linux 桌面平台中。
  • USB 資料未完整傳輸。例如，在複製大型檔案時，您取得的檔案大小可能會小於原始檔案。

USB 重新導向的 VHCI 驅動程式

**附註：**若要判斷 VHCI 驅動程式的正確安裝順序，請依照下列準則：

  • 如果您打算使用 .tar.gz 安裝程式安裝 Horizon Agent，必須先下載並解壓縮該 tarball 安裝程式，然後安裝 VHCI 驅動程式，再使用安裝參數安裝具有 USB 重新導向功能的 Horizon Agent。
  • 如果您打算使用 .rpm RPM 安裝程式安裝 Horizon Agent，必須先安裝 Horizon Agent，再安裝 VHCI 驅動程式，最後將 USB 重新導向功能新增至 Horizon Agent 組態。

如需詳細資訊，請參閱在 Linux 機器上安裝 Horizon Agent。

USB 重新導向功能對 USB 虛擬主機控制器介面 (VHCI) 核心驅動程式具有相依性。若要支援 USB 3.0 與 USB 重新導向功能，您必須依照下列步驟安裝 VHCI 驅動程式。

**附註：**以下步驟使用 agent-installer 取代具體的檔案名稱。當您執行這些命令時，請將其中的檔案名稱替換為您實際使用的檔案名稱。

  1. 從 https://sourceforge.net/projects/usb-vhci/files/linux%20kernel%20module/ 下載 USB VHCI 原始程式碼。

  2. 根據 Horizon Agent 安裝程式的格式，確認 VHCI 修補檔案的完整路徑。如需相關準則，請參閱以下範例。(在這些範例中，agent-installer 指的是安裝程式檔案的名稱。請記得將 agent-installer 名稱替換為您實際使用的 Horizon Agent 安裝檔案名稱。)

    • (Tarball 安裝程式) 如果您在 /install_tmp/ 目錄下解壓縮 tarball 安裝程式 agent-installer.tar.gz，則 full-path_to_patch-file 的路徑模式為 /install_tmp/agent-installer/resources/vhci/patch/vhci.patch。
    • (RPM 安裝程式) 如果您下載 RPM 安裝程式 agent-installer.el8.x86_64.rpm 並使用它來安裝 Horizon Agent，則 full-path_to_patch-file 的路徑模式為 /usr/lib/omnissa/viewagent/resources/vhci/patch/vhci.patch。

  3. 若要編譯 VHCI 驅動程式原始程式碼，並在您的 Linux 系統上安裝產生的二進位檔，請使用下表中列出的命令。將命令中的 full-path_to_patch-file 替換為您在前一步驟中確認的檔案路徑。

    例如，如果檔案路徑的模式為 /install_tmp/agent-installer/resources/vhci/patch/vhci.patch，則 patch 命令會變成：

    patch -p1 < /install_tmp/agent-installeri/resources/vhci/patch/vhci.patch

編譯及安裝 USB VHCI 驅動程式

Linux 發行版編譯及安裝 USB VHCI 驅動程式的步驟
Ubuntu
  1. 安裝相依性套件。 
    <pre><code>sudo apt-get install make

    sudo apt-get install gcc sudo apt-get install libelf-dev

  2. (Ubuntu 22.04/24.04) 安裝核心標頭檔。 
    <pre><code>sudo apt-get install linux-headers-$(uname -r)</code></pre></li>
  3. 編譯及安裝 VHCI 驅動程式。 
    <pre><code>tar -xzvf vhci-hcd-1.15.tar.gz

    cd vhci-hcd-1.15 patch -p1 < full-path_to_patch-file make clean && make && sudo make install

  4. 如果您已在虛擬機器上啟用可延伸韌體介面 (EFI) 和 UEFI 安全開機，請為 VHCI 驅動程式設定簽署設定。 
    <ol>
	<li>建立 VHCI 驅動程式的 SSL 金鑰配對。

	    <pre><code>openssl req -new -x509 -newkey rsa:2048 -keyout MOK.priv -outform DER -out MOK.der -nodes -days 36500 -subj "/CN=Descriptive name/" -addext extendedKeyUsage=1.3.6.1.5.5.7.3.3</code></pre>    	</li>
	<li>簽署 VHCI 驅動程式。

	    <pre><code>sudo /usr/src/linux-headers-$(uname -r)/scripts/sign-file sha256 ./MOK.priv ./MOK.der /lib/modules/$(uname -r)/kernel/drivers/usb/host/usb-vhci-iocifc.ko

    sudo /usr/src/linux-headers-$(uname -r)/scripts/sign-file sha256 ./MOK.priv ./MOK.der /lib/modules/$(uname -r)/kernel/drivers/usb/host/usb-vhci-hcd.ko

  5. 登錄用於 UEFI 安全開機的金鑰。

    	    <pre><code>sudo mokutil --import MOK.der</code></pre>
	    <strong>附註：</strong>此命令會提出要求，為 UEFI 安全開機設定機器擁有者金鑰 (MOK) 密碼。    	</li>
	<li>若要在 vSphere 主控台中設定 UEFI 安全開機，請將系統重新開機。如需詳細資訊，請參閱 <a href="https://sourceware.org/systemtap/wiki/SecureBoot">https://sourceware.org/systemtap/wiki/SecureBoot</a>。
	</li>
</ol></li>
Debian
  1. 安裝相依性套件。 
    <pre><code>sudo  apt install -y  patch g++ make linux-headers-$(uname -r)</code></pre></li>
  2. 編譯及安裝 VHCI 驅動程式。 
    <pre><code>tar -xzvf vhci-hcd-1.15.tar.gz

    cd vhci-hcd-1.15 patch -p1 < full-path_to_patch-file mkdir -p linux/$(echo $(uname -r) | cut -d '-' -f 1)/drivers/usb/core cp /lib/modules/$(uname -r)/source/include/linux/usb/hcd.h linux/$(echo $(uname -r) | cut -d '-' -f 1)/drivers/usb/core

    make clean && make && sudo make install

RHEL 8.x/9.x Rocky Linux 8.x/9.x
  1. 安裝相依性套件。 
    <pre><code>sudo yum install gcc-c++

    sudo yum install kernel-devel-$(uname -r) sudo yum install kernel-headers-$(uname -r) sudo yum install patch sudo yum install elfutils-libelf-devel

  2. 編譯及安裝 VHCI 驅動程式。 
    <pre><code>tar -xzvf vhci-hcd-1.15.tar.gz

    cd vhci-hcd-1.15 patch -p1 < full-path_to_patch-file make clean && make && sudo make install

  3. (RHEL 和 Rocky Linux 9.x/8.x) 若要確保 VHCI 驅動程式可與 USB 重新導向正常搭配運作，請設定驅動程式的簽署設定。 
    <ol>
	<li>建立 VHCI 驅動程式的 SSL 金鑰配對。

	    <pre><code>openssl req -new -x509 -newkey rsa:2048 -keyout MOK.priv -outform DER -out MOK.der -nodes -days 36500 -subj "/CN=Descriptive name/" -addext extendedKeyUsage=1.3.6.1.5.5.7.3.3</code></pre>    	</li>
	<li>簽署 VHCI 驅動程式。

	    <pre><code>sudo /usr/src/kernels/$(uname -r)/scripts/sign-file sha256 ./MOK.priv ./MOK.der /lib/modules/$(uname -r)/kernel/drivers/usb/host/usb-vhci-iocifc.ko

    sudo /usr/src/kernels/$(uname -r)/scripts/sign-file sha256 ./MOK.priv ./MOK.der /lib/modules/$(uname -r)/kernel/drivers/usb/host/usb-vhci-hcd.ko

  4. 登錄用於 UEFI 安全開機的金鑰。

    	    <pre><code>sudo mokutil --import MOK.der</code></pre>
	    <strong>附註：</strong>此命令會提出要求，為 UEFI 安全開機設定機器擁有者金鑰 (MOK) 密碼。    	</li>
	<li>若要在 vSphere 主控台中設定 UEFI 安全開機，請將系統重新開機。如需詳細資訊，請參閱 <a href="https://sourceware.org/systemtap/wiki/SecureBoot">https://sourceware.org/systemtap/wiki/SecureBoot</a>。
	</li>
</ol></li>
SLED/SLES
  1. 尋找目前核心套件的版本。 
    <pre><code>rpm -qa | grep kernel-default-$(echo $(uname -r) | cut -d '-' -f 1,2)</code></pre>    輸出結果為目前所安裝核心套件的名稱。例如，如果套件名稱為 <code>kernel-default-3.0.101-63.1</code>，則目前的核心套件版本將是 3.0.101-63.1。</li>
  2. 安裝 kernel-devel、kernel-default-devel、kernel-macros 和 patch 套件。 
    <pre><code>sudo zypper install --oldpackage kernel-devel-<em>&lt;kernel-package-version&gt;</em> \

    kernel-default-devel-<kernel-package-version> kernel-macros-<kernel-package-version> patch 例如： 

    sudo zypper install --oldpackage kernel-devel-4.4.21-90.1 kernel-default-devel-4.4.21-90.1 kernel-macros-4.4.21-90.1 patch

  3. 編譯及安裝 VHCI 驅動程式。 
    <pre><code>tar -xzvf vhci-hcd-1.15.tar.gz

    cd vhci-hcd-1.15 patch -p1 < full-path_to_patch-file mkdir -p linux/$(echo $(uname -r) | cut -d '-' -f 1)/drivers/usb/core cp /lib/modules/$(uname -r)/source/include/linux/usb/hcd.h linux/$(echo $(uname -r) | cut -d '-' -f 1)/drivers/usb/core make clean && make && sudo make install

  4. 若要確保 VHCI 驅動程式可與 USB 重新導向正常搭配運作，請設定驅動程式的簽署設定。 
    <ol>
	<li>建立 VHCI 驅動程式的 SSL 金鑰配對。

	    <pre><code>openssl req -new -x509 -newkey rsa:2048 -keyout MOK.priv -outform DER -out MOK.der -nodes -days 36500 -subj "/CN=Descriptive name/" -addext extendedKeyUsage=1.3.6.1.5.5.7.3.3</code></pre>    	</li>
	<li>尋找 VHCI 驅動程式的簽署檔案路徑。

	    <pre><code>sudo find / -name sign-file</code></pre>
	    此命令會傳回位於系統上所有簽署檔案的路徑。VHCI 驅動程式的簽署檔案路徑類似於下列範例。    	    <pre><code>/usr/src/linux-5.3.18-24.9-obj/x86_64/default/scripts/</code></pre>    	</li>
	<li>簽署 VHCI 驅動程式。在以下命令中，&lt;sign-file-path&gt; 為您先前在步驟 4b 中找到的簽署檔路徑。

	    <pre><code>sudo /&lt;sign-file-path&gt;/sign-file sha256 ./MOK.priv ./MOK.der /lib/modules/$(uname -r)/kernel/drivers/usb/host/usb-vhci-iocifc.ko

    sudo /<sign-file-path>/src/kernels/$(uname -r)/scripts/sign-file sha256 ./MOK.priv ./MOK.der /lib/modules/$(uname -r)/kernel/drivers/usb/host/usb-vhci-hcd.ko

  5. 登錄用於 UEFI 安全開機的金鑰。

    	    <pre><code>sudo mokutil --import MOK.der</code></pre>
	    <strong>附註：</strong>此命令會提出要求，為 UEFI 安全開機設定機器擁有者金鑰 (MOK) 密碼。    	</li>
	<li>若要在 vSphere 主控台中設定 UEFI 安全開機，請將系統重新開機。如需詳細資訊，請參閱 <a href="https://sourceware.org/systemtap/wiki/SecureBoot">https://sourceware.org/systemtap/wiki/SecureBoot</a>。
	</li>
</ol></li>

此外，請遵循下列指引：

  • 如果您的 Linux 核心變更為新版本，則必須重新編譯並重新安裝 VHCI 驅動程式，但無需重新安裝 Horizon Agent for Linux。
  • 您也可以使用與 Ubuntu 系統的下列範例相類似的步驟，將動態核心模組支援 (DKMS) 新增至 VHCI 驅動程式。

    1. 安裝核心標頭。

      sudo apt install linux-headers-`uname -r`

    2. 使用下列命令安裝 dkms。

      sudo apt install dkms

    3. 解壓縮並修補 VHCI TAR 檔案。

      tar xzvf vhci-hcd-1.15.tar.gz
cd vhci-hcd-1.15
patch -p1 *<full-path_to_patch-file>*
cd ..

    4. 將解壓縮的 VHCI 來源檔案複製到 /usr/src 目錄。

      sudo cp -r vhci-hcd-1.15 /usr/src/usb-vhci-hcd-1.15

    5. 建立名為 dkms.conf 的檔案，並將其置於 /usr/src/usb-vhci-hcd-1.15 目錄中。

      sudo touch /usr/src/usb-vhci-hcd-1.15/dkms.conf

    6. 將下列內容新增至 dkms.conf 檔案。

      PACKAGE_NAME="usb-vhci-hcd"
PACKAGE_VERSION=1.15
MAKE_CMD_TMPL="make KVERSION=$kernelver"
    
CLEAN="$MAKE_CMD_TMPL clean"
    
BUILT_MODULE_NAME[0]="usb-vhci-iocifc"
DEST_MODULE_LOCATION[0]="/kernel/drivers/usb/host"
MAKE[0]="$MAKE_CMD_TMPL"
    
BUILT_MODULE_NAME[1]="usb-vhci-hcd"
DEST_MODULE_LOCATION[1]="/kernel/drivers/usb/host"
MAKE[1]="$MAKE_CMD_TMPL"
    
AUTOINSTALL="YES"

    7. 在 dkms 中新增此 VHCI 驅動程式。

      sudo dkms add usb-vhci-hcd/1.15

    8. 建置 VHCI 驅動程式。

      sudo dkms build usb-vhci-hcd/1.15

    9. 安裝 VHCI 驅動程式。

      sudo dkms install usb-vhci-hcd/1.15

2D 圖形的虛擬機器設定

當您為 Horizon 8 部署建立特定 Linux 虛擬機器時，必須變更 vCPU 和虛擬記憶體設定以符合效能需求。

設定為使用 NVIDIA GRID vGPU 的虛擬機器會使用以 NVIDIA 實體圖形加速器為基礎的 NVIDIA 虛擬圖形卡。您不需變更這些虛擬機器的 vCPU 和虛擬記憶體設定。

設定為使用 2D 圖形的虛擬機器會使用以 vSphere 為基礎的虛擬顯示卡，您必須變更 vCPU 和虛擬記憶體設定以提升桌面平台效能。請依照下列準則進行設定：

  • 若要改善 2D 桌面平台的效能，請為 Linux 虛擬機器設定更多 vCPU 和虛擬記憶體。例如，設定為 2 個 vCPU 和 2 GB 虛擬記憶體。
  • 若要支援多台監視器 (例如四台監視器) 的大螢幕顯示，請將虛擬機器設定為 4 個 vCPU 和 4 GB 虛擬記憶體。
  • 若要改善 2D 桌面平台上的影片播放，請將虛擬機器設定為 4 個 vCPU 和 4 GB 虛擬記憶體。

此頁面對您有幫助嗎?

針對本主題提供意見回饋

本主題對您有幫助嗎?

請勿填寫任何個人或機密資訊。

正在產生連結…