VMware Unlocker工具使用教程：从问题排查到自动化部署完全指南

VMware解锁工具（Unlocker）是一款用于为VMware虚拟机添加macOS虚拟机支持的必备工具。当您升级VMware Workstation或Player后，原有的补丁会因程序文件被覆盖而失效，导致macOS虚拟机无法正常运行。本文将通过问题排查→解决方案→进阶技巧的递进式框架，帮助您系统掌握补丁恢复的完整流程，确保跨版本环境下的稳定运行。

问题排查：VMware升级后常见故障分析

补丁失效症状识别

升级VMware后，若出现以下情况，通常表明Unlocker补丁已失效：

• 新建虚拟机时无macOS选项
• 现有macOS虚拟机无法启动，提示"不支持的客户机操作系统"
• VMware设置中"Apple macOS"选项灰色不可选

"If a new VMware version is installed the patches will be lost as the update will overwrite the patched files." —— 项目README说明

补丁状态检测方法

🔧 操作步骤：

# Linux系统执行
cd /data/web/disk1/git_repo/gh_mirrors/unl/unlocker
./check

✅ 预期结果：程序将输出当前VMware版本、已应用补丁状态及兼容性评估，类似以下信息：

VMware Workstation 17.5.0 build-22583795 detected
Patch status: NOT APPLIED
Compatible: YES (Unlocker 4.2.8 supports this version)

解决方案：补丁恢复的标准流程

环境准备工作

⚠️ 注意事项：

• 关闭所有VMware相关进程（包括后台服务）
• 确保拥有管理员/root权限
• 备份重要虚拟机文件（推荐）

跨版本兼容性对照表

VMware版本	最低支持Unlocker版本	主要变化
17.x系列	4.2.0+	新增对ARM架构支持
16.x系列	4.0.0+	优化ESXi兼容性
15.x系列	3.0.0+	支持macOS Big Sur
14.x及以下	2.1.1+	基础功能支持

数据来源：项目CHANGELOG文件

补丁恢复的核心步骤

1. 解除现有补丁

🔧 操作命令：

# Linux系统执行
./relock

relock命令：用于恢复原始系统文件的工具，会移除所有已应用的VMware补丁并重启相关服务。

✅ 预期结果：终端显示"Patches removed successfully"，Windows系统会自动重启VMware服务。

2. 应用最新补丁

🔧 操作命令：

# Linux系统执行
./unlock

unlock命令：核心补丁工具，会自动检测VMware安装路径并执行以下操作：

• 修补vmware-vmx及衍生文件
• 复制macOS所需的ISO文件至VMware目录
• 更新虚拟机配置模板

✅ 预期结果：终端显示"Unlock completed successfully"，并列出已应用的补丁数量。

3. 验证补丁状态

🔧 操作命令：

# 再次运行检查工具
./check

✅ 预期结果：输出"Patch status: APPLIED"及所有已应用补丁的详细列表。

进阶技巧：自动化与多系统适配

自动化脚本实现方案

为避免每次VMware升级后重复手动操作，可创建以下自动化脚本：

#!/bin/bash
# unlocker_update.sh - 自动更新VMware Unlocker补丁

# 定义工作目录
UNLOCKER_DIR="/data/web/disk1/git_repo/gh_mirrors/unl/unlocker"

# 检查是否以root权限运行
if [ "$(id -u)" -ne 0 ]; then
  echo "请使用sudo或root权限运行" >&2
  exit 1
fi

# 停止VMware服务
systemctl stop vmware

# 执行解锁流程
cd $UNLOCKER_DIR || exit
./relock > /var/log/unlocker_relock.log
./unlock > /var/log/unlocker_apply.log

# 启动VMware服务
systemctl start vmware

# 验证结果
./check

🔧 使用方法：

chmod +x unlocker_update.sh
sudo ./unlocker_update.sh

多系统适配指南

Windows系统

• 直接双击运行relock.exe和unlock.exe
• 操作完成后会自动重启VMware相关服务
• 位于commands/winres/目录下的可执行文件需以管理员身份运行

Linux系统

• 除常规解锁流程外，对于Arch Linux用户可使用AUR包：

  yay -S vmware-unlocker-bin
  

  该包包含Pacman钩子，可在VMware更新时自动重新应用补丁

macOS系统

• 需要禁用系统完整性保护(SIP)
• 使用./unlock命令时需添加--macos参数
• 位于cpuid/macos/目录下的辅助工具需设置执行权限

常见问题解决方案

1. 补丁应用失败

   • 检查VMware进程是否完全关闭
   • 尝试删除/tmp/unlocker缓存目录后重试
   • 确认使用与VMware版本匹配的Unlocker版本

2. 虚拟机启动黑屏

   • 验证ISO文件是否已正确复制（位于VMware安装目录的iso/子目录）
   • 检查虚拟机配置中的"客户机操作系统"是否设为"Apple macOS"

3. 权限错误

   • Linux系统确保以root权限运行
   • Windows系统需右键选择"以管理员身份运行"
   • 检查VMware安装目录的写入权限

总结与扩展资源

通过本文介绍的问题排查→解决方案→进阶技巧流程，您已掌握VMware升级后恢复Unlocker补丁的完整方法。核心步骤包括：检测补丁状态→解除旧补丁→应用新补丁→验证结果。对于高级用户，可通过自动化脚本来简化这一过程，或利用AUR包等工具实现自动更新。

项目中更多技术文档可参考：

• 补丁原理：wiki/Patches.md
• 构建指南：wiki/Building-from-source.md
• 故障排除：wiki/Debugging-macOS-Guests.md

定期访问项目仓库获取最新版本，以确保对最新VMware版本的持续支持。