1. 先搞清楚三条路共享文件夹、网络共享、拖拽复制虚拟机和宿主机之间倒腾文件看着是件小事真上手才发现能走的路不止一条。我最早接触VMware共享文件夹是给它当U盘用的把宿主机的项目目录挂进虚拟机改完代码立刻编译省掉了反复拖拽的麻烦。后来陆续在 Kali、Rocky Linux、银河麒麟这些系统上折腾过也踩了不少设置好了但看不到文件重启就没了的坑索性把这些年攒下来的经验整理一遍。这篇内容适合三类人看一是刚装完 VMware Workstation、第一次听说共享文件夹的新手二是装好了却发现/mnt/hgfs空空的同学三是需要长期在多台机器之间同步文件、要一个稳定持久方案的老手。我尽量把每一步为什么要这么做讲清楚顺带把常见故障的排查思路列全照着做基本能一次跑通。1.1 三种方案的定位差异很多人一上来就问哪个最好其实得看你要干什么。我按自己在项目里的实际使用频率整理了一张对比表方案实现层面适合场景明显优势主要短板VMware 共享文件夹HGFS虚拟机监控程序直接暴露宿主机目录宿主机与虚拟机之间频繁读写代码、配置、日志配置简单、无需网络、开机即可用依赖 VMware Tools、性能一般、不支持跨物理机SMB/CIFS 网络共享走 TCP/IP标准协议多台物理机、虚拟机、电视盒子、NAS 之间互访通用性强、跨平台、可跨网段需要账号密码、防火墙和协议版本容易出问题拖拽 / 复制粘贴VMware Tools 提供的界面通道零星传一两个小文件零配置大文件卡、目录多时容易失败、Linux 桌面环境兼容性差我自己的习惯是同机内部长期协作走共享文件夹跨设备或者要接非电脑终端就走 SMB。有人喜欢挂载一个额外的虚拟磁盘做数据盘那也行但改容量、换虚拟机的时候很麻烦我一般不用。1.2 什么场景我会优先选共享文件夹举个典型的例子我在宿主机上放一份前端项目虚拟机里跑构建和测试。用共享文件夹的好处是宿主机上的编辑器改完文件虚拟机里立刻能看到变更不需要scp、不需要rsync、也不用手动同步。再比如调试内核模块或者驱动宿主机上留着源码和文档虚拟机里反复编译两边目录是同一份能省掉很多改A忘B的低级错误。还有一种情况是宿主机磁盘快满了虚拟机镜像又不想无限扩容。把大体积的数据集放在宿主机的共享目录里虚拟机以只读方式挂载镜像大小能省下一大截。这个用法我用了好几年除了性能不如本地块设备其他都挺省心。反过来要是你需要的是多台虚拟机共享一份数据或者要把文件给一台电视、一个播放器用共享文件夹就无能为力了——它只对这台虚拟机 这台宿主机生效跨不出去。这时候直接上 SMB后面的章节会细讲。注意共享文件夹不是块设备它本质是一个网络文件系统接口。不要在共享目录里放数据库文件、虚拟机磁盘文件、Git 的对象库很容易出现锁失效和性能雪崩。2. HGFS 的底子原理、前置条件与依赖2.1 共享文件夹在系统里到底长什么样先把概念捋直VMware 的共享文件夹在底层叫HGFS全称 Host-Guest File System。它不是一个真正的磁盘格式而是虚拟机监控程序和客户机里一个特殊驱动/服务组件之间的通信通道。宿主机也就是你装 Workstation 的那台电脑把指定目录登记进来客户机里的组件通过这个通道去读。在 Linux 客户机里这套东西的最终表现是一个 FUSE 文件系统挂载点通常选/mnt/hgfs。它有个很特别的地方挂载源不是/dev/sdX也不是//192.168.x.x/share而是.host:/这个虚拟路径。.host是 VMware 保留的特殊主机名冒号后面跟共享名只写.host:/表示把宿主机上所有已启用的共享目录一次性挂进来。Linux 下有个很小但极其有用的命令vmware-hgfsclient。它的作用是列出宿主机当前向这台虚拟机开放了哪些共享名。这玩意儿在排查共享文件夹设置好了但找不到的时候是第一顺位工具——如果它不输出任何东西说明问题在宿主机侧或者工具没装好根本不用去折腾挂载命令。# 列出宿主机开放的共享名 vmware-hgfsclient # 典型输出 project dataset如果这条命令提示command not found那基本可以断定 open-vm-tools 没装或者装了但组件不全往后翻第 3 节。2.2 VMware Tools 与 open-vm-tools 的关系这里是最容易绕晕的地方。历史上VMware 提供一套打包好的驱动和工具叫 VMware Tools需要你挂载 ISO、解压、跑vmware-install.pl。但这条路现在越来越难走了因为那个安装脚本对新内核的适配经常滞后编译 vmhgfs 内核模块时动不动就报错。于是各大发行版自己维护了一份开源实现叫open-vm-tools通常拆成两个包基础包和桌面增强包。基础包提供vmtoolsd、vmhgfs-fuse、vmware-hgfsclient这些核心组件桌面增强包额外提供分辨率自适应、剪贴板共享、拖拽支持。共享文件夹功能只需要基础包但桌面体验建议两个都装。我现在的原则很简单能用发行版仓库里的 open-vm-tools就绝对不去编译 VMware 官方 Tools。原因有三个一是包管理器管依赖、管升级省心二是内核升级后不用重新编译三是出问题卸载干净不会留一堆/usr/lib/vmware-tools的残留。提示那个继续运行脚本未能在虚拟机中成功运行的报错绝大多数情况就是官方 Tools 的 perl 安装脚本在你的系统上跑挂了。常见原因是缺perl、缺gcc/make、缺对应的linux-headers或者当前是 Wayland 会话导致桌面组件初始化失败。遇到这个报错别死磕脚本直接卸载改用 open-vm-tools。2.3 前置条件清单动手之前对着这张清单确认一遍能省掉后面一半的排查时间虚拟机处于关机状态较老的 Workstation 版本修改共享配置必须关机部分新版本允许运行时改但客户机侧仍要重新挂载才生效。Workstation 里共享文件夹功能已启用并且加了至少一个目录。客户机已安装 open-vm-tools或官方 Tools且systemctl status vmtoolsd是 running。客户机内核开启了 FUSE 支持现代发行版默认开启极少需要手动处理。/mnt/hgfs目录存在不存在就mkdir一个FUSE 不会自动创建挂载点。3. 从宿主机到客户机完整设置流程3.1 Workstation 侧的配置要点打开虚拟机的设置切到选项标签页找到共享文件夹。这里有三个单选禁用、总是启用、在下次关机或挂起前启用。我一般直接选总是启用因为下次关机前启用这种临时状态最容易让人忘记重启后就怀疑人生。接着点添加走一遍向导名称这是共享名也是客户机里看到的目录名。不要用中文、不要用空格虽然技术上支持但挂载参数里带空格和中文会让你在 fstab 里痛不欲生。主机路径宿主机上的真实目录。建议放在磁盘空间充足的分区上路径里也尽量别有空格。选项启用此共享、只读、禁用缓存。关于只读我的建议是不确定就先勾只读。共享目录本质上是宿主机上的真实文件虚拟机里一条rm -rf就会直接作用到你的宿主机文件上没有任何回收站缓冲。等确认没问题了再取消只读。禁用缓存这个选项对绝大多数场景不要勾。勾了以后每次读写都穿透到宿主机性能掉得很明显只有在宿主机和客户机同时高频写同一批文件、且你遇到了缓存不一致的时候才需要打开。改完设置点确定。如果虚拟机开着建议关机重启一次客户机让 vmtoolsd 重新读取配置。3.2 Linux 客户机安装与验证以 Debian/Ubuntu 系为例sudo apt update sudo apt install -y open-vm-tools open-vm-tools-desktop sudo systemctl enable --now vmtoolsdRHEL/Rocky 系sudo dnf install -y open-vm-tools open-vm-tools-desktop sudo systemctl enable --now vmtoolsd装完之后先别急着挂载按顺序验证# 第一步服务是否在跑 systemctl is-active vmtoolsd # 第二步能否看到共享名 vmware-hgfsclient # 第三步挂载 sudo mkdir -p /mnt/hgfs sudo vmhgfs-fuse .host:/ /mnt/hgfs -o allow_other -o uid1000 -o gid1000 -o umask022 # 第四步验证 ls -l /mnt/hgfs这里解释一下几个参数很多人复制粘贴了但不知道在干什么allow_other默认情况下 FUSE 挂载只有挂载者本人能访问加了这行其他用户才能看到内容。不加的话你用 root 挂载普通用户ls /mnt/hgfs就是空的——这正是共享文件夹设置了但找不到文件最常见的原因之一。uid1000,gid1000把共享目录里的文件属主映射成你的普通用户避免所有文件都显示成 root 导致没法编辑。1000是典型第一个普通用户的 ID用id命令确认一下自己的数值。umask022控制新建文件的默认权限022 等价于 755/644比较通用。如果你想只挂某一个共享而不是全部把.host:/换成.host:/共享名就行。注意如果你的系统用了 fuse3且/etc/fuse.conf里没有user_allow_other这一行非 root 用户挂载时allow_other会被拒绝。用 root 挂载不受影响但从系统一致性的角度看建议把这行打开。3.3 Windows 客户机路径与权限Windows 客户机就简单多了装好 VMware Tools 之后打开资源管理器在地址栏输入\\vmware-host\Shared Folders或者在网络位置里找到vmware-host这台电脑。共享目录会以网络文件夹的形式出现双击就能进。Windows 侧容易遇到的坑有两个一是权限继承共享目录里的文件默认继承的是宿主机那边的权限如果宿主机上的目录是仅管理员可写虚拟机里的普通账户就会写入失败二是符号链接失效宿主机上如果目录里有软链接跨过这层映射后往往解析不了。做开发目录共享的时候我会尽量把依赖目录排除掉别把整个 node_modules 一起共享过去。4. 挂载与开机自动生效三种写法实测临时挂载命令一敲就生效问题在于重启就没了。这一节专门解决持久化也是这篇文章里我认为最值得看的部分。4.1 临时挂载命令与参数含义临时挂载就一句话sudo vmhgfs-fuse .host:/ /mnt/hgfs -o allow_other -o uid1000 -o gid1000不带-o参数也能挂上但只有 root 看得见内容。很多人验证的时候用sudo ls /mnt/hgfs看到文件了然后切回普通用户发现是空的以为挂了其实没挂对。想卸载用sudo umount /mnt/hgfs # 如果提示 device is busy sudo umount -l /mnt/hgfs4.2 fstab 持久化写法与坑网上流传最广的写法是往/etc/fstab里加一行.host:/ /mnt/hgfs fuse.vmhgfs-fuse allow_other,defaults,nofail,x-systemd.automount 0 0这行能用但有几个地方必须说清楚第一fuse.vmhgfs-fuse这个类型名依赖 fuse 的/sbin/mount.fuse辅助程序。在部分较新的发行版上这个辅助程序的路径和行为有变化可能出现手动挂载成功、fstab 挂载失败的诡异现象。如果碰上直接跳到 4.3 用 systemd 单元。第二nofail一定要加。不加的话一旦 vmtoolsd 启动晚于挂载动作系统启动会卡在等待挂载上严重时进不了图形界面。第三x-systemd.automount是个好东西它把挂载改成首次访问时才挂载这样就不用纠结启动顺序。配套还可以加x-systemd.idle-timeout60闲置 60 秒自动卸载减少资源占用。第四如果/mnt/hgfs目录里原本有东西FUSE 挂载会失败并提示非空目录需要加nonempty参数或者先把目录清空。改完 fstab 后不要直接重启验证先跑sudo systemctl daemon-reload sudo mount -amount -a没报错、df -h能看到挂载点才算真成功。这一步能把 90% 的配置错误在重启前暴露出来。4.3 systemd 单元与发行版差异fstab 搞不定的系统我改用 systemd 服务单元写法长一点但可控性强得多# /etc/systemd/system/mnt-hgfs.mount [Unit] DescriptionVMware Shared Folders Aftervmtoolsd.service [Mount] What.host:/ Where/mnt/hgfs Typefuse.vmhgfs-fuse Optionsallow_other,uid1000,gid1000,umask022 [Install] WantedBymulti-user.targetsudo systemctl daemon-reload sudo systemctl enable --now mnt-hgfs.mount注意.mount单元的文件名和Where必须严格对应/mnt/hgfs对应的文件名就是mnt-hgfs.mount中间的分隔符是短横线这是 systemd 的硬性规则写错会报unit not found。如果某个发行版上.mount单元还是不行就用最笨但也最稳的 oneshot 服务# /etc/systemd/system/vmware-share.service [Unit] DescriptionMount VMware Shared Folders Aftervmtoolsd.service network.target [Service] Typeoneshot RemainAfterExityes ExecStart/usr/bin/vmhgfs-fuse .host:/ /mnt/hgfs -o allow_other -o uid1000 -o gid1000 -o umask022 ExecStop/usr/bin/umount /mnt/hgfs [Install] WantedBymulti-user.target接下来说说发行版差异这是实战里绕不开的发行版安装方式需要注意的点Ubuntu / Debianapt install open-vm-tools open-vm-tools-desktop桌面版建议装 desktop 包Wayland 下剪贴板可能仍有问题Kaliapt install open-vm-tools-desktop fuse3内核较新务必用仓库版本别编译官方 ToolsRocky Linux 9dnf install open-vm-tools open-vm-tools-desktop最小化安装没有图形环境desktop 包会拉一堆依赖纯服务器只装基础包银河麒麟 V10 SP1yum install open-vm-tools部分版本源里版本较旧vmhgfs-fuse存在但需手动挂载SELinux 开启时注意策略日志Windows 客户机装 VMware Tools走\\vmware-host\Shared Folders不需要额外挂载动作统一规律Linux 客户机几乎没有装完就自动挂载的都要自己写一次持久化配置。这一点跟 Windows 客户机完全不一样别指望它自己出现。5. 绕开 HGFS用 SMB/CIFS 做跨机共享HGFS 的边界很清楚只在宿主机和它自己的虚拟机之间有效。一旦你要连的是另一台物理机、一台 NAS、一个播放器就必须换 SMB/CIFS 了。这条路更通用但坑也更多尤其是重启后失效这个问题。5.1 Windows 端共享与凭证配置在 Windows 上选一个目录右键属性切到共享标签点高级共享勾选共享此文件夹设置共享名。然后点权限确认给谁读写。这是共享权限还有一层是安全标签里的NTFS 权限两层都放行才真正可写。我见过太多Windows 显示共享成功、Linux 挂载上去了只读的案例根子都在 NTFS 权限没给。关于凭证先澄清一个高频疑问共享文件夹本身没有独立的账号密码用的就是你 Windows 上那个系统账户。所以怎么看共享文件夹的账号密码答案是——看共享端机器的本地账户或者专门建一个专用账户给它用。出于安全考虑我不建议直接用管理员账户挂载。做法是建一个专用的本地账户只给共享目录的读写权限net user shareuser Pssw0rd /add icacls D:\share /grant shareuser:(OI)(CI)M然后用这个账户去挂载。密码存在 Linux 侧的凭证文件里权限设成 600只有 root 能读。5.2 Linux 挂载 CIFS 与重启失效修复先装工具sudo apt install -y cifs-utils # Debian/Ubuntu sudo dnf install -y cifs-utils # RHEL/Rocky手动挂载验证sudo mkdir -p /mnt/win sudo mount -t cifs //192.168.1.20/share /mnt/win \ -o usernameshareuser,passwordPssw0rd,vers3.0,uid1000,gid1000,iocharsetutf8vers3.0是 SMB 协议版本。新版 Windows 默认协商到 3.x但如果对面是 Win7、老 NAS 或者老电视盒子可能要降到vers2.1甚至vers1.0。协议版本不匹配是挂载失败的头号原因报错通常是mount error(112): Host is down或者mount error(13): Permission denied看着像权限问题其实是协商失败。凭证文件写法usernameshareuser passwordPssw0rd domainWORKGROUPsudo chmod 600 /etc/cifs-cred sudo chown root:root /etc/cifs-credfstab 持久化//192.168.1.20/share /mnt/win cifs credentials/etc/cifs-cred,uid1000,gid1000,iocharsetutf8,vers3.0,nofail,_netdev 0 0重点在_netdev和nofail这两个参数。这就是cifs 挂载共享文件夹重启后失效的根因如果不加_netdevsystemd 会认为这是个本地设备在网络还没起来的时候就去挂载必然失败失败后整个启动流程可能卡住或者干脆静默跳过。加上_netdev告诉 systemd等网络就绪再挂加上nofail表示挂了也别阻塞启动。再进一步加x-systemd.automount可以做成按需挂载//192.168.1.20/share /mnt/win cifs credentials/etc/cifs-cred,uid1000,gid1000,iocharsetutf8,vers3.0,_netdev,nofail,x-systemd.automount,x-systemd.idle-timeout300 0 0这样只有你真正访问/mnt/win的时候才会去连闲置 5 分钟自动断开。对不常访问的共享非常合适也顺带解决了开机时网络还没就绪的时序问题。5.3 Win11 访问老系统共享找不到网络路径这个场景跟前面的方向反过来了Win11 是客户端要去访问一台 Win7 或者老 NAS 的共享。报错找不到网络路径的常见原因我按出现频率排了个序第一网络配置文件是公用。Win11 默认把新识别的网络标记为公用此时防火墙会拦掉文件和打印机共享。改法设置 → 网络和 Internet → 以太网/WLAN → 网络配置文件类型 → 改成专用。第二网络发现相关服务没开。这几个服务是捆绑在一起的Function Discovery Provider Host、Function Discovery Resource Publication、SSDP Discovery、UPnP Device Host。少一个网络里就看不到对方只能靠 IP 直连。第三SMB1 客户端缺失。老系统在网络里靠 SMB1 广播自己的存在而较新的 Windows 默认不安装甚至移除了 SMB1 客户端。这不是让你无脑开 SMB1而是说浏览发现和实际传输是两件事——你完全可以绕开发现直接用\\192.168.1.30\share这样的 IP 路径访问走的是 SMB2/3 传输安全性不受影响。我的建议是优先用 IP 直连只有在必须依赖自动发现时才权衡是否启用 SMB1。第四来宾访问被禁用。如果对面的共享是密码保护关闭的免密共享新版 Windows 默认会拒绝匿名连接。注册表位置在HKLM\SYSTEM\CurrentControlSet\Services\LanmanWorkstation\Parameters下的AllowInsecureGuestAuth设为 1 才允许。考虑到安全更好的做法是给对面共享配上账号密码而不是打开来宾访问。第五新版系统的 SMB 签名要求。较新的 Windows 版本对 SMB 客户端默认要求签名遇到不支持签名的老设备会直接握手失败。可以用 PowerShell 查一下当前配置Get-SmbClientConfiguration | Select RequireSecuritySignature在受控的内网环境里必要时可以临时关掉做验证但生产环境还是要评估风险别为了连通性把安全底线撤了。还有一个很隐蔽的坑主机名解析。用主机名访问时走的是 NetBIOS 名称解析跨网段就失效。用 IP 访问最稳或者写进 hosts 文件。这也解释了为什么别人能访问、就我这台不行——往往就是解析路径不一样。6. 故障排查与实战避坑6.1 高频故障速查表这张表是我这些年攒下来的遇到问题先对号入座现象最可能的原因处理方式/mnt/hgfs是空目录没装工具或没加allow_other先跑vmware-hgfsclient无输出就装 open-vm-tools有输出就检查挂载参数vmware-hgfsclient报命令不存在open-vm-tools 未安装用发行版包管理器安装后重启 vmtoolsd挂载报非空目录挂载点里已有文件清空目录或加nonempty普通用户看不到共享内容缺allow_other或 fuse.conf 未开加参数并在/etc/fuse.conf打开user_allow_other能读不能写宿主机侧勾了只读或 uid/gid 不对检查共享选项用id确认 uid重启后挂载消失没做持久化或时序不对用 fstab nofailx-systemd.automount或 systemd 单元CIFS 重启失效缺_netdev补上_netdev,nofail后systemctl daemon-reloadmount error(13)凭证错误或协议版本不匹配先手动挂载验证再逐个试vers3.0/2.1/1.0mount error(112)协议协商失败或目标不可达用ping和nc -zv ip 445确认连通性Win11 提示找不到网络路径网络类型为公用 / 服务未开 / 解析失败改专用网络用 IP 直连文件时间戳全是同一个值缓存策略问题改为直写模式取消客户端缓存共享目录下git status极慢FUSE 层元数据性能差把 Git 仓库放本地盘只共享源码目录6.2 我踩过的几个坑第一个坑也是最坑的一次宿主机的共享目录我勾了只读然后花了一个多小时排查 Linux 侧的权限。ls -l显示权限正常、uid 也对就是写不进去最后回到 Workstation 设置里才看到那个勾。教训是排查顺序一定要从外往里先看虚拟机配置再看客户机内部。第二个坑跟缓存有关。我在共享目录里跑过一个持续写日志的程序宿主机上同时用编辑器打开这个日志文件看。结果两边看到的内容对不上宿主机上还是几分钟前的版本。原因是宿主机侧的缓存把写入缓冲住了。解决办法要么打开禁用缓存要么干脆别在共享目录里做这种高频写入的场景。共享文件夹适合一份数据、一处写、多处读不适合多处同时写。第三个坑是Git 仓库的性能。有一阵我把整个项目连同.git目录一起共享进虚拟机git status要跑十几秒。换成把仓库放在虚拟机本地磁盘、只把源码目录共享出来的方案后速度立刻正常。FUSE 层处理大量小文件和元数据操作的效率跟本地文件系统不在一个量级上这个差距在.git/objects这种小文件特别多的目录里会被无限放大。第四个坑发生在 CIFS 那条路上。我给一台 Rocky Linux 配了开机自动挂载 NASmount -a手工测试完全正常重启后整个系统卡在启动画面上键盘都没反应。原因就是漏了nofail——NAS 那次正好没开机挂载请求一直重试把启动流程堵死了。凡是涉及网络的挂载nofail和_netdev应该是肌肉记忆级别的默认配置。6.3 卸载重装时的清理有时候折腾半天不行卸载重装反而是最快的路。但 VMware 相关组件的卸载有个特点残留很多。Windows 上的卸载失败、装一半中断最容易出现的情况是注册表里留下一堆项导致重装时提示已安装或者直接失败。这种时候需要专门清理把服务、驱动、注册表项、残留目录都清干净再重装。Linux 侧的清理相对简单包管理器能搞定# Debian/Ubuntu sudo apt purge open-vm-tools open-vm-tools-desktop sudo apt autoremove # RHEL/Rocky sudo dnf remove open-vm-tools open-vm-tools-desktop清完记得把/mnt/hgfs、/etc/fstab里的挂载行、以及自己写的 systemd 单元一并删掉否则重装后会出现重复挂载或者单元找不到目标的问题。另外提一句授权的事虚拟化软件的授权走官方渠道买就行网上那些来路不明的许可证密钥看着省事实际上可能带后门或者过段时间就失效团队环境里尤其不要用。这类风险不值得省那点钱。6.4 关于网卡和虚拟网络的一点补充共享文件夹虽然不依赖网络但 SMB 方案依赖所以顺带说一个容易混淆的点VMware 的虚拟网络模式有桥接、NAT、仅主机三种。桥接模式下虚拟机跟宿主机在同一网段SMB 互访最省事NAT 模式下宿主机访问虚拟机需要端口映射虚拟机访问宿主机没问题反向就麻烦仅主机模式则完全隔离外网都上不去。我配 SMB 共享的时候一律让虚拟机走桥接或者 NAT只在需要虚拟机访问宿主机的场景下用 NAT这样 IP 相对稳定。如果虚拟机里拿不到 IP先别怀疑共享文件夹去检查虚拟网络编辑器里的网卡绑定和 DHCP 设置这两件事经常被混为一谈。7. 最后聊几句实际感受折腾了这么多台机器我现在对共享文件夹的态度是能一次配好、持久生效就不再动它。临时挂载那套命令我很熟但绝对不会用在日常环境里因为第二天开机发现文件没了的那种感觉实在不想再体验。所以每装一台新虚拟机我的固定动作是——装 open-vm-tools、确认vmware-hgfsclient能列出共享名、写一条带nofail和x-systemd.automount的持久化配置、mount -a验证、重启再验证一次。这五步走完后面几个月基本不用再管它。要是你只记一件事那就记住这条共享路径.host:/不是设备它是通道通道两头的服务都得活着。宿主机侧共享要开着客户机侧 vmtoolsd 要跑着FUSE 挂载点要存在四件事缺一件/mnt/hgfs就是空的。排查的时候从这四件事往外查比乱翻日志快得多。