企业官网建设流程全解析

ARM架构下Horizon Client安装全攻略：从依赖检查到环境变量配置

在ARM架构的机器上装Horizon Client，很多人的第一反应是：这不就是下载一个安装包、点两下的事吗？真到动手的时候才发现，麻烦远不止“安装”本身。依赖检查没过、运行库版本不对、证书路径没配、图形环境不兼容，甚至环境变量没生效，任何一个环节掉链子，都可能让你在连接虚拟桌面的时候卡在半路，或者干脆闪退。这篇文章我想把自己在ARM环境里部署Horizon Client的全过程整理出来，从系统依赖检查、安装包选型，到环境变量配置和常见问题排查，尽量把每一步背后的原因讲清楚。适合正在折腾ARM服务器、树莓派、国产Arm开发板，又想通过Horizon Client接入VMware虚拟桌面的朋友参考，也适合那些安装失败后在日志里反复碰壁的人拿来对照排查。

1. 动手之前：先理清ARM架构下会遇到的几个“坑”

1.1 ARM架构里最容易被忽略的区别：aarch64 还是 armv7l

ARM平台和x86平台最大的不同，是它自己内部还分了好几套体系。光是我在实际部署中遇到过的，就有aarch64和armv7l两种常见形态。aarch64是64位ARM架构，跑的是ARMv8之后的指令集；armv7l是32位ARM架构，一般是ARMv7时代的处理器。二者虽然都叫ARM，但软件包不能直接通用，这是一个非常容易踩的坑。

我之前在一台ARM开发板上装Horizon Client的时候，第一反应是去下载官网提供的ARM64安装包，结果dpkg直接报“wrong architecture”。后来用命令查了一下才发现，那台板子的系统是32位的armv7l，只能装ARM32的包。反过来也一样，在树莓派4B这类aarch64设备上，如果误装了armhf的32位包，虽然有时候依赖能强行装上，但运行阶段基本都会出各种莫名其妙的问题。

所以动手之前，第一件事就是确认你的ARM设备到底是什么架构：

uname -m # 输出 aarch64 或者 armv7l

如果系统太老，还可以用这个命令看得更细：

uname -a # Linux raspberrypi 5.15.0-v8+ # SMP PREEMPT Wed Nov 23 15:06:30 2022 aarch64

看到是aarch64，就老老实实下载ARM64的包；看到是armv7l，就别在64位安装包的页面里浪费时间了。这一步做对了，后面的安装过程至少能少走一半弯路。

1.2 系统发行版与桌面环境的影响

架构确认之后，第二个关键点是操作系统发行版和图形环境的差异。Horizon Client虽然提供的是Linux版，但Linux本身不是铁板一块，Debian系、Ubuntu系、Kylin系都有各自的包管理体系和依赖库版本。

先说发行版。Debian系和Ubuntu系在安装依赖时基本可以用apt解决，问题不大。但如果你用的是精简度比较高的发行版，比如某个裁剪过的ARM嵌入式系统，里面可能连apt都没有，这时候就需要手动去下载.deb包并逐个安装，工作量会明显增加。我建议在条件允许的情况下，优先选择Debian或Ubuntu派生系统，依赖管理方便很多。

再说图形环境。很多ARM设备装的是服务器版系统，根本没有桌面环境。Horizon Client是个图形客户端，它需要X11或者Wayland这套图形协议支撑，没有桌面环境的情况下即使装上了也跑不起来。如果你是在无桌面的服务器上想连虚拟桌面，正确做法是装一个轻量桌面环境，比如Xfce或者LXDE，而不是在纯字符界面里纠结为什么Horizon Client打不开。

还有一个容易被忽视的差异是Wayland和X11。在比较新的发行版里，默认会话已经切到了Wayland，Horizon Client对Wayland的兼容性没有X11那么成熟。我在后面“环境变量配置”和“常见问题”两节里会再详细展开这个坑。

2. 依赖检查：安装之前把“地基”先垫平

2.1 先摸清系统底细：查看发行版和桌面环境

架构确认完毕之后，接下来要做一个完整的“环境体检”。我个人的习惯是先看几项基本信息：发行版版本、桌面环境、系统位数、还有Locale设置。这些信息看着不起眼，但每一项都可能影响Horizon Client的安装和运行。

查看发行版信息：

cat /etc/os-release # NAME="Debian GNU/Linux" # VERSION_ID="12"

查看桌面环境：

echo $XDG_CURRENT_DESKTOP # XFCE 或者 GNOME 或者空

如果这个变量是空的，说明你当前可能没有启动图形会话，或者用的是极简窗口管理器，Horizon Client启动时可能找不到可用的图形环境。

Locale也很重要。我在中文环境下遇到过客户端界面乱码、证书向导显示异常的情况，通常是缺少中文字体或者locale没生成完整造成的。装客户端之前先把系统的locale配好，不然排查起来很头疼：

sudo apt install locales sudo dpkg-reconfigure locales

语言这块我建议至少生成en_US.UTF-8和zh_CN.UTF-8两个locale，运行时再按需切换。

• 用uname -m确认架构是aarch64还是armv7l；
• 用/etc/os-release确认发行版版本；
• 用echo $XDG_CURRENT_DESKTOP确认桌面环境；
• 用locale命令确认系统语言环境；
• 最后再用free -h和df -h确认内存和磁盘余量，避免安装到一半空间不足。

别嫌这一步啰嗦，我遇到过不少在安装时报错、日志看了半天没头绪的情况，最后回头查环境才发现是最基础的发行版版本不对或者locale没配好。

2.2 常见依赖库清单与安装命令

Horizon Client在ARM Linux下依赖不少运行库。如果系统里缺了某几个，安装过程不会立刻报错，但运行客户端的时候会闪退或黑屏。根据我在不同ARM设备上的部署经验，比较常见的依赖包括：

• libgtk-3-0：图形界面必需的GTK3运行库；
• libx11-xcb1、libxss1：X11协议相关库，窗口会话和屏幕保护处理要用；
• libnss3：证书解析和SSL处理依赖；
• libusb-1.0-0：USB重定向功能需要；
• libssl3或libssl1.1：TLS加密通信依赖，基于OpenSSL；
• libgbm1：显卡缓冲区和硬件渲染相关；
• libxkbcommon0：键盘布局映射相关；
• libwayland-client0和libwayland-server0：Wayland协议支持；
• libcanberra-gtk3-module：系统提示音相关，缺少这个库有时候会导致GTK程序启动时告警。

在Debian或Ubuntu环境下，可以直接用apt一次性把能想到的都装上：

sudo apt update sudo apt install libgtk-3-0 libx11-xcb1 libxss1 libnss3 libusb-1.0-0 libssl3 libgbm1 libxkbcommon0 libwayland-client0 libwayland-server0 libcanberra-gtk3-module

注意：不同发行版可能把OpenSSL分成了libssl3和libssl1.1两个版本，Debian 12、Ubuntu 22.04之后的版本默认是libssl3，而老一些的系统可能是libssl1.1。安装之前先用apt-cache policy libssl3 libssl1.1看一下系统实际能装哪个，再决定包名，避免装了个空气依赖。

如果你用的是RHEL系或者国产Linux发行版，包名可能不太一样，比如Ubuntu叫libxss1，在Fedora里就变成了libXScrnSaver。基本原则是：先用系统的包管理工具搜索缺失库对应的包名，再安装，不要直接拿Debian的包名乱装。

2.3 用 ldd 提前排查缺失的共享库

依赖库装没装齐，其实不用等到运行客户端时才知道，安装完成后可以用ldd这个工具对客户端的核心二进制做一次“体检”。

Horizon Client安装之后的二进制一般在/usr/lib/vmware/view/bin目录下，核心程序名字通常是vmware-view。执行下面这条命令：

ldd /usr/lib/vmware/view/bin/vmware-view

正常情况下会打印出所有依赖的共享库以及当前系统的路径。如果哪一行出现了not found，那就是缺库了，需要回过头去装对应的依赖包。

这个办法非常好用，因为Horizon Client在日志里报的错往往比较笼统，直接说“加载共享库失败”，但不告诉你具体哪个库。ldd能精确列出缺失项，省得一个库一个库瞎猜。

我实际操作时还发现，有些库文件虽然存在，但版本符号不满足客户端的编译要求，ldd不会报not found，而是在调试时会提示version 'GLIBC_2.34' not found这类信息。这种情况下，光装依赖库没用，很可能是系统本身的glibc版本太老，只能升级整个系统或者换用老版本的Horizon Client。

3. 安装包获取与基础安装

3.1 选对版本：架构、平台和客户端版本都要匹配

版本选型是整个安装过程里最关键的一环。许多人安装失败，源头就是下载了错误架构或者错误平台的安装包，等到运行时报错才反应过来。

Horizon Client for Linux的安装包在VMware官网上有多个版本和格式。最常见的两种是：

• .deb包，适用于Debian/Ubuntu及派生系统；
• .tar.gz压缩包，适用于绝大多数Linux发行版，通过脚本方式安装。

在ARM设备上，还要注意区分ARM64和ARM32的包。官网上一般会标明aarch64字样的是64位版本，标明armhf的是32位版本。我用过几次后的经验是：能选aarch64版本就别硬着头皮在64位系统上装32位包，哪怕32位包能通过dpkg --force-architecture强行装进去，后续运行也容易出问题。

还有一个容易忽略的点是Horizon Client的版本号要和服务器端配套。比如你的虚拟桌面基础架构（VDI环境）是Horizon 8 2306，而客户端装了个太老或者太新的版本，连接时经常会提示版本不兼容。这一点在ARM设备上尤其明显，因为ARM版客户端更新往往滞后于x86版，有时候服务器端已经升级了，客户端还停留在老版本，就会遇到协议握手不成功或者功能界面缺失的问题。装之前最好先确认一下服务器端的版本，再去下载匹配的客户端。

3.2 安装过程中的实际命令与目录结构

下载好对应的安装包之后，安装本身其实并不复杂。以.deb包为例：

sudo dpkg -i VMware-Horizon-Client-2312-xxx.arm64.deb

如果系统提示有依赖问题，那就执行：

sudo apt --fix-broken install

这个命令会自动把缺失的依赖库补装完整，非常省事。装完之后验证一下：

dpkg -l | grep vmware-horizon

安装完成后，Horizon Client会在系统里建立一套完整的目录结构，我简单列一下比较重要的几个：

• /usr/lib/vmware/view/：客户端主程序和核心库文件；
• /usr/lib/vmware/view/bin/：启动脚本和二进制可执行文件；
• /usr/share/doc/vmware-horizon-client/：官方文档和版权信息；
• /etc/vmware/view/：配置文件目录；
• ~/.vmware/view/：用户目录下的配置和日志。

.tar.gz格式的安装包相对麻烦一点。下载后先解压：

tar -zxvf VMware-Horizon-Client-2312-xxx.tar.gz cd vmware-view-linux-xxx/arm64 sudo ./install_view.sh

解压安装脚本会根据当前系统环境自动判断安装路径。如果提示缺少依赖，建议先对照第2节的依赖清单补齐，再重新执行脚本。

提示：如果系统里有旧版本的Horizon Client，建议先卸载干净再装新版，否则可能出现配置文件残留导致新版本起不来的情况。卸载命令是sudo dpkg -r vmware-horizon-client，或者用sudo apt remove vmware-horizon-client。

4. 环境变量配置：JAVA_HOME 只是其中一环

4.1 为什么Horizon Client会跟Java扯上关系

说句实在话，Horizon Client本身并不是一个Java程序，它的主体是用C++写的，不需要Java运行时也能跑起来。但为什么那么多教程里都会提到Java环境变量？我在实际使用中发现，主要有两个原因。

一是Horizon Client的几个辅助工具和向导界面（比如证书配置工具、智能卡配置脚本、某些平台支持脚本）使用了Java运行时环境。尤其是在需要导入证书、生成密钥对的时候，客户端底层会调用keytool这个工具，而keytool是JDK自带的。如果系统里没有安装JDK，证书配置向导就会直接失败。

二是不少用户在配置环境变量时，其实是同时在准备其他开发工具。比如在ARM开发板上可能要同时跑Java应用和Horizon Client，索性一次把JDK环境变量配好，后面省事。

如果只是使用Horizon Client连接虚拟桌面，不搞证书导入这些高级操作，不装Java理论上也能用。但为了省心，我建议还是把OpenJDK装上并配好环境变量，成本很低，收益却很明确。

4.2 JAVA_HOME 与 PATH 的标准配置

在ARM Linux上配置JDK环境变量，和x86平台没有本质区别，但是有几个细节需要注意，比如安装路径的差异。

先安装OpenJDK。Debian/Ubuntu系统下直接执行：

sudo apt install openjdk-11-jdk

如果想装更新的版本，可以用openjdk-17-jdk，这套步骤同样适用。装完后确认一下JDK的安装路径：

sudo update-alternatives --config java

执行这条命令会列出系统里已安装的Java路径，在Debian系系统里一般是/usr/lib/jvm/java-11-openjdk-arm64这类格式。注意路径末尾的arm64，这是ARM架构特有的目录命名方式，配置环境变量时千万别写错。

接着编辑环境变量文件。如果是全局配置，我推荐修改/etc/profile；如果只是当前用户使用，修改~/.bashrc就够了。

在文件末尾追加以下内容：

export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-arm64 export PATH=$JAVA_HOME/bin:$PATH export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar

注意：JAVA_HOME一定要指向JDK的解压根目录，而不是bin目录。很多人喜欢写成/usr/lib/jvm/java-11-openjdk-arm64/bin，这会导致工具找不到运行时环境。另外，export PATH=$JAVA_HOME/bin:$PATH这行要把原有的$PATH放在后面，相当于把新路径追加到最前面，这样系统才会优先使用你配置的Java版本。

配置完成后让环境变量生效：

source /etc/profile # 或者 source ~/.bashrc

验证是否配置成功：

java -version # java version "11.0.21" 2023-10-17 LTS # Java(TM) SE Runtime Environment 18.9 (build 11.0.21+8-LTS-269) # Java HotSpot(TM) 64-Bit Server VM 18.9 (build 11.0.21+8-LTS-269, mixed mode)

4.3 其他影响客户端运行的环境变量

环境变量配置远不止JAVA_HOME这一项。Horizon Client在运行过程中，还会读取一些其他环境变量，尤其影响ARM平台上的行为。

第一个是证书相关环境变量。如果系统通过代理访问外网，或者Horizon服务器的SSL证书链不完整，客户端可能提示证书错误。针对这类问题，可以通过设置SSL_CERT_FILE和CURL_CA_BUNDLE，强制指定系统信任的CA证书文件：

export SSL_CERT_FILE=/etc/ssl/certs/ca-certificates.crt export CURL_CA_BUNDLE=/etc/ssl/certs/ca-certificates.crt

这套配置在自签名证书场景下特别有用，能避免很多“证书不受信任”的报错。

第二个是Wayland相关的变量。如果你的ARM设备默认登录会话是Wayland，Horizon Client可能会因为合成器兼容性问题导致黑屏或者鼠标显示异常。这时候可以强制客户端走X11后端：

export GDK_BACKEND=x11

配置好之后再启动vmware-view，窗口协议就切回X11了，兼容性会好很多。

第三个是分辨率和高DPI相关的设置。在4K屏或者高分屏上，Horizon Client可能显示模糊或者字体太小，可以设置：

export GDK_SCALE=2 export GDK_DPI_SCALE=0.5

这两个变量让GTK程序在保留正确缩放的同时，降低界面字体缩放的额外倍数，实测下来对高分屏的显示效果改善比较明显。

5. 常见问题与排查技巧实录

5.1 启动闪退：先看命令行输出和日志

Horizon Client启动闪退或者直接没反应，是所有故障里最让人头疼的一种。我以前习惯双击桌面图标然后等窗口弹出来，结果屏幕一闪就没了，连个报错都没留下。后来学乖了，直接在终端里启动，这样才能看到标准输出里的错误信息。

在终端里运行：

/usr/lib/vmware/view/bin/vmware-view

如果客户端闪退，终端里通常会打印缺少库文件、证书错误、图形环境初始化失败等关键信息。如果终端里没有任何输出，再看日志文件：

ls -l ~/.vmware/view/ tail -f ~/.vmware/view/vmware-view-*.log

日志文件记录了客户端启动过程中的几乎所有细节，包括协议握手、证书验证、连接目标等。排查闪退问题时，先看日志打印到哪一步挂的，基本就能定位到原因。

我见过最多的一类闪退原因是图形环境不兼容。在Wayland默认会话下启动时，客户端刚开始加载GTK库就退出了，日志里报Gtk-WARNING: cannot open display。这种情况下用前面提过的export GDK_BACKEND=x11强制切到X11，问题基本上就解决了。

5.2 连接服务器时提示证书不受信任

连接Horizon服务器时，最常见的错误是“服务器的证书不受信任”。这个问题在ARM设备上出现频率更高，因为很多ARM设备是自行刷的系统，CA证书列表可能没有更新完整，或者时间设置不对。

第一步要检查系统时间。ARM开发板如果断电重启后不通网，系统时间常常会回到出厂日期。证书验证会依据当前时间判断有效期，如果系统时间不对，就连正规证书也会被判定为过期：

date sudo apt install ntpdate sudo ntpdate time.nist.gov

第二步是检查CA证书列表是否完整：

sudo apt install ca-certificates sudo update-ca-certificates

如果服务器用的是企业内部的根证书，还需要把根证书导入系统信任库。假设根证书文件是company-root.cer，放到/usr/local/share/ca-certificates/下，然后执行：

sudo cp company-root.cer /usr/local/share/ca-certificates/ sudo update-ca-certificates

重启Horizon Client后再试，证书报错基本就能消灭。

5.3 认证通过后黑屏、只有鼠标指针

有一种情况非常挫败：用户名密码验证都通过了，系统也提示连接成功，但虚拟桌面就是黑屏，屏幕上只剩一个鼠标指针能移动。

根据我的排查经验，这个问题大概率出在图形协议上。Horizon客户端连接虚拟桌面后，是通过PCoIP或者Blast协议把画面流传输到本地的。如果本地的GPU渲染或者合成支持出现了问题，画面就可能无法正常显示。

在ARM设备上，黑屏问题最常见的原因有两个。一个是Wayland合成器对客户端渲染的支持不完善，前面提到的GDK_BACKEND=x11同样适用，可以先试。另一个是部分ARM设备的GPU驱动比较老旧，不支持OpenGL硬件加速。这种情况下可以设置环境变量，强制客户端使用软件渲染：

export VMWARE_USE_GLRENDER=0 export LIBGL_ALWAYS_SOFTWARE=1

这两个变量会让图形渲染退回到CPU软件模式，虽然画质和流畅度略有下降，但至少能正常看到桌面。

5.4 长连接掉线或卡顿

连接一段时间后频繁掉线，或者画面卡顿得像幻灯片，是另一个高频问题。在ARM设备上，这个问题的排查重点之一是网络路径上的MTU设置。有些ARM板子接的是无线网络，Wi-Fi的MTU往往比以太网低，而Horizon的数据流对MTU不一致特别敏感，容易导致分片丢失。

可以先检查自己的MTU设置：

ip link show | grep mtu

如果发现MTU和网关不一致，可以临时调整：

sudo ip link set dev wlan0 mtu 1400

另外，Horizon Client使用UDP端口来传输PCoIP和Blast协议的媒体流。如果ARM设备处于防火墙后面，而防火墙默认丢弃了UDP数据包，就会出现视频黑屏、声音卡顿但连接不断的情况。网上很多教程都会提到443端口，查下来发现UDP 4172和UDP 8443这两个端口同样重要。放行这两个UDP端口后，媒体通道的传输质量会明显改善。

• TCP 443：HTTPS握手和协议控制通道；
• UDP 4172：PCoIP媒体流传输；
• UDP 8443：Blast极端媒体流传输。

如果用telnet或者nc能通TCP端口，但UDP端口状态不确定，可以从虚拟桌面内部查看当前使用的是PCoIP还是Blast协议，再决定放行哪个UDP端口。客户端连接信息窗口里一般能直接看到协议类型，不需要额外安装抓包工具。

6. 一些建议和手法，帮助你少走弯路

整个ARM架构下的Horizon Client安装过程，看似是“下载、安装、运行”三步走，实际执行起来会牵扯到架构识别、依赖管理、图形会话、证书信任、环境变量等多个层面。我个人折腾下来最深刻的体会是：这类问题没有一劳永逸的统一解法，严守“先查环境、再排依赖、最后看日志”的顺序能省下大量时间。

有几个具体建议分享给大家。

第一，维护一份环境信息备忘。把uname -m、/etc/os-release、dpkg --print-architecture、已安装的依赖列表这些信息记录下来。遇到问题时要向别人求助或者查资料，这些信息就是最有效的上下文，能帮别人快速定位问题。

第二，离线环境下提前备齐依赖包。如果你手里的ARM设备处于不能联网的隔离环境，一定要在能联网的机器上提前把.deb包全部下载好。执行：

sudo apt install --download-only 包名

装完下载的包之后，会有一堆.deb文件缓存在/var/cache/apt/archives/目录下。把它们拷贝到U盘里带到目标机器上，再用dpkg -i *.deb批量安装，就能解决离线安装依赖的问题。

第三，不要盲目升级系统的运行库版本。在部署Horizon Client前，系统里可能已经有了一套可以正常工作的GTK或OpenSSL版本。如果因为缺依赖就疯狂apt upgrade，很容易把整个图形环境升级到一半导致其他应用崩溃。合理的做法是精确安装缺失的依赖包，而不是全量升级。我在一次部署中，就是因为顺手把系统内所有包都升级了一遍，结果桌面管理器挂了，最后只能重装桌面环境。

最后再分享一个小技巧：如果在ARM设备上需要长期使用Horizon Client，可以考虑把整个安装排查过程写成一个脚本，包括架构检测、依赖安装、证书导入、环境变量设置这几步。以后换设备或者重装系统时，跑一遍脚本就能直接进入连接阶段，完全不用重复踩坑。用文本工具把命令保存成.sh文件，放到/usr/local/bin/下，赋予执行权限，之后就能随时调用了。这套做法我用了很久，确实省心。