1. 前提检查#

确认系统已安装 VMware Tools：

1
rpm -q open-vm-tools open-vm-tools-desktop

确认相关命令存在：

1
which vmhgfs-fuse vmware-hgfsclient vmtoolsd

确认 VMware 已经把共享目录暴露给客户机：

1
vmware-hgfsclient

如果这里能列出共享目录名，例如：

1
Share
2
Work

说明 VMware 共享文件夹功能已经正常。

2. 创建用户级 systemd 服务#

创建目录：

1
mkdir -p ~/.config/systemd/user

写入服务文件 ~/.config/systemd/user/vmhgfs-mount.service：

1
[Unit]
2
Description=Mount VMware shared folders in the user session
3
Documentation=https://github.com/vmware/open-vm-tools
4
ConditionVirtualization=vmware
5
ConditionPathExists=/usr/bin/vmhgfs-fuse
6

7
[Service]
8
Type=simple
9
ExecStartPre=/usr/bin/mkdir -p %h/hgfs
10
ExecStartPre=/usr/bin/bash -lc '/usr/bin/mountpoint -q %h/hgfs && /usr/bin/fusermount3 -u %h/hgfs || true'
11
ExecStart=/usr/bin/bash -lc '/usr/bin/vmhgfs-fuse .host:/ %h/hgfs -f -o uid=$(id -u),gid=$(id -g),auto_unmount'
12
ExecStop=/usr/bin/bash -lc '/usr/bin/mountpoint -q %h/hgfs && /usr/bin/fusermount3 -u %h/hgfs || true'
13
Restart=on-failure
14
RestartSec=2
15

16
[Install]
17
WantedBy=default.target

说明：

• 挂载点固定为 ~/hgfs
• .host:/ 表示挂载“所有共享文件夹”的根
• 这不是硬编码某一个共享目录
• uid=$(id -u) 和 gid=$(id -g) 会在服务启动时读取当前用户的实际编号
• 因此不需要假设当前用户一定是 1000:1000
• 后续你在 VMware 里新增共享目录后，重新登录或重启后会自动出现在 ~/hgfs/ 下

3. 启用服务#

1
systemctl --user daemon-reload
2
systemctl --user enable --now vmhgfs-mount.service

检查状态：

1
systemctl --user status --no-pager vmhgfs-mount.service

--no-pager 的作用是禁止 systemctl 调用分页器（例如 less），让结果直接一次性输出完，适合脚本和非交互环境。

如果你修改过服务文件，记得重新加载：

1
systemctl --user daemon-reload
2
systemctl --user restart vmhgfs-mount.service

4. 验证挂载结果#

查看挂载状态：

1
findmnt ~/hgfs

查看共享目录：

1
ls -la ~/hgfs

正常情况下会看到类似：

1
~/hgfs/Share
2
~/hgfs/Work

5. 后续维护#

如果你在 VMware 里新增了共享目录：

• 通常重新登录图形会话即可生效
• 或者手动刷新服务

1
systemctl --user restart vmhgfs-mount.service

如果你删除了某个共享目录：

• 重新登录或重启服务后，对应目录会从 ~/hgfs 下消失

6. 卸载或回滚#

停止并禁用服务：

1
systemctl --user disable --now vmhgfs-mount.service

删除服务文件：

1
rm -f ~/.config/systemd/user/vmhgfs-mount.service
2
systemctl --user daemon-reload

如果还需要移除挂载点目录：

1
rmdir ~/hgfs

7. 设计说明#

这份配置选择的是“登录后自动挂载”，不是“系统开机但用户未登录时就挂载”。

这样做的原因：

• vmhgfs-fuse 本身非常适合在用户会话里运行
• 不需要 root 配置
• 对 niri + dms 这类轻量会话环境更直接
• 挂载目录在用户家目录下，权限模型更简单
• 服务启动时动态读取当前用户的 UID/GID，适合跨机器复用

如果你需要的是系统级挂载，例如固定挂到 /mnt/hgfs，可以另做一个 root 级的 systemd mount/service 方案，但那是另一套配置。