最近帮好几个同事处理Ubuntu虚拟机的问题几乎所有人都卡在同一关VMware Tools 装不上。要么菜单里的“安装 VMware Tools”点了没反应要么直接弹出一句VMware Tools is no longer shipped with VMware Workstation for this guest operating system然后就是一堆脚本报错。其实这件事在新版 VMware Workstation 17 之后变化很大很多老教程已经不完全适用了。这篇就把当前环境下的安装方案整理清楚分两条路走一条是推荐优先使用的 open-vm-tools另一条是传统的手动挂载 ISO 编译安装最后把安装过程中的高频报错和排查思路一起列出来。这篇内容适合刚接触虚拟机的学生、运维人员和开发工程师尤其是那些在 Ubuntu 虚拟机里做完系统后发现分辨率只能固定在 800x600、复制粘贴不生效、拖拽文件老是失败的人。看完之后你不仅能顺利装完 Tools还能搞明白每一步为什么这么做以后再遇到类似问题自己就能排查不用满网找教程。1. 先搞清楚你的 VMware Tools 到底该走哪条路1.1 VMware Tools 到底管什么用很多人觉得 VMware Tools 就是一个“装上去就能用增强功能”的玩意儿实际上它是一组驱动和服务直接影响你日常用虚拟机的体验。核心功能有五项图形分辨率的自动适配。没装 Tools 之前Ubuntu 桌面版的分辨率往往锁定在 800x600 或 1024x768窗口拉伸也不会自动调整装完之后虚拟机窗口一拖桌面分辨率跟着变非常顺滑。剪贴板共享。没装 Tools宿主机和虚拟机之间的文字复制粘贴是死路你得用共享文件夹或临时网络服务折腾装完 Tools 之后复制、粘贴、拖拽文件都可以直接用。鼠标流畅度。没装 Tools 前鼠标进出虚拟机窗口经常要点一下才能释放光标装完之后光标切换无缝。虚拟硬件驱动的补齐。包括虚拟显卡、虚拟网卡、SCSI 设备的高级支持直接影响显示性能和网络稳定性。主机与虚拟机的时间同步。VMware Tools 会定期把宿主机时间同步到虚拟机避免虚拟机每次休眠后时间漂移。如果你只是偶尔开一下虚拟机可能觉得“不装也能凑合用”但做开发、跑实验、传文件的人用几次就受不了。这不是可装可不装的组件而是虚拟机体验的基础设施。1.2 新版 VMware 的变化为什么菜单安装失灵了以前安装 VMware Tools 很无脑在 VMware Workstation 菜单栏点“虚拟机 - 安装 VMware Tools”虚拟机里就会挂载一个linux.iso然后解压运行vmware-install.pl就完事了。但 VMware 在 17.x 版本之后改变了分发策略尤其从 17.5、17.6 这两个版本开始“Linux.iso 中的 VMware Tools”逐渐不再随 Workstation 一起提供给新版 Linux 发行版。菜单栏的“安装 VMware Tools”选项要么置灰要么提示VMware Tools is no longer shipped with VMware Workstation for this guest operating system。第一次遇到这个提示的兄弟别慌不是你的安装包坏了而是官方调整了支持方式。VMware 现在的推荐方案是让客户机直接使用 Linux 发行版仓库里的open-vm-tools包。这个包是开源的功能和传统 VMware Tools 基本一致而且它是随系统仓库维护的升级内核时不容易出兼容性问题。对 Ubuntu 用户来说这条路线远比手动编译 ISO 干净。1.3 两条安装路线怎么选根据我的实际经验可以按下面的原则快速判断场景推荐路线原因Ubuntu 桌面版带 GUIopen-vm-tools open-vm-tools-desktop无需编译仓库安装支持剪贴板和分辨率适配Ubuntu 服务器版无 GUIopen-vm-tools体积小功能足够必须用传统 VMware Tools 的兼容性场景手动挂载 ISO 编译少数老项目或特殊环境要求老版本 VMware如 Workstation 15/16传统 ISO 或 open-vm-tools 均可菜单安装仍然可用但 open-vm-tools 更省事主推 open-vm-tools 路线原因很简单省时间、少报错、好维护。传统 ISO 编译路线也不是没用——当你遇到网络受限、仓库源不好用、或者老板指名要装官方 Tools 的时候就得靠它救场。两条路都得会。2. 安装前的系统准备能省掉 80% 的报错2.1 确认 VMware 版本和 Ubuntu 版本这步虽然不起眼但非常重要。不同版本的组合遇到的行为完全不一样。先看 VMware Workstation 版本打开“帮助 - 关于 VMware Workstation”就能看到比较常见的版本是 16.x 和 17.x。再看 Ubuntu 版本终端执行lsb_release -a cat /etc/os-release内核版本也顺手看一眼uname -r为什么要先确认版本因为我在实际排查中发现很多人的问题其实是版本信息错位导致的。比如网上搜到一个 15.x 版本的安装教程照着在 Workstation 17.6 里操作发现菜单都没有自然就卡住了。先确认版本后面选择才准确。2.2 更新软件源和安装编译工具链无论走哪条路我都建议先把 Ubuntu 的软件源刷新一遍这能解决很多依赖缺失的问题。sudo apt update sudo apt upgrade -y这里有个细节apt upgrade可能会顺便升级内核。如果内核升级了建议先重启虚拟机继续下面的步骤因为接下来所有跟内核相关的操作都必须和当前运行内核版本对齐。你不想在一个旧内核上编译驱动结果重启后进了新内核一切白干。如果是走传统 ISO 编译路线还需要安装编译工具链sudo apt install -y build-essential这个包会把 gcc、g、make 等基础编译工具一起装上。很多编译过程中报gcc: command not found或者make: command not found的朋友基本都是漏了这一步。2.3 内核头文件必须和当前内核严格对应内核头文件是什么简单理解VMware Tools 需要编译一些内核模块来对接虚拟机硬件编译时必须要用到当前内核的开发头文件。如果你系统里装的头文件版本和正在运行的内核版本不一致编译过程就会报错。安装命令是sudo apt install -y linux-headers-$(uname -r)注意这里的$(uname -r)会动态替换成当前内核版本号比如5.15.0-91-generic所以装出来的头文件一定和当前内核匹配。还有一个很实用的小技巧安装完头文件后可以查看一下目录确认是否真的装上了。ls -la /usr/src/linux-headers-$(uname -r)正常的目录里应该有include、arch、Makefile这些内容。如果目录不存在或者为空说明头文件没装成功建议重新执行安装命令这时不要跳过否则后面必报错。3. 推荐路线open-vm-tools 命令行安装3.1 安装命令与桌面版差异open-vm-tools 的安装非常简单Ubuntu 官方仓库里直接有包。如果是服务器版无图形界面执行sudo apt install -y open-vm-tools如果是桌面版带 GUI我强烈建议多装一个 desktop 包sudo apt install -y open-vm-tools open-vm-tools-desktopopen-vm-tools-desktop这个包很关键它包含了图形界面需要的动态库和辅助服务比如分辨率自动适配、剪贴板共享、拖拽文件就是靠它实现的。多次遇到有人说“我装了 open-vm-tools 但还是不能复制粘贴”绝大多数情况就是没装这个 desktop 包。安装完成后服务会自动启动。可以验证一下systemctl status open-vm-tools看到输出里有active (running)就说明服务正常。如果你用的是桌面版还应该能看到和图形相关的进程可以用下面的命令确认ps -ef | grep vmtoolsd安装阶段到这里就基本结束了整个过程两分钟内就能完成这也是我推荐这条路线的核心原因。3.2 安装后立刻应该做的 3 个验证装完不等于完事我习惯按下面的顺序做一轮快速验证全屏或拖拽窗口看 Ubuntu 桌面分辨率是否自动变化。如果之前是 800x600 的固定分辨率装好后窗口变大时桌面应该跟着调整。从宿主机复制一段文字在虚拟机里按 CtrlV确认能粘贴进去。再反向测试一次从虚拟机复制切回宿主机粘贴。直接拖拽一个文件从宿主机到虚拟机桌面看文件是否能复制过去。这三个测试全部通过说明 VMware Tools 的核心功能都正常了。如果复制粘贴不行优先怀疑没装open-vm-tools-desktop如果拖拽不行还要检查 VMware 菜单里的“虚拟机 - 设置 - 选项 - 客户机隔离”中是否启用了拖放功能。3.3 open-vm-tools 怎么升级和维护open-vm-tools 走的是 Ubuntu 仓库源的更新节奏日常维护几乎不用管。当你升级内核版本时open-vm-tools 服务通常会通过 DKMS 或动态模块重构机制配合比传统手动编译的方式省心太多。如果你升级内核后发现服务异常可以强制重装一次让服务重新配置sudo apt install --reinstall -y open-vm-tools open-vm-tools-desktop sudo systemctl restart open-vm-tools绝大多数情况下这样操作就能恢复。另外如果你之前装过传统 VMware Tools再装 open-vm-tools 前建议先把旧的卸载干净避免两个版本的服务互相干扰这个后面章节会细说。4. 传统路线手动挂载 linux.iso 安装虽然 open-vm-tools 很香但总有一些场景需要走传统路线比如项目模板要求、离线环境、或者你老板坚持要“官方 Tools”。为了应对这些情况传统安装方法也得会。4.1 怎么拿到 VMware Tools 安装镜像新版 VMware Workstation 里如果菜单“安装 VMware Tools”是置灰的不要慌系统里其实还有安装镜像文件。在 Windows 宿主机上VMware Tools 的 ISO 文件通常存放在C:\Program Files (x86)\VMware\VMware Workstation\linux.iso注意路径里的(x86)是 Windows 上常见的如果你安装到其他盘符按实际安装路径去找就行。拿到linux.iso后可以在 VMware 虚拟机设置中挂载这个 ISO 文件打开“虚拟机 - 设置 - CD/DVD (SATA) - 使用 ISO 映像文件”浏览选择linux.iso勾选“启动时连接”确定即可。这样相当于给 Ubuntu 虚拟机插入了一张光盘。这种方式比依赖菜单栏靠谱能够绕过新版菜单置灰的问题。4.2 挂载 ISO 并解压ISO 挂载后在虚拟机里要先挂载光驱才能读取文件。首先确认设备名lsblk | grep -i cdrom一般你会看到类似/dev/sr0或/dev/cdrom的设备。然后创建挂载点并挂载sudo mkdir -p /mnt/cdrom sudo mount /dev/cdrom /mnt/cdrom如果 mount 不成功检查一下 ISO 是否真的连上了lsblk里没有设备的话多半是虚拟机设置里没挂好。挂载成功后可以看到目录下有一个VMwareTools-*.tar.gz文件。使用通配符复制这组文件到/tmp并解压是更稳妥的方式版本号不同不会影响cp /mnt/cdrom/VMwareTools-*.tar.gz /tmp/ cd /tmp tar -zxvf VMwareTools-*.tar.gz解压后目录通常是/tmp/vmware-tools-distrib这就是安装程序所在位置。4.3 编译安装的完整命令流进入解压目录运行安装脚本cd /tmp/vmware-tools-distrib sudo ./vmware-install.pl如果你不想一路手动回车确认可以直接加-d参数表示使用默认选项自动安装sudo ./vmware-install.pl -d安装过程中脚本会检查内核头文件和编译器如果缺失会提示先安装。这也是前面我强调准备工作的原因。安装完成后脚本会尝试启动服务输出大致如下Enjoy, the VMware team. vmware-tools-services: started vmware-tools-thinprint: started这时候建议顺手重启虚拟机sudo reboot重启后可以验证 Tools 是否正常运行vmware-toolbox-cmd -v能输出版本号就说明安装成功。4.4 安装脚本卡住或失败的几种情况传统编译安装最怕遇到的就是卡在某个环节不动。我遇到过的典型情况有三种缺少内核头文件。这时的报错通常包含Unable to find the kernel header字样解决办法就是回到第 2 章安装linux-headers-$(uname -r)。编译器版本过新导致模块源码不兼容。比如 Ubuntu 24.04 自带的 GCC 13 比较新某些老版本 VMware Tools ISO 源码无法正常编译。遇到这种报错要么换用 open-vm-tools要么调整 GCC 版本。安装到最后提示“脚本未能成功运行”。这个更常见原因五花八门我把它放在后面常见问题部分专门细说。总的来说传统路线不是不能走只是对环境要求更苛刻。如果你不是非用不可我更建议装 open-vm-tools。5. 装完不等于完事功能验证与配置5.1 分辨率自适应为什么没生效用 open-vm-tools 也遇到分辨率不自动适配的问题通常原因是图形界面服务没起来。这时候先检查 desktop 包是否安装dpkg -l | grep open-vm-tools确认有open-vm-tools-desktop输出。如果没装补装上再重启虚拟机sudo apt install -y open-vm-tools-desktop sudo reboot还有一种情况比较隐蔽Ubuntu 默认使用的显示服务器Wayland 或 Xorg会影响 Tools 的自动缩放效果。目前 VMware Tools 对 Xorg 的适配最成熟Wayland 下某些功能会打折。如果你在 Wayland 下遇到分辨率异常可以切换到 Xorg 登录试试。切换方式很简单登录界面点用户头像后右下角或右上角通常会有一个齿轮图标选择 “Ubuntu on Xorg” 即可。5.2 剪贴板共享和拖拽文件剪贴板共享是 Tools 装好之后最直观的功能但也有不灵的时候。我建议按这个顺序排查虚拟机菜单栏“虚拟机 - 设置 - 选项 - 客户机隔离”确认勾选了“启用复制粘贴”和“启用拖放”。确认 desktop 包已安装服务在运行。如果以上两项都正常试试重启虚拟机。很多人在安装 Tools 前就开着编辑器装完后功能没生效以为是装失败。我的经验是安装完 Tools 后一定要重启虚拟机让加载模块和服务全部重新初始化很多“装了但没用”的问题都能靠重启解决。拖拽文件功能依赖 VMware Tools 的图形支持如果纯命令行环境SSH 连接里操作拖拽肯定用不了这不是问题是环境限制。5.3 共享文件夹挂载vmhgfs-fuseVMware 的“共享文件夹”功能是宿主机和虚拟机之间互传文件的另一个途径由 Tools 里的 vmhgfs-fuse 提供支持。首先在虚拟机设置中添加共享目录菜单“虚拟机 - 设置 - 选项 - 共享文件夹”选择“始终启用”添加宿主机上的一个目录即可。虚拟机内手动挂载的命令sudo mkdir -p /mnt/hgfs sudo vmhgfs-fuse .host:/ /mnt/hgfs -o allow_other这里.host:/表示挂载宿主机上所有共享目录到/mnt/hgfs。allow_other选项允许普通用户访问。不指定的话挂载后往往只有 root 能进目录普通用户打不开这也是大家经常遇到的一个坑。为了开机自动挂载可以修改/etc/fstab.host:/ /mnt/hgfs fuse.vmhgfs-fuse allow_other,defaults 0 0改完先执行sudo mount -a测试一下没问题再重启验证。如果 fstab 写错导致开机卡住只需要在启动时进入恢复模式把这一行删掉即可这个技巧关键时刻能救命。5.4 时间同步问题装了 Tools 后时间同步默认是启用的但有些 Ubuntu 系统年代比较久、配置不对时还是会发生时间漂移。手动强制同步一次可以这样操作sudo vmware-toolbox-cmd timesync enable sudo vmware-toolbox-cmd timesync sync另外要留意 Ubuntu 本身的时间同步机制systemd-timesyncd 或 chrony如果系统自带的 NTP 和宿主机时间差异太大也会出现反复跳变的现象。通常我会这样处理虚拟机里关闭 NTP 自动校时完全依赖宿主机通过 VMware Tools 进行时间同步。这样更符合虚拟机场景的逻辑——虚拟机的时间基准就是宿主机。关闭 systemd-timesyncdsudo timedatectl set-ntp false systemctl stop systemd-timesyncd然后重新启用 Tools 的时间同步sudo vmware-toolbox-cmd timesync enable这样配置之后每次宿主机时间变化虚拟机都会跟着对齐特别适合依赖精确时间的开发测试环境。6. 常见问题排查速查6.1 “继续运行脚本未能在虚拟机中成功运行”这个报错在传统编译安装时出现的频率极高那句话完整的是“继续运行脚本未能在虚拟机中成功运行。如果您在此虚拟机中配置了自定义解决方案请运行命令或手动执行脚本来解决问题。”说实话这句话很笼统它其实来源于 VMware Tools 安装到最后阶段脚本退出码非零。常见的根源有两个一是内核模块编译失败二是服务注册失败。我的排查步骤是这样的首先看安装日志sudo tail -100 /var/log/vmware-tools-install.log日志里通常能看到具体是哪一步返回了错误码。如果是内核模块相关的报错先确认头文件是否匹配重新安装一遍linux-headers-$(uname -r)再重跑安装脚本。如果是服务注册时报错多半是 systemd 服务文件冲突清理旧文件再重装。一个比较有效的办法是先把以前的 Tools 彻底卸载sudo /usr/bin/vmware-uninstall-tools.pl或者sudo apt purge open-vm-tools -y清理干净后重新安装。如果折腾两轮还是报错我建议干脆放弃这条路切换到 open-vm-tools。不要在一个坑里耗太久这是虚拟化运维的老经验。6.2 提示“VMware Tools is no longer shipped with VMware Workstation”新版 VMware 针对较新的 Ubuntu 版本直接不再提供 ISO 里的 Tools 了。如果你在菜单里看到这句话别灰心这不代表你不能获得 Tools 功能只是官方把“生产 Tools”这件事外包给了发行版仓库。解决办法很简单直接安装 open-vm-tools 就行。装完之后功能是等价的菜单里的提示可以忽略。要注意的是以后看到任何旧的教程让你“虚拟机 - 安装 VMware Tools”在新版本里可能走不通自己在心里换成sudo apt install open-vm-tools就行。6.3 vmnet1 网络适配器感叹号、SSH 连不上这类问题虽然严格来说不完全属于 Tools 安装范围但几乎每个装 Ubuntu 虚拟机的人都遇到过而且经常会和 Tools 的操作前后脚出现。先看 vmnet1 或 vmnet8 在 Windows 设备管理器里出现黄色感叹号的情况。这通常是 VMware 虚拟网卡驱动没装好或被其他软件干扰了。处理方式是打开 VMware Workstation 菜单“编辑 - 虚拟网络编辑器”。点击左下角“更改设置”再点击“恢复默认设置”。如果仍然不行到 Windows 的“设备管理器”里把带感叹号的 VMware 虚拟网卡卸载然后扫描检测硬件改动让系统重新安装驱动。SSH 连不上的问题则要分两层排查先看网络是否通再看 SSH 服务是否启动ping -c 3 宿主机IP sudo systemctl status ssh如果 SSH 服务没启动先安装并开启sudo apt install -y openssh-server sudo systemctl enable ssh --now从宿主机访问虚拟机时网络模式建议用 NAT 或桥接确认虚拟机和宿主机在同一网段。在排查实际环境时NAT 模式下直接把虚拟机 IP 指到网段内通常就能连通。6.4 内核升级后 Tools 失效不管是 open-vm-tools 还是传统 Tools内核升级之后偶尔会出现模块加载失败。open-vm-tools 因为走仓库源适配一般很快你只要做一次系统升级就能拉入新模块包。sudo apt update sudo apt upgrade -y sudo reboot传统 Tools 则可能需要重新编译。你可以重新运行一遍安装脚本它会检测到已有安装并重新配置cd /tmp/vmware-tools-distrib sudo ./vmware-install.pl升级内核前留意一下当前用的 Tools 类型做好对应预案问题就不大。6.5 常见问题速查表现象可能原因快速处理复制粘贴不生效缺 open-vm-tools-desktop安装 desktop 包并重启分辨率不自动适配图形服务未启动检查服务状态切换到 Xorg拖拽文件失败客户机隔离关闭设置里勾选拖放并重启脚本运行失败内核头文件缺失/编译错误查看安装日志装头文件重试提示 no longer shipped新版 VMware 不支持 ISO Tools改用 open-vm-tools时间漂移tools 时间同步未开启用 vmware-toolbox-cmd timesync共享目录无法访问挂载选项缺少 allow_other重新挂载并加 allow_othervmnet1 感叹号虚拟网卡驱动异常虚拟网络编辑器恢复默认6.6 我最后想提醒的几个坑先说说“装完就删”的问题。很多人在实测完 Tools 功能之后就随便卸载了其实没必要。open-vm-tools 本身很小服务占用的资源也极少留着只会让你的虚拟机更稳定。再说说“到底选哪个”的问题。如果你在 VMware Workstation 17.x 上我的建议是默认 open-vm-tools。不要因为网上教程说“官方 ISO 安装更完整”就去折腾在实际的操作结果上两者功能差不多但 open-vm-tools 的维护成本低得多。最后提一个容易被忽略的细节如果你是在公司或者学校的内网环境软件源用的可能是内部镜像源。镜像源同步不及时会导致open-vm-tools版本老旧功能有残废。遇到这种环境可以先切回官方源执行一次安装装完后再切回内网源或者干脆用传统 ISO 安装作为备选。这个思路我用了很多次屡试不爽。