简介在VMware环境中配置主机与Linux虚拟机之间的共享文件夹是开发与测试人员提升文件交换效率的常见需求。这份图文教程面向VMware Workstation或Fusion用户系统讲解了从开启共享文件夹、安装VMware Tools到挂载hgfs并验证效果的完整流程内含每一步的操作截图与注意事项可帮助初学者避开常见配置误区。资源为单个PDF文档体积仅675KB内容精炼且便于随时查阅。目前已吸引5100余人学习下载说明其实用性得到不少用户认可。通过阅读这份PDF读者可以掌握共享文件夹的底层挂载原理学会编辑fstab实现开机自动挂载并了解在主机与虚拟机之间双向传输文件、同步开发代码的操作方法。相比零散的网上问答这份教程将关键环节集中整理尤其适合刚接触Linux虚拟化环境、需要快速搭建共享目录的读者。若按步骤操作通常可在数分钟内完成配置并看到/mnt/hgfs下出现主机共享文件。1. VMware 共享文件夹为什么装了 VMware Tools 还是看不到 /mnt/hgfsVMware 共享文件夹是 Windows 主机和 Linux 虚拟机之间最常用的文件交换方式配置思路看着简单虚拟机设置里把主机目录加进共享列表装好 VMware Tools然后访问 /mnt/hgfs。但真正动手时最容易翻车的不是前两步而是最后一步——Tools 装完/mnt/hgfs 目录却迟迟不出现或者出现了但里面什么都没有。网上教程东一句西一句有人写 mount -t vmhgfs有人写 vmhgfs-fuse还有人把双系统的挂载方法套进来越查越乱。这篇文章从 GUI 设置、Tools 安装、hgfs 挂载一路讲到问题排查适合用 VMware Workstation Pro 跑 Ubuntu、CentOS、Debian 等发行版的开发测试场景也适合刚接触虚拟机共享文件夹的读者照着步骤复现。2. VMware 共享文件夹的配置链路GUI 设置与 VMware Tools 安装2.1 为什么共享文件夹必须依赖 VMware Toolshgfs 文件系统与 vmhgfs-fuseVMware 的共享文件夹没有走传统 SMB 或 NFS 协议它依赖的是 VMware Tools 提供的 hgfsHost Guest File System虚拟文件系统。虚拟机里看到的 /mnt/hgfs实际上是主机共享目录通过虚拟化层映射进来的结果。没有 VMware Tools虚拟机里就没有对应的驱动和挂载工具哪怕你在虚拟机设置里已经加了共享目录Linux 客户机里也什么都看不到。这一点和双系统完全不同双系统可以直接读取主机分区但虚拟机里的 Linux 看到的磁盘是虚拟化的直接访问主机文件必须靠 HGFS 这一层翻译。hgfs 的挂载方式在新旧版本里差别很大。老版本 VMware Tools 会编译一个 vmhgfs 内核模块挂载时用 mount -t vmhgfs .host:/ /mnt/hgfs新版本开始改用 FUSE 用户态文件系统命令是 vmhgfs-fuse。VMware 之所以逐步转向 FUSE是因为用户态文件系统不用针对每个 Linux 内核版本重新编译模块升级内核后 Tools 还能继续工作。判断你的环境该用哪一种先执行 vmware-hgfsclient它会列出当前主机共享给虚拟机的所有共享文件夹名称。如果这个命令没有输出后面所有挂载操作都相当于在空地上盖楼。在方案选型上HGFS 适合传源代码、镜像、配置文件、安装包这类中小文件如果是几十 GB 的数据库文件或者需要跨多台虚拟机共享同一份数据建议直接用 SMB 或 NFS不要死磕 HGFS。下面是三种方案的简单对比方案依赖条件性能特征典型场景HGFS必须安装 VMware Tools虚拟化层中转中小文件友好主机与单台虚拟机互传配置/代码SMB需要网络可达和账号权限网络开销大配置复杂多台机器共享一个目录NFS需要配置服务端性能较好适合内网多台 Linux 虚拟机共享存储2.2 虚拟机设置里开启共享文件夹三个关键选项打开 VMware Workstation Pro在菜单栏选择“虚拟机”-“设置”切到“选项”标签页左侧找到“共享文件夹”。这里的默认状态是“禁用”必须改成“总是启用”然后点击“添加”按钮把主机目录加进来。这个环节我见过太多人只添加了目录忘了把单选按钮从“禁用”改成“总是启用”结果 Tools 装完还是看不到共享内容。如果选了“在下一次开启或关机时启用”当前会话不会立即生效你可能要重启虚拟机才能看到结果这也会被误判成共享失败。添加共享目录时有三个地方一定要看。第一是“名称”这一栏是虚拟机侧显示的名字建议用纯英文短名比如 share、code、data不要用带空格和中文的名称否则后面 fstab 和命令行里写起来非常难受。第二是“主机路径”指向 Windows 下的真实目录比如 D:\vmware_share尽量避免放在系统盘和需要管理员权限的目录里。第三是“启用此共享”勾选状态读写场景千万别勾“只读”一旦勾上虚拟机里只能读不能写后面查权限问题会绕一大圈。如果共享目录里临时文件很多可以在“在虚拟机和主机之间暂不共享这些文件”的排除列表里把临时目录加进去减少 HGFS 扫描开销。改完这些设置如果虚拟机正在运行建议不要只在界面上点确定而是直接重启虚拟机。HGFS 服务在 Tools 安装后要重新初始化设置文件里新增的共享路径也要等重新读取配置才会生效。这一条虽然听起来很基础但确实是不少人反复卡住的“玄学”点。2.3 安装 VMware ToolsISO 方式与 open-vm-tools 方式传统安装步骤的第一步是让虚拟机的光驱指向 VMware 安装目录下的 linux.iso。在虚拟机设置里找到 CD/DVD 设备选择“使用 ISO 镜像文件”指定 linux.iso 的路径然后启动虚拟机。正常情况下桌面会自动弹出 VMware Tools 的光盘图标如果没有手动挂载也不复杂# 查看光驱设备名一般叫 /dev/cdrom lsblk # 创建挂载目录并挂载光盘 sudo mkdir -p /media/cdrom sudo mount /dev/cdrom /media/cdrom # 查看光盘内容确认 VMwareTools 压缩包存在 ls -l /media/cdrom把压缩包复制到本地目录再解压而不是直接在光盘目录里解压是因为安装脚本执行时间长光盘介质是只读的放在里面容易出现奇怪的中断问题复制出来也更方便清理。下面这段是标准安装流程# 创建临时目录并进入 sudo mkdir -p /opt/vmware-tools cd /opt/vmware-tools # 复制安装包并解压 sudo cp /media/cdrom/VMwareTools-*.tar.gz . sudo tar -zxvf VMwareTools-*.tar.gz # 进入解压目录执行安装脚本 cd vmware-tools-distrib sudo ./vmware-install.pl执行 vmware-install.pl 时大部分提示直接回车使用默认值即可遇到 yes/no 的选择根据场景回答。比如询问是否保留旧配置文件时如果你没有旧配置选 no 更干净询问是否启用 vmhgfs 模块时默认 yes。安装脚本跑完后一定要看最后几行日志确认内核模块是否编译成功。如果看到 kernel module build failed 之类的提示说明系统缺少内核编译依赖需要先补齐再重跑# Ubuntu / Debian 系 sudo apt install gcc make linux-headers-$(uname -r) # CentOS / RHEL 系 sudo yum install gcc make kernel-devel如果不走 ISO 这套流程也可以直接用发行版仓库里的 open-vm-tools。Ubuntu / Debian 上安装 open-vm-tools 和 open-vm-tools-desktopCentOS / RHEL 上用 yum 或 dnf 安装 open-vm-tools。仓库里这些包已经按你的内核版本预编译好省掉了手动编译的步骤。但有一个前提如果之前装过官方 ISO 的 VMware Tools先把旧 Tools 卸载干净否则两个 Tools 的服务会抢同一个 HGFS 通道共享目录时好时坏。3. 把共享目录挂到 /mnt/hgfs手动挂载与开机自动挂载3.1 先验证再挂载vmware-hgfsclient 和手动挂载命令Tools 装完先不要急着动挂载点先执行 vmware-hgfsclient 验证主机共享是否已经能被虚拟机“看见”。这个命令非常关键它决定了后面所有挂载操作值不值得做。vmware-hgfsclient如果输出你之前设置的共享名比如 share说明 Tools 和主机的 HGFS 通道已经建立。如果命令不存在说明 Tools 没有正确安装如果命令存在但没有任何输出说明虚拟机设置里的共享文件夹功能没有启用或者“总是启用”没有勾上。看到无输出时回到第 2.2 节检查设置不要继续硬挂载。验证没问题后创建挂载点并选择挂载方式。新版本 Tools 一般用 vmhgfs-fuse老版本可以用 mount -t vmhgfs。两种方式我都列出来# 先确认当前用户 uid 和 gid id # 创建挂载点 sudo mkdir -p /mnt/hgfs # 方式一FUSE 挂载推荐新版 Tools 使用 sudo vmhgfs-fuse .host:/ /mnt/hgfs -o allow_other -o uid1000,gid1000 # 方式二内核模块挂载老版本 Tools 使用 sudo mount -t vmhgfs .host:/ /mnt/hgfs命令里的 .host:/ 表示主机上配置的所有共享文件夹根目录/mnt/hgfs 是虚拟机里的访问入口。uid 和 gid 要从 id 命令的输出里拿比如普通用户 ubuntu 的 uid 是 1000gid 也是 1000。带上这两个参数挂载后的文件才会归属于这个用户否则所有文件可能显示为 root 所有普通用户只能看不能写。allow_other 允许非 root 用户访问挂载点如果你只用 root 登录可以省略。挂载完成后执行 ls /mnt/hgfs应该能看到 share 目录。如果显示为空不要反复换挂载参数先回到 vmware-hgfsclient 检查底层通道是否正常。3.2 写入 /etc/fstab自动挂载的正确姿势手动挂载确认没问题后再配置开机自动挂载。fstab 这一行如果写错轻则挂载失败重则启动流程卡住。下面是一行经过验证的配置sudo nano /etc/fstab # 在文件末尾追加 .host:/ /mnt/hgfs fuse.vmhgfs-fuse allow_other,uid1000,gid1000,defaults,nofail 0 0fstab 六个字段的含义需要完全理解尤其是第三列和第四列。字段值说明设备.host:/HGFS 根目录挂载点/mnt/hgfs客户机访问入口文件系统类型fuse.vmhgfs-fuse新版 Tools 用 FUSE 类型老版本写 vmhgfs挂载选项allow_other,uid1000,gid1000,defaults,nofail权限和容错配置dump0不进行 dump 备份fsck0启动时不检查文件系统这里最容易被忽略的是 nofail。它告诉系统即使挂载失败也不要中断启动过程继续进入系统。没有 nofail一旦 HGFS 服务在启动阶段还没准备好系统可能会卡在等待挂载的环节。uid/gid 记得改成你自己的用户 ID不要照抄 1000。改完 fstab 不要立刻重启先执行 sudo mount -a 测试再用 df -h /mnt/hgfs 确认是否挂载成功。如果 mount -a 报错大概率是文件系统类型写错对照 Tools 版本改成 fuse.vmhgfs-fuse 或 vmhgfs。3.3 验证双向读写从主机放文件虚拟机里看自动挂载配置完成后一定要做双向读写验证只验证单向很容易漏掉权限问题。先在 Windows 主机共享目录里新建一个 test.txt写入任意内容回到虚拟机终端执行ls -l /mnt/hgfs/share/ cat /mnt/hgfs/share/test.txt能读出来说明正向同步没问题。再反向测试在虚拟机里向共享目录写入文件echo from linux /mnt/hgfs/share/from_linux.txt然后切回 Windows确认 from_linux.txt 已经出现。如果虚拟机写入时提示 Permission denied排查顺序是共享设置里是否勾了只读挂载参数里 uid/gid 是否对应allow_other 是否存在。最后一个容易忽略的点是性能HGFS 适合传代码和配置文件不适合在共享目录里直接跑数据库或大量碎文件读写这种场景下虚拟化文件系统的性能很难看老老实实用磁盘镜像或 NFS 更靠谱。4. 共享文件夹挂载问题排查五个常见坑与对应处理4.1 装了 VMware Tools 却看不到 /mnt/hgfs现象安装脚本显示成功但 /mnt/hgfs 目录不存在或者存在但里面是空的。原因最常见的是虚拟机设置里共享文件夹没有选“总是启用”或者设置完没有重启虚拟机。其次是 VMware Tools 安装过程中内核模块编译失败HGFS 驱动没有真正装上。还有可能是旧版 Tools 残留和新 Tools 冲突导致服务起不来。解决先执行 vmware-hgfsclient 看有没有输出再用 vmware-toolbox-cmd -v 确认 Tools 版本最后用 lsmod | grep vmhgfs 检查内核模块是否加载。如果 vmhgfs-fuse 路径下找不到可执行文件说明 Tools 安装不完整重新跑 vmware-install.pl。编译失败时先装 gcc、make、kernel-devel 再重装。4.2 mount 时提示 unknown filesystem type hgfs现象执行 sudo mount -t vmhgfs .host:/ /mnt/hgfs 时系统报 mount: unknown filesystem type hgfs。原因新版本 VMware Tools 不再提供 vmhgfs 内核模块改用 vmhgfs-fuse 用户态方式工作。你用的老命令无法识别这个文件系统类型。解决改用 vmhgfs-fuse 命令或者把 fstab 里的文件系统类型改成 fuse.vmhgfs-fuse。如果 vmhgfs-fuse 不存在先安装 fuse 包# Ubuntu / Debian sudo apt install fuse # CentOS / RHEL sudo yum install fuse然后重新安装 VMware Tools 或 open-vm-tools。4.3 能挂载但权限不对普通用户无法写入现象ls 能看到共享目录里的文件但创建文件时提示 Permission deniedsudo 写入却正常。原因挂载时没有指定 uid/gidHGFS 虚拟文件系统默认把目录所有权给了 root普通用户自然没有写入权限。解决重新挂载补上 -o uid1000,gid1000,allow_other数字换成你自己用户的 ID。同时把 fstab 里的挂载选项同步修改否则重启后还会犯同样的错。4.4 重启后 /mnt/hgfs 空了但手动 mount -a 又正常现象开机进入系统后/mnt/hgfs 目录不存在或为空手动执行 sudo mount -a 又能成功挂载。原因fstab 里文件系统类型写错导致自动挂载失败或者挂载点在 systemd 处理时还不存在也可能 HGFS 服务启动时序晚于 fstab 挂载。缺少 nofail 的情况下挂载失败还可能拖累启动过程。解决把 fstab 里的类型改成 fuse.vmhgfs-fuse加上 nofail 和 defaults确认 /mnt/hgfs 目录存在。执行 systemctl daemon-reload 重载配置再重启验证。4.5 Windows 侧提示“输入的文件夹似乎无效”或路径不被接受现象在虚拟机设置里添加共享文件夹时主机路径填了带中文、空格或特殊字符点击确定后 VMware 报错提示输入的文件夹无效。原因VMware 对共享路径中的特殊字符处理不友好中文路径和空格在部分版本里会导致 HGFS 服务解析异常。解决改用纯英文短路径例如 D:\vmware_share共享名称也用英文。不要放在 Windows 系统目录或需要管理员权限的位置避免权限叠加导致虚拟机侧访问受限。5. Ubuntu、CentOS、Debian 下共享文件夹的安装差异从 VMware Tools 到 open-vm-tools5.1 Ubuntu / Debian 系open-vm-tools 与桌面环境兼容Ubuntu 22.04、Debian 12 这类发行版官方仓库里的 open-vm-tools 版本通常很新和内核的兼容性比 VMware 官方 ISO 里的预编译包更好。在桌面环境里我建议同时安装 open-vm-tools-desktop这个包负责剪贴板共享、拖放文件和分辨率自适应纯服务器环境可以只装 open-vm-tools。sudo apt update sudo apt install open-vm-tools open-vm-tools-desktop安装完成后同样用 vmware-hgfsclient 验证。如果之前用过官方 ISO 的 VMware Tools先执行 vmware-uninstall-tools.pl 卸载再装 open-vm-tools。两套 Tools 同时存在时HGFS 服务会互相抢占出现挂载时好时坏的问题。这一点在 Ubuntu 上尤其常见因为 Ubuntu 的内核更新频繁官方 Tools 预编译模块跟不上open-vm-tools 却能跟着仓库一起升级。5.2 CentOS / RHEL 系yum/dnf 安装后的内核依赖CentOS 7 用 yumCentOS Stream 和 Rocky Linux 用 dnf安装包名字一致sudo yum install open-vm-tools # 或 sudo dnf install open-vm-toolsCentOS 上走官方 ISO 安装最容易碰到的是 gcc、make、kernel-devel 没装全vmware-install.pl 编译 vmhgfs 内核模块时直接失败。很多教程只让你一路回车不会告诉你失败后要补这些依赖。我一般会先确认当前内核版本再安装对应的 kernel-develuname -r sudo yum install gcc make kernel-devel注意 kernel-devel 的版本要跟 uname -r 输出严格一致否则编译出来的模块加载不上。如果你用的是 dnf把 yum 换成 dnf 即可。5.3 老版本 Workstation 与新 Tools 的搭配别硬抄旧命令网上大量教程还停留在老版本 Workstation 和 Tools 的写法比如 mount -t vmhgfs。但新版 Workstation 安装后的 Tools 已经逐渐用 vmhgfs-fuse 替代内核模块你甚至可能在 /usr/bin 下找不到 vmhgfs-fuse。遇到这种混乱情况我一般用三条命令定位which vmhgfs-fuse ls /usr/lib/vmware-tools/modules/binary vmware-hgfsclient第一行确认 FUSE 工具是否存在第二行查看内核模块编译产物第三行确认 HGFS 通道是否正常。如果前两个都没有建议直接用发行版仓库的 open-vm-tools。如果你用的是 Ubuntu、Debian、CentOS 之外的国产桌面发行版仓库里一般也维护了对应内核版本的 open-vm-tools直接安装省事得多不要看着老教程去手动编译内核版本一变很容易又翻车。5.4 Secure Boot 导致模块无法加载现象open-vm-tools 安装成功vmware-hgfsclient 也有输出但挂载时报 Failed to open vmhgfs 或模块加载失败。原因系统开启了 Secure Boot未被签名的 vmhgfs 内核模块被拒绝加载。这个问题在 UEFI 模式安装的 Linux 里更常见尤其是一些预装系统的笔记本或品牌工作站。解决一种方式是进入 BIOS 关闭 Secure Boot但这需要重启另一种方式是给模块签名过程相对繁琐。如果你只是测试环境建议直接在虚拟机设置里把虚拟机固件改为传统 BIOS 或关闭 Secure Boot。生产环境则要评估安全策略不要为了一个共享文件夹随意关闭安全启动。6. 更稳的开机自动挂载方式让 systemd 接管 mnt-hgfsfstab 在这个场景下我吃过不少亏尤其是 HGFS 服务在开机阶段还没就绪时fstab 会静默跳过挂载。与其修改 fstab 猜顺序我更愿意写一个 systemd mount 单元把“依赖 VMware Tools 服务”这个条件明确写进去。下面是我一直在用的模板# /etc/systemd/system/mnt-hgfs.mount [Unit] DescriptionMount VMware Shared Folders Aftervmware-tools.service Requiresvmware-tools.service [Mount] What.host:/ Where/mnt/hgfs Typefuse.vmhgfs-fuse Optionsallow_other,uid1000,gid1000,nofail [Install] WantedBymulti-user.target写完执行 systemctl daemon-reload systemctl enable --now mnt-hgfs.mount然后用 systemctl status mnt-hgfs.mount 查看状态。如果失败journalctl -u mnt-hgfs.mount 输出的日志比 fstab 的无声失败清晰得多。这个单元相当于把 fstab 里那行配置搬到了 systemd 管理下但多了对 vmware-tools.service 的显式依赖挂载时机更可控。Options 里的 uid/gid 必须换成你自己用户的 IDnofail 保留确保 Tools 服务异常时系统还能正常启动进入桌面。从那以后我每次配置共享文件夹都会先写这个单元文件再验证双向读写顺序一旦反过来就很容易掉进玄学挂载失败的坑里。希望这个习惯能帮到你下次遇到虚拟机共享文件夹问题时少走点弯路。本文还有配套的精品资源点击获取