简介Unlocker 3.0.3 是一套面向 macOS 用户与 VMware 虚拟机使用者的文件解锁工具包主要处理文件或文件夹被后台进程占用后无法删除、移动、重命名的情形尤其针对 VMware 15.5.1 环境中的文件锁定问题。压缩包大小为 15.62MB共 21 个文件包含 cmd、sh、py 脚本和 exe 可执行程序并配有 txt、md 说明文档及许可证文件这些内容分别承担安装、卸载、更新、测试与跨平台调用等用途目录划分清楚方便按平台和功能检索。目前已有 2057 人学习下载。其价值在于提供一套可直接使用的解锁工具与配套脚本帮助读者在不必关闭整个虚拟机、应用补丁后无需重启的情况下释放被占用文件同时通过对不同系统脚本与说明文档的对照理解工具在 macOS、Windows 及 Linux 环境下的调用差异适合需要排查文件锁定、虚拟机文件占用问题的技术人员参考。1. 打补丁之前先对齐版本unlocker 3.0.3 只认这几代 VMware上周有位开发者找我说他在 VMware 里装完 unlocker 3.0.3论坛里常写成 unlocker303新建虚拟机向导里始终没有 macOS 选项于是又去搜各种 osx unlocker 分支越搜越乱。这类 macos unlocker 补丁包的坑往往不在补丁本身而在版本对齐3.0.3 只跟某一代 VMware 的二进制对得上宿主的 VMware 一旦升到 16.2 之后脚本要么报补丁失败要么打完让 VMware 直接打不开。这套东西适合手上是 Workstation 15/16 早期版本、需要长期留一台 macOS 客户机做构建验证的人。装之前先把版本对齐比急着双击 unlock.exe 重要得多。2. 环境准备清单VMware 版本、Python 3 与一份能回滚的备份在动手解压之前我习惯先把三件事确认清楚宿主上的 VMware 是哪个版本、补丁要在哪个平台上跑、出事后靠什么退回去。这三件事里任何一件没落实后面都会变成“补丁打了一半、VMware 打不开、机器上还有没提交的虚拟机”的连环事故。unlocker 3.0.3 的工作原理并不复杂——它在 VMware 的几个核心二进制里做字节级替换让虚拟化层认得darwin这一类客户机类型同时让图形界面把 macOS 的条目放出来。正因为是直接改二进制版本匹配就是一切版本对了两条命令结束版本错了补丁程序找不到匹配的字节序列要么中途退出要么把文件改坏。2.1 宿主与 VMware 版本对照先说结论性的判断3.0.3 这个版本号对应的是 VMware 15 后期到 16 早期那一段。下面这张表是我自己装过的组合加上社区反馈整理的不是压缩包里的官方声明实际以你机器上的版本号为准但大方向不会差太多VMware 版本unlocker 3.0.3 表现建议Workstation 15.0 ~ 15.5正常打补丁向导出现 macOS 条目可以直接用Workstation 16.0 / 16.1多数能成功个别需要重跑一次可用打完必须验证Workstation 16.2 及以上常见补丁失败或打完启动异常换更新的 unlocker 分支别硬上Workstation 17.x基本不适配不要用 3.0.3Player 15 / 16 早期与 Workstation 同源一般可用可用Fusion 11.x / 12.0macOS 宿主可用走 macos 目录下的脚本需要 sudoESXi不适用这套补丁不针对 ESXi怎么确认版本Windows 上打开 VMware菜单里“帮助 → 关于”版本号会写成16.1.2 build-17966106这种形式前面的16.1才是关键build 号不用管。Linux 上vmware --version或者vmplayer --version都能打出来。macOS 宿主看 Fusion 的“关于”面板。确认完版本再决定要不要继续这一步能省掉后面一多半的排查时间。提示VMware 默认会在后台检查更新补丁打完过几天又被自动升级覆盖是这类工具最常见的“玄学失效”。装之前先去“编辑 → 首选项 → 更新”里把自动更新关掉。2.2 Python 3 与管理员权限的两处硬性要求三个平台的执行方式不一样别混用。Windows 侧的windows目录里是一个打包好的unlock.exe不依赖 PythonLinux 和 macOS 侧是unlocker.py必须用 Python 3 跑Python 2 会直接语法报错。所以先在终端确认一下版本# Linux / macOS 宿主机上先确认解释器版本 python3 -V # 期望输出 Python 3.6 以上如果只装了 python 没装 python3先补装再继续 which python3python3 -V输出里的大版本必须是 3小版本 3.6 起就够用脚本本身没用到新语法但 3.6 以前的 f-string 支持不全。which python3是确认你 sudo 之后调用的还是同一个解释器——有些机器上 root 的 PATH 和普通用户不同sudo python3会指向另一个残缺的环境这种情况在自定义编译过 Python 的机器上不算少见。权限这块没有讨价还价的余地Windows 上必须“以管理员身份运行”因为要写Program Files下的 DLLLinux 和 macOS 上必须加sudo因为要改/usr/lib/vmware或/Applications里的文件。普通权限跑下去脚本通常会在写文件那一步报Permission denied然后停在半路——这是最坏的情况因为前面的文件已经改了一部分。2.3 备份先拷四个文件再动手补丁程序自己会生成备份但我从不只依赖它。原因很实际如果补丁在中途失败它自己的备份目录可能只写了一半如果 VMware 已经升级过一版备份里的旧文件和当前版本对不上恢复回去反而更糟。手动拷一份原始文件成本不到一分钟是这套流程里唯一的后悔药。Windows 上需要备份的是安装目录下的四个文件用管理员 PowerShell 跑# 源目录按实际安装路径改64 位系统上可能没有 (x86) $src C:\Program Files (x86)\VMware\VMware Workstation $dst D:\vmware-backup-$(Get-Date -Format yyyyMMdd) New-Item -ItemType Directory -Path $dst -Force | Out-Null # 这四个是 unlocker 会改动的目标文件原样留一份 foreach ($f in vmwarebase.dll,vmware-vmx.exe,vmware-vmx-debug.exe,vmware-vmx-stats.exe) { Copy-Item (Join-Path $src $f) -Destination $dst -Force } Get-ChildItem $dst | Select-Object Name,Length,LastWriteTime$src要按你机器上的真实路径改有的机器装在C:\Program Files\VMware\VMware Workstation。$dst建议放在系统盘之外别和 VMware 同盘避免恢复时被占用。最后那行Get-ChildItem会列出文件名、大小和修改时间打补丁之后再跑一次同样的命令时间戳变了的文件就是被改过的这是后面验证环节的依据。Linux 和 macOS 侧的备份命令# Linux把会被改动的二进制拷到独立目录 sudo mkdir -p /root/vmware-backup-$(date %F) sudo cp -av /usr/lib/vmware/bin/vmware-vmx* /root/vmware-backup-$(date %F)/ sudo cp -av /usr/lib/vmware/lib/libvmwarebase.so.0/libvmwarebase.so.0 /root/vmware-backup-$(date %F)/ ls -l /root/vmware-backup-$(date %F)/ # macOSFusion 的文件在 app 包内部 sudo mkdir -p ~/vmware-backup-$(date %F) sudo cp -av /Applications/VMware Fusion.app/Contents/Library/vmware-vmx ~/vmware-backup-$(date %F)/ sudo cp -av /Applications/VMware Fusion.app/Contents/Library/libvmwarebase.dylib ~/vmware-backup-$(date %F)/vmware-vmx系列是真正执行虚拟机的进程vmwarebaseLinux 上是libvmwarebase.so.0macOS 上是libvmwarebase.dylib负责界面和客户机类型数据库补丁主要动这两处。通配符vmware-vmx*会一起带上-debug和-stats两个变体它们同样会被替换漏备份的话出问题只能重装 VMware。-av参数是为了看到每个文件的拷贝过程心里有数。3. 三平台打补丁unlock.exe 与 unlocker.py 的执行细节环境确认完、备份落地之后才轮到执行。这一章按平台分开写因为三个平台的失败点完全不同Windows 上多数问题出在进程没关干净和权限不对Linux 上多半是路径和 Python 解释器macOS 上则常常卡在 app 包的权限和签名保护上。执行前有一个共同前提——所有 VMware 进程必须停掉包括后台的vmware-vmx和认证服务否则文件被占用补丁写到一半就报错。3.1 Windows以管理员身份跑 unlock.exe先把压缩包解压到一个不带中文和空格的路径比如D:\tools\unlocker-master3.03。解压后能看到windows、linux、macos三个子目录Windows 上只需要关心windows这一个。用管理员身份打开 PowerShell先停进程再执行# 1. 停掉所有 VMware 相关进程和服务文件被占用会导致补丁失败 Get-Process vmware*,vmnat*,vmnetdhcp* -ErrorAction SilentlyContinue | Stop-Process -Force Stop-Service -Name VMAuthdService -Force -ErrorAction SilentlyContinue # 2. 进到解压目录的 windows 子目录 cd D:\tools\unlocker-master3.03\windows # 3. 先让工具自身做一次备份再打补丁 .\unlock.exe backup .\unlock.exe第一段的两条命令分别处理用户态进程和系统服务-ErrorAction SilentlyContinue是为了在进程本来就不存在时不刷一屏红字不影响结果。unlock.exe backup会在当前目录生成一份工具自己的备份和 2.3 里手拷的那份互为保险。不带参数的.\unlock.exe就是执行安装屏幕上会逐行打印正在处理的文件和结果正常结束时能看到类似Patching done的收尾行。如果中途出现Failed to open file八成是权限不够或者进程没关干净回到第一步重来不要在半失败的状态下继续。回滚同样简单.\unlock.exe restore会把工具备份里的文件写回去。但如果补丁是在 VMware 升级之后打的restore 回去的是旧版本文件VMware 可能起不来这时候要用 2.3 手拷的那份覆盖回去或者干脆重装 VMware。这是我一般会提醒的顺序先试 restore不行再手动覆盖。注意部分安全软件会把unlock.exe判定为风险程序并直接隔离。执行前把解压目录加进白名单或者临时关闭实时防护装完再打开。文件被静默删掉时报错信息往往只有一句“系统找不到指定的文件”很容易误判成解压不完整。3.2 Linux 与 macOSpython3 unlocker.py 的正确姿势Linux 侧的执行目录是linuxmacOS 侧是macos两边脚本同名但内部处理的文件路径不同不能交叉使用。执行前同样要先停 VMware# Linux停服务、确认没有残留的虚拟机进程 sudo systemctl stop vmware 2/dev/null pgrep -a vmware sudo pkill -f vmware-vmx # 进到解压出来的 linux 目录用 root 跑安装 cd ~/Downloads/unlocker-master3.03/linux sudo python3 unlocker.py installpgrep -a vmware是列出所有匹配的进程和完整命令行输出为空才说明停干净了pkill -f vmware-vmx针对的是虚拟机执行进程有些桌面环境下服务停了但虚拟机窗口还开着这一步能兜住。unlocker.py install会把补丁应用到/usr/lib/vmware/bin/和/usr/lib/vmware/lib/下的目标文件输出里能看到逐个文件的处理结果。卸载用sudo python3 unlocker.py uninstall参数就这两个没有更多隐藏开关。macOS 上把目录换成macos命令结构一样# macOS 宿主先退出 Fusion再执行 osascript -e quit app VMware Fusion 2/dev/null cd ~/Downloads/unlocker-master3.03/macos sudo python3 unlocker.py installosascript那行是通过脚本让 Fusion 正常退出比直接 kill 更稳妥能避免虚拟机状态文件写坏。如果在install阶段看到Operation not permitted通常是终端没有拿到修改 app 包的权限去“系统设置 → 隐私与安全性 → 完全磁盘访问权限”里把终端加进去重开终端再跑一次。3.3 补丁到底动了哪些文件改完怎么确认补丁跑完不能只看它打印了什么要看文件本身。最直接的判断是时间戳打完补丁后vmware-vmx、vmware-vmx-debug、vmware-vmx-stats和vmwarebase这四个文件的修改时间应该都变成刚刚其余文件不变。如果只有一两个变了说明补丁中途失败了。Windows 上重新跑一遍 2.3 里的Get-ChildItem对比LastWriteTimeLinux 上用ls -l --time-stylelong-iso /usr/lib/vmware/bin/vmware-vmx*macOS 上ls -l /Applications/VMware Fusion.app/Contents/Library/。除了时间戳还有一个更硬的证据——补丁目录下会生成backup文件夹里面的文件大小应该和你手拷的那份一致这也顺便验证了你的备份是干净的。这一步还有个容易被忽略的点如果之前打过更老版本的 unlocker目标文件里已经带着旧补丁的字节3.0.3 的匹配逻辑可能找不到预期序列而报失败。遇到这种情况正确做法是先用旧版本的卸载命令还原或者直接用备份覆盖回去再做一次干净安装而不是反复重跑新补丁。4. 新建 macOS 客户机向导选项与 vmx 参数的取舍补丁生效之后新建虚拟机向导里应该能看到 macOS 的条目了。但“能看到”和“能装起来”是两回事这一步的参数给错最常见的表现是卡在启动的第一屏或者安装器跑到一半报硬件不支持。这一章讲的是我给 macOS 客户机配参数时的习惯以及.vmx文件里那几行必须手写、不能指望向导自动带出来的配置。4.1 客户机操作系统与硬件参数怎么给向导里选“客户机操作系统”时如果有多个 macOS 版本可选选一个和你手上安装镜像接近的即可选高了选低了都能装只是默认硬件模板略有差别。硬件参数我的习惯是这样配置项建议值说明内存8 GB宿主至少 16 GB给到 4 GB 安装阶段容易卡处理器2 核勾选“虚拟化 Intel VT-x/EPT”相关选项不勾会非常慢硬盘80 GB单文件安装器本身占 20 GB 上下留足余量显卡512 MB勾选 3D 加速显存给小了进桌面会花屏固件类型UEFI不要开安全启动网络NAT桥接在部分环境下拿不到地址USB3.1兼容性比 2.0 好内存和处理器这两项是最容易抠门的。安装阶段内存低于 4 GB经常出现进度条走到一半停住日志里只留一句内存分配失败处理器核心给多了反而会因为调度问题变慢2 核是最稳的取值。硬盘选“拆分成多个文件”在机械盘上有意义固态盘上单文件性能更好也方便整体拷贝。安装镜像的处理要单独说一句客户机要的是能被 VMware 识别的光盘映像手上如果是 dmg 格式需要先转换成 iso 或 cdr 才能在向导里选。转换工具和方法各平台都有这里不展开只提醒一点——转换出来的文件要校验大小和挂载后的目录结构转换失败的镜像在启动时会表现为黑屏几秒后直接退出日志里没有明显报错很容易误判成补丁问题。4.2 vmx 里那几行必须手写的配置向导建完虚拟机之后先别急着开机。到虚拟机目录下找到.vmx文件用文本编辑器打开确认或补上这两行# 关掉 SMC 版本校验缺这一行典型表现是开机第一屏直接崩 smc.version 0 # 让客户机机型信息与宿主解耦避免被识别成不受支持的机型 board-id.reflectHost FALSE hw.model MacPro7,1smc.version 0是这套环境里最有名的一行作用是把系统管理控制器报告的版本号清零绕开客户机对虚拟硬件的版本检查。缺了它虚拟机会在启动最开始的几百毫秒内退出日志里留下一条与vcpu-0:VERIFY相关的记录。board-id.reflectHost设成FALSE是为了不让客户机直接继承宿主的机型标识配合hw.model指定一个具体的机型安装器在早期硬件检查阶段会更配合。网上很多老教程会贴一大串cpuid.0.eax之类的参数让你一起抄进去。这些行在旧版本的玩法里确实需要但 3.0.3 打完补丁之后新建虚拟机向导通常已经把这些处理好了手动再写一遍反而可能因为位数写错导致启动失败。我的做法是只写上面这三行启动有问题再回头看日志不要一次把所有“传说中要加的行”全加上——真出问题时你根本分不清是哪一行导致的。改完.vmx记得保存然后开机。如果这台虚拟机之前已经开过一次并失败先“放弃”当前状态再开机否则它可能从上次的挂起状态恢复读不到你新加的配置。4.3 装系统前后的两个小动作进入安装器之前把虚拟机的 BIOS/UEFI 启动顺序确认一遍确保光驱在硬盘前面否则空硬盘会被判定为无可启动设备。安装过程本身比较长中途会重启两三次每次重启前把光驱断开或者调整启动顺序避免又回到安装器首屏。装完之后第一件事是装 VMware Tools。macOS 客户机里的 Tools 安装包在 Fusion 侧是随 app 提供的Workstation 侧需要在虚拟机菜单里点“安装 VMware Tools”它会挂载一个虚拟光盘。装上之后鼠标可以无缝移动、分辨率自适应、剪贴板也能通。不装的话能跑但操作体验会差到让你怀疑补丁没打对。装完 Tools 再做一次快照后面折腾任何配置都能一键回到这个干净状态。5. 常见问题排查五条打补丁翻车记录这一章是我自己踩过、也帮别人收拾过的五类问题按发生频率从高到低排。每一条都按“现象 → 原因 → 解决”写遇到对应症状直接对照不用从头读。5.1 打完补丁 VMware 直接打不开现象双击 VMware 图标没有任何窗口任务管理器里进程闪一下就消失Linux 上命令行启动会打印一行与libvmwarebase相关的错误后退出。原因补丁改写的二进制和当前 VMware 版本不匹配。3.0.3 的目标是 15.x 到 16.1 那一段宿主的 VMware 如果是 16.2 以上补丁程序即便报告成功改出来的文件也是坏的。解决立即回滚别反复重装补丁。Windows 上用.\unlock.exe restore或 2.3 的备份覆盖四个文件Linux 和 macOS 用sudo python3 unlocker.py uninstall失败就手动覆盖备份。恢复后先确认 VMware 能正常打开再考虑换一个与版本匹配的 unlocker 分支或者把 VMware 降回 16.1。5.2 向导里始终没有 macOS 选项现象补丁程序报告执行完成但新建虚拟机向导的客户机列表里仍然只有 Windows 和 Linux 系列。原因三种可能——没有用管理员权限跑vmwarebase写不进去执行时 VMware 进程还在文件被占用补丁跳过了这一项或者执行的是linux目录的脚本但宿主其实是 Windows。解决先看时间戳如果vmwarebase的修改时间没变就是根本没改到。关掉所有 VMware 进程用管理员身份重跑一次跑完立刻看时间戳。仍然不行就说明补丁版本和目标版本不匹配参考 2.1 的表换版本。判断依据是补丁输出里有没有出现“找不到匹配模式”一类的提示有的话就是版本问题不是权限问题。5.3 开机第一屏就崩日志里有 vcpu-0:VERIFY现象点开机后虚拟机窗口一闪而过或者停在一个纯黑画面虚拟机目录下的vmware.log里能搜到vcpu-0:VERIFY和bugNr字样。原因.vmx里缺smc.version 0客户机在启动最早期做硬件版本校验时失败。解决关机状态下编辑.vmx补上这一行再开机。如果已经加过还是崩检查是不是加到了另一台虚拟机的配置文件里或者文件末尾有重复的键导致后面的值覆盖了前面的。还有一种情况是虚拟机之前挂起过配置改动不生效先“放弃挂起状态”再开机。5.4 卡在启动画面安装器进不去现象能看到启动画面进度条走一点就停住或者安装器界面出来但报硬件不支持、内存不足。原因镜像格式不对、内存给少了、固件类型选成了传统 BIOS、或者开了安全启动。解决按顺序排查——先把内存提到 8 GB 试一次再确认虚拟机设置里固件是 UEFI 且安全启动关闭最后检查镜像把转换出来的 iso 在宿主上挂载一次看目录结构是否完整。三步都过还不行换一个来源不同的镜像试排除镜像本身的问题。5.5 用几天之后补丁突然失效现象前几天还能用某次开机后向导里的 macOS 选项消失了或者虚拟机开机报客户机类型不受支持。原因VMware 后台自动升级把vmwarebase和vmware-vmx换成了官方新版本补丁被覆盖另一种情况是安全软件把打过补丁的二进制当成可疑文件隔离了。解决先看 VMware 版本号有没有变化变了就是升级导致重新打一次补丁同时把自动更新彻底关掉。版本没变的话检查安全软件的隔离记录把 VMware 安装目录和 unlocker 目录都加进白名单。这件事会反复发生我的习惯是升级 VMware 之前先确认手上有没有对应的补丁版本没有就先不升。6. 验证跑通三层确认别只看向导里有没有那个选项补丁装完最省事的验证方式是打开新建虚拟机向导看一眼列表但这一眼只能证明界面层生效了证明不了虚拟机真能跑起来。我给自己的规矩是三层都过一遍任何一层不过就当作没装好。第一层是界面层向导的客户机列表里出现 macOS 条目第二层是配置层新建一台虚拟机后.vmx里能正常写入guestOS darwin19这类值保存、关闭、重开 VMware 之后这个值还在第三层是运行层真的开机进到安装器界面跑完一轮安装中途没有因为硬件检查失败退出。第三层最关键也最容易被跳过。很多人看到向导里有选项就认为完事了等真要用的时候才发现开机就崩。运行层的判断依据不只是“能看到安装界面”还要看日志# 开机后实时盯日志重点看 smc 和 vcpu 相关的行 tail -f ~/vmware/macOS客户机目录/vmware.log | grep -Ei smc|vcpu|darwin # 安装完成后确认客户机类型确实写进了配置文件 grep -i guestos ~/vmware/macOS客户机目录/*.vmx第一条命令里的grep -Ei是忽略大小写做扩展匹配smc对应系统管理控制器的校验vcpu对应虚拟 CPU 的启动检查这两类关键字是补丁失效时最先冒出来的。第二条命令用来确认客户机类型被正确持久化输出里应该是guestOS darwin19之类的值如果为空或者还是other说明向导里选的类型没保存成功需要重新走一遍新建流程。把三层验证对应到具体动作我一般按这张表逐项打勾验证层看哪里通过标准界面层新建虚拟机向导的客户机操作系统列表出现 macOS 各版本条目配置层虚拟机目录下的 .vmx 文件guestOS 值为 darwin 开头重启 VMware 后不丢运行层虚拟机窗口 vmware.log进入安装器界面日志无 smc / vcpu 报错三层都通过之后再做一次快照然后才把 2.3 里手拷的备份目录归档留底。备份不要急着删下次 VMware 升级或者换机器迁移的时候还会用到。确认顺序也别颠倒——先快照再删备份是我很早以前吃过亏之后定下的习惯有一次我确认补丁生效就把备份清了结果第二天 VMware 自动更新把文件覆盖虚拟机直接起不来只能从头重装宿主上的 VMware。希望帮到你。本文还有配套的精品资源点击获取