ESXi 跑 macOS 虚拟机?Unlocker 解锁指南,5 分钟配好附避坑清单
【免费下载链接】esxi-unlockerVMware ESXi macOS项目地址: https://gitcode.com/gh_mirrors/es/esxi-unlocker
esxi-unlocker 是一款社区开发的 ESXi Unlocker 工具,给 VMware ESXi 6.5 / 6.7 / 7.0 打补丁,解锁官方版本里缺失的 macOS 虚拟机启动支持。适合想在 ESXi 上跑 macOS、又不想折腾二次开发的新手,看完照着做就行。
它到底能干嘛
一句话:它给 ESXi 打补丁,把 macOS 虚拟机的启动开关打开。场景:同一份 macOS 安装镜像,没打补丁时引导到一半黑屏,装好 Unlocker 后正常进桌面。
装之前,先把这几样备齐
动手前花一分钟对一遍这张表,能省掉后面大部分折腾:
| 检查项 | 要求 |
|---|---|
| ESXi 版本 | 6.5 / 6.7 / 7.0(3.0.2 起兼容 7.0 U1) |
| 访问方式 | 已开启 SSH,能用 root 登录主机 |
| 存储空间 | 数据存储空间里有几十 MB 空余,用来放脚本文件 |
| 旧版状态 | 装过旧版 Unlocker 的,必须先卸载再装新版 |
⚠️ 最后一条最容易被忽略:新旧补丁模块叠加,有把主机弄挂的风险,官方 readme 里反复强调要先卸旧版。
实操:从克隆到跑通
先在本地克隆仓库,拿到安装脚本和补丁逻辑,再整体传到 ESXi 上:
git clone https://gitcode.com/gh_mirrors/es/esxi-unlocker scp -r esxi-unlocker root@esxi-ip:/vmfs/volumes/datastore1/这里用 scp 把目录传到数据存储空间(datastore,ESXi 上存放虚拟机的存储卷),卷名换成你实际挂载的。传完后 ESXi 上就齐了安装脚本和补丁文件,剩下的操作全在主机里完成。
接下来 SSH 登录主机,进入刚才上传的目录执行安装脚本:
ssh root@esxi-ip cd /vmfs/volumes/datastore1/esxi-unlocker ./esxi-install.sh🔧 这一步它内部会调用 BootModuleConfig.sh(ESXi 的启动模块配置工具),把 unlocker.tgz 挂进开机流程;真正修改系统文件的动作,由 etc/rc.local.d/unlocker.py 在每次启动时自动完成。看到 Success 提示后执行 reboot 重启主机,这一步不能省——补丁只对重启后的系统生效。
怎么确认装成功了
重启完成后重新登录,运行仓库自带的测试脚本:
./esxi-smctest.sh # 输出应包含 /bin/vmx smcPresent = true custom.vgz false 32486592 B三行输出各管一件事:第一行确认 /bin/vmx(macOS 引导依赖的虚拟机核心)已被处理;smcPresent = true 表示 Apple 的 SMC 检测通过,这是 macOS 能否启动的关键开关;custom.vgz 那行说明补丁模块已加载,具体大小随 ESXi 版本浮动,关键只看 smcPresent 是不是 true。✅ 看到 true,解锁就算成功了,可以开始建 macOS 虚拟机。
进阶玩法
- nounlocker 启动参数:编辑 ESXi 启动选项加上这个词,当次开机就跳过打补丁,适合排查问题或在维护窗口临时恢复原生行为。
- 升级与换版:ESXi 升级后补丁会失效,需要重装;换新版本前先跑 esxi-uninstall.sh 移除旧模块再装新的。版本更新记录可参考 readme.md 底部的 History 一节。
装完踩坑了?对照这张表
| 现象 | 原因 | 处理 |
|---|---|---|
| macOS 还是启动不了 | 补丁未生效或 smcPresent 仍为 false | 重跑安装脚本、再重启一次,用测试脚本复核 |
| 安装脚本执行报错退出 | ESXi 版本与 Unlocker 不匹配 | 核对主机版本是否在 6.5 / 6.7 / 7.0 范围内,换对应 release |
| 覆盖安装后主机异常 | 新旧补丁模块叠加冲突 | 先跑卸载脚本移除旧模块,重启后再装新版 |
| vSphere 控制台连不上 macOS 虚拟机 | libvmkctl 补丁未生效 | 重启后重新验证 smctest 输出 |
| 升级 ESXi 后 macOS 又跑不起来 | 升级重置了已打补丁的系统文件 | 升级后重新执行安装并重启 |
Unlocker 本质上是给 ESXi 加了一套开机自动执行的补丁流程,装一次、重启一次,之后所有 macOS 虚拟机都受益。想看更多版本细节和构建方式,可以去项目仓库翻翻 readme。
【免费下载链接】esxi-unlockerVMware ESXi macOS项目地址: https://gitcode.com/gh_mirrors/es/esxi-unlocker
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考