簡介unlocker208 是面向需要在 VMware 環(huán)境中運行 macOS 的用戶整理的補丁工具包重點解決虛擬機創(chuàng)建時無法識別 Apple 系統(tǒng)、macOS 無法正常引導等兼容性問題適用于 Workstation、Player、Fusion 及 ESXi 等多類產品的實測場景。壓縮包共 18 個文件約 9.61MB包含 8 個 sh 腳本、3 個 exe 可執(zhí)行文件、3 個 cmd 批處理、3 個 py 腳本和 1 個 txt 說明文檔分別覆蓋不同平臺的補丁安裝、卸載與 VMware Tools 更新等用途。已有 2474 人學習或下載。包內提供分平臺腳本與 Python 補丁代碼并附 readme 說明和常見報錯提示便于讀者了解補丁的作用機制、核對版本兼容性并在遇到虛擬機啟動異常時按提示排查對希望減少反復試錯、系統(tǒng)掌握 VMware 運行 macOS 配置思路的讀者具有較強參考價值。1. 一臺 Windows 工作站要跑 macOS 10.12.6缺的往往不是硬件手上只有一臺 Windows 工作站卻要復現(xiàn)一個只在 macOS 10.12.6 上才出現(xiàn)的老問題——最省事的辦法是用 VMware 起一臺 Sierra。裝完 Workstation 你會發(fā)現(xiàn)新建向導里根本沒有 Apple 這一欄就算手工把 guestOS 改成 darwin16按下開機電源虛擬機窗口一閃就關日志里只留一句「Mac OS X 不受支持」。unlocker208 就是拆這兩道閘門的補丁給 VMware 的客戶機列表塞進 darwin 條目再把 vmx 執(zhí)行體里那段「非 Apple 硬件不許上電」的校驗抹掉。它適合手里是 Workstation 12 / Player 12 這一代、客戶機鎖定 10.12.6 的人想裝更高版本的系統(tǒng)這個包夠不著別硬套。2. 補丁落在哪幾個文件上unlocker208 的三道閘門與 darwin16 的天花板很多人把 unlocker208 當成一個「一鍵安裝包」雙擊跑完發(fā)現(xiàn)沒效果就開始懷疑人生。實際上它做的事情很窄定位 VMware 安裝目錄下兩三個可執(zhí)行文件按字節(jié)特征找到特定位置把校驗邏輯改掉。正因為是二進制級改寫而不是改配置版本對不對得上直接決定這次操作是成功、無效、還是把 VMware 打壞。真正的困難在于多數(shù)人不知道補丁應該改哪幾個文件。先把補丁的作用范圍看清楚后面所有「裝完沒反應」「開機就關機」的現(xiàn)象都能自己定位到具體環(huán)節(jié)。2.1 三道閘門向導條目、開機校驗、SMC 設備第一道閘門是「你根本選不到」。VMware 的新建虛擬機向導里那份客戶機操作系統(tǒng)下拉列表來自安裝目錄中的一個二進制模塊在 Windows 下這個模塊是vmwarebase.dll。列表里沒有 darwin 這一項你就沒有 Apple Mac OS X 可選只能選「其他」。unlocker208 對它的處理是把 darwin 相關的客戶機條目和相關字符串寫回去讓向導把 Apple 一欄渲染出來。這一步只影響「能不能建」和能不能開機沒有關系。第二道閘門是「能建但開不了機」。真正執(zhí)行開機的是vmware-vmx.exe。它在給客戶機加電之前會判斷 guestOS 是不是 darwin如果是就進一步檢查宿主是不是 Apple 硬件。不是就直接拒絕并拋出一句Mac OS X is not supported然后進程退出。這就是很多人看到的「電源一閃窗口消失」。補丁處理的正是這段判斷邏輯。第三道閘門不在補丁范圍內必須自己補macOS 內核啟動早期會去讀 SMCSystem Management Controller的鍵值用來確定機型、電源策略等。VMware 只有在 vmx 里寫了smc.present TRUE才會虛擬出這個設備缺了它內核走到那一步要么無限轉圈要么直接五國內核崩潰。補丁只負責讓你「建得出、點得開」第三道在配置里第 4 章會給出完整寫法。提示這三道閘門是依次放行的。只解決第二道、不管第三道表現(xiàn)就是「能開機、卡蘋果」很多人誤判成補丁沒打上其實是配置缺行。還有一點需要提前說明這類二進制改寫依賴字節(jié)特征定位沒有官方符號表可查。VMware 只要換了編譯版本甚至只是小版本號往前跳一點特征串就可能移位此時補丁要么找不到位置直接跳過要么改到錯誤偏移把文件寫成半殘。所以「版本對位」不是講究而是前提。2.2 版本對位darwin16 就是 2.0.8 的天花板客戶機標識里那個數(shù)字不是隨手編的它是 Darwin 內核的大版本號Darwin 14 對應 10.10Darwin 15 對應 10.11Darwin 16 對應 10.12Darwin 17 對應 10.13。所以要裝 10.12.6vmx 里的 guestOS 必須寫darwin16。下表是按常見資料整理的對應關系各家整理略有出入最終以解壓包里 readme 的說明為準客戶機標識對應系統(tǒng)版本unlocker208 是否覆蓋說明darwin14macOS 10.10是老系統(tǒng)Tools 用 darwinPre15.isodarwin15macOS 10.11是分界點建議確認 Tools 版本darwin16macOS 10.12是2.0.8 正好做到這一代darwin17macOS 10.13否需要更新的補丁版本把 guestOS 寫成 darwin15 能不能開機能但 VMware 會按 10.11 的硬件清單去配置設備顯卡、USB 控制器、網卡的默認行為都和 10.12 有差異后面裝 Tools 很容易對不上號。這就是典型的「少寫一個數(shù)字多花一整天」。VMware 這一側同樣要匹配。Workstation 12 這一代的硬件版本是virtualHW.version 12。如果你從別處拿了一份virtualHW.version 14的 vmx 模板直接套上去虛擬機會在開機前就報「不支持的硬件版本」連補丁都幫不了你。提示解壓后第一個該打開的文件不是win-install.cmd是 readme。包里通常同時帶 Windows 和 Linux 兩套腳本跑錯平臺等于白忙一場。2.3 裝前自檢五件事不做后面全是玄學補丁本身只有幾十秒出問題基本都出在準備階段。我一般按下面五條過一遍缺哪條補哪條能省掉后面大部分反復完全退出 VMware。主界面點關閉不算數(shù)托盤圖標、后臺的vmware-vmx、授權服務進程都要停。文件被占用時補丁進程往往不會報錯只是靜默跳過。確認安裝目錄。默認在C:\Program Files (x86)\VMware\VMware Workstation裝在別的盤、或者同時裝了 Player路徑就不一樣。打錯目錄是最常見的「裝完沒反應」。做一份冷備份。整個安裝目錄復制一份到別處退一步至少把vmwarebase.dll和vmware-vmx*.exe單獨存起來。這是唯一的后悔藥第 3 章還會講為什么腳本自帶的回滾有時恢復不回去。確認宿主虛擬化開著。BIOS/UEFI 里 VT-x 要打開如果宿主本身就是一臺虛擬機還得在外層開嵌套虛擬化否則客戶機會卡在啟動早期。盤和內存留夠?？蛻魴C磁盤 40G 起步裝完系統(tǒng)加上常用工具就吃掉大半宿主 8G 內存給客戶機 4G 是比較舒服的分配。第 3 條值得多說一句。很多人打補丁失敗后第一反應是「再跑一遍 win-uninstall 就干凈了」但如果補丁已經把文件改壞回滾腳本讀的備份也可能已經是被覆蓋過的版本。這種時候能不能退回可用狀態(tài)取決于你有沒有自己留一份原始文件。3. 在 Windows 上跑通 unlocker208從關進程到向導里出現(xiàn) Apple準備到位之后實際操作只有幾步。真正需要動腦的是這幾步中間如何確認狀態(tài)以及出錯時看哪里。下面按執(zhí)行順序走一遍每一步都給一條可以直接抄的命令或操作。3.1 先看清機器上到底有幾個 VMware不要急著跑腳本先確認進程和路徑。同一臺機器上裝過 Workstation 又裝過 Player或者舊版本卸載不干凈補丁很容易打進錯誤的目錄# 列出所有 VMware 相關進程重點看 Path 列是不是你要打補丁的那個目錄 Get-Process | Where-Object { $_.Name -like vmware* } | Select-Object Id, Name, Path | Format-Table -AutoSize這條命令做兩件事確認還有哪些 VMware 進程在跑從Path列反推真實安裝目錄。如果 Path 里出現(xiàn)兩個不同的父目錄說明機器上確實有多個安裝。確認清楚之后再統(tǒng)一結束進程# 主界面、播放器、虛擬機和授權服務都要停否則文件被占用補丁會靜默跳過 Stop-Process -Name vmware, vmplayer, vmware-vmx, vmware-authd -Force -ErrorAction SilentlyContinue-ErrorAction SilentlyContinue的作用是「進程不存在也不報錯」因為這幾個名字不一定全都有。跑完之后再執(zhí)行一次上面的查詢確認列表已空。這一步省下來后面就可能多花兩小時。3.2 win-install.cmd 干了什么日志怎么讀把補丁包解壓到本地目錄不要直接在壓縮包里雙擊運行臨時目錄的路徑經常帶空格和特殊字符然后以管理員身份打開命令提示符:: 切到解壓目錄路徑有空格一定要加引號 cd /d D:\tools\unlocker208 :: 以管理員身份運行安裝腳本腳本內部會去注冊表讀 VMware 的安裝路徑 win-install.cmd腳本的執(zhí)行順序大致是停止 VMware 相關服務 → 從注冊表讀安裝路徑 → 備份將被修改的文件 → 逐個文件打補丁 → 重啟服務。日志的措辭各版本略有差別看關鍵詞就夠了Found VMware Workstation at: C:\Program Files (x86)\VMware\VMware Workstation Backing up: vmwarebase.dll Patching: vmwarebase.dll Patching: vmware-vmx.exe Finished三個關鍵點。第一Found ... at后面的路徑必須和你在 3.1 里確認的一致不一致說明注冊表里讀到的是另一個安裝。第二Backing up出現(xiàn)幾次意味著還原時有幾個文件可用如果這一行沒出現(xiàn)就直接 Patching說明備份環(huán)節(jié)被跳過了趕緊手工補一份。第三如果日志里出現(xiàn)帶not found、skipped字樣的行多半是文件版本和補丁不匹配此時不要繼續(xù)往下走。還有兩類失敗值得單獨說。一是權限沒有管理員權限時腳本可能一路跑完但一個字節(jié)都沒寫進去因為寫入被系統(tǒng)拒絕而腳本沒有檢查返回值。二是安全軟件改寫 exe 這種行為很容易被攔截表現(xiàn)為窗口一閃而過、目錄里文件時間戳沒變。遇到這兩種情況先看文件修改時間再考慮加白名單。3.3 三處驗證向導、文件時間戳、服務狀態(tài)跑完不要急著建虛擬機花一分鐘做三項確認能區(qū)分「真成功」和「假成功」向導條目新建虛擬機 → 客戶機操作系統(tǒng)里出現(xiàn)Apple Mac OS X版本下拉里能看到 10.12 這一項說明vmwarebase改成功了。文件時間戳安裝目錄里vmwarebase.dll和vmware-vmx.exe的修改時間變成剛才那一刻旁邊多出備份文件說明補丁真的寫進去了。服務狀態(tài)VMware Authorization Service處于運行中說明腳本收尾正常。三項里只要有一項不符合就回到 3.2 看日志不要跳過繼續(xù)建虛擬機——那只會把問題推到更難排查的位置。3.4 回滾win-uninstall.cmd 什么時候不靈回滾腳本做的事很簡單把備份文件覆蓋回去再重啟服務。cd /d D:\tools\unlocker208 win-uninstall.cmd它有一個容易被忽略的前提備份只在第一次打補丁時才是「原版」。如果你連續(xù)跑了兩次安裝腳本第二次備份覆蓋了第一次的備份此時備份里的內容已經是打過補丁的版本回滾回去等于沒回滾。這就是為什么有人反復執(zhí)行回滾狀態(tài)卻始終不變。另外VMware 的升級安裝和修復安裝都會把這兩個文件換回官方版本效果等同于自動回滾。所以升級前導出一次虛擬機配置升級后重新對版本打補丁是更省事的路徑。注意升級 VMware 之后不要拿舊版補丁直接往新文件上打。特征串對不上時可能寫到錯誤偏移把文件徹底寫壞那時只能重裝 VMware。4. 讓 10.12.6 真正進系統(tǒng)vmx 里那幾個不能省的參數(shù)向導里出現(xiàn) Apple 條目只代表你有了「建」的資格。真正把 10.12.6 從安裝界面送進桌面靠的是 vmx 文件里那幾行配置以及安裝源的形式。這一章按「先解決安裝源再解決參數(shù)最后解決 Tools」的順序推進。4.1 安裝源dmg 不能直接掛得先變成 ISOVMware 的虛擬光驅只認 ISO 這類原始扇區(qū)鏡像Apple 的 dmg 在 Windows 側既掛不上也引導不了。常見做法是先在 macOS 上把安裝鏡像轉成原始鏡像再交給 VMware# 在 macOS 上執(zhí)行把安裝鏡像轉成原始磁盤映像 hdiutil convert -format UDRW -o ./sierra.img ./InstallESD.dmg # hdiutil 產出的是 .img改名成 .iso 只是讓虛擬光驅按原始扇區(qū)去讀 mv ./sierra.img ./sierra.iso這里的改名并不是真正的格式轉換只是讓 VMware 按原始扇區(qū)解釋這個文件。絕大多數(shù)引導場景夠用如果虛擬機認不出這張盤再用 dmg2img 之類工具先轉成標準 ISO 走一遍。參數(shù)上-format UDRW表示輸出可讀寫的原始映像比默認的壓縮格式兼容性更好。比鏡像格式更容易翻車的是引導順序10.12.6 的安裝器需要二次引導——第一次從 ISO 進安裝界面裝完第一次重啟時要在虛擬機設置里把 CD/DVD 改成「斷開連接」否則又會回到安裝界面看起來像死循環(huán)。這個坑我在第一次操作時踩過當時以為是鏡像壞了。4.2 vmx 參數(shù)表哪些必須有哪些是錦上添花關機狀態(tài)下編輯 vmx在虛擬機的「設置 → 選項 → 高級」旁邊能直接找到文件路徑下面這張表是我會逐條核對的參數(shù)取值作用不寫會怎樣guestOSdarwin16聲明客戶機類型系統(tǒng)按其他類型配置硬件Tools 對不上smc.presentTRUE虛擬出 SMC 設備內核啟動早期崩潰或卡蘋果smc.version0SMC 協(xié)議版本部分版本會報 SMC 相關錯誤firmwareefi使用 EFI 引導傳統(tǒng) BIOS 引導不了 macOSvirtualHW.version12硬件版本與 Workstation 12 不匹配會拒絕開機memsize4096客戶機內存MB低于 2G 裝不動sata0:0.presentTRUE磁盤掛在 SATA 上部分版本找不到系統(tǒng)盤ethernet0.virtualDeve1000e網卡型號vmxnet3 需要 Tools 支持vhv.enableTRUE暴露硬件虛擬化嵌套場景下開不了機參數(shù)本身不復雜復雜的是取值之間的依賴比如網卡選了 vmxnet3系統(tǒng)裝完但 Tools 沒裝就是徹底沒網很多人會誤判成「網絡配置有問題」其實是驅動沒到位。4.3 一份抄過去就能開機的 vmx下面這份是 10.12.6 的最小可用版本注釋里寫了每一項的理由可以直接對照修改.encoding UTF-8 config.version 8 virtualHW.version 12 displayName macOS 10.12.6 guestOS darwin16 # SMC 設備macOS 內核啟動早期要讀它的鍵值缺了直接崩 smc.present TRUE smc.version 0 # macOS 只走 EFI傳統(tǒng) BIOS 引導不起來 firmware efi # 4G 內存 / 2 核是 10.12.6 比較舒服的下限 memsize 4096 numvcpus 2 cpuid.coresPerSocket 1 # 磁盤走 SATA兼容性最好別一上來就用 NVMe sata0.present TRUE sata0:0.present TRUE sata0:0.fileName macOS-10.12.6.vmdk # 網卡先 e1000e等 Tools 裝完再考慮換 vmxnet3 ethernet0.present TRUE ethernet0.virtualDev e1000e ethernet0.connectionType nat # USB 控制器鍵鼠和 U 盤都靠它 usb.present TRUE usb_xhci.present TRUE # 宿主支持 VT-x 且需要嵌套時打開 vhv.enable TRUE # 關掉安全啟動相關檢查10.12.6 不吃這一套 uefi.secureBoot.enabled FALSE修改時的順序建議是先改guestOS和smc.*能開機進安裝界面再調內存和核數(shù)最后動網卡和 USB。一次改太多出問題時不知道是哪一行引起的這是排查中最常見的自找麻煩。sata0:0.fileName要和虛擬目錄里實際的 vmdk 文件名對上改錯了 VMware 會提示找不到磁盤。cpuid.coresPerSocket保持 1 是為了讓客戶機把兩個核識別成兩個獨立核某些多核調度場景下識別錯會導致性能異常。4.4 裝 VMware Toolsdarwin.iso 和 darwinPre15.iso 別拿錯補丁包的 tools 目錄里通常有兩個鏡像darwin.iso和darwinPre15.iso。名字里的 Pre15 指 Darwin 15 之前也就是 10.11 及更早的系統(tǒng)用后者10.12.6 用前者。拿錯的表現(xiàn)是安裝程序能跑完但分辨率、剪貼板、時間同步全都不生效。掛載方式很直接虛擬機關機 → 設置 → CD/DVD → 使用 ISO 鏡像 → 指向darwin.iso→ 開機進系統(tǒng)后雙擊安裝。裝完的效果是分辨率自適應窗口、宿主機和客戶機之間能復制粘貼、時間自動同步另外vmxnet3驅動也在這時裝上之后就可以把網卡型號換掉了。如果包里帶了更新腳本名字類似win-update-tools它的作用是從官方渠道拉最新版 Tools。網絡受限時這一步會失敗但完全不影響使用直接掛包里自帶的鏡像就行不必糾結。提示10.12 之后系統(tǒng)對內核擴展有簽名限制安裝 Tools 時如果提示被阻止去「安全性與隱私」里放行一次然后重啟。裝完沒有任何變化八成就是這一步沒做。5. 避坑裝完沒反應、開機就關機的五條排查記錄下面五條是按發(fā)生頻率排的每條都按「現(xiàn)象 → 原因 → 解決」寫遇到問題時可以按順序對照基本能覆蓋絕大多數(shù)場景。5.1 現(xiàn)象向導里根本沒有 Apple 條目原因vmwarebase.dll沒被改動。細分下來有三種補丁打進了另一個安裝目錄同時裝了 Player 和 Workstation腳本沒有管理員權限寫入被拒絕但沒報錯安全軟件攔截了改寫行為。解決先看安裝目錄里vmwarebase.dll的修改時間如果還是幾個月前說明沒寫進去再看 3.1 里查出的進程路徑確認補丁打的是同一個目錄最后檢查安全軟件日志。三樣都排除后重跑一次安裝腳本并盯住日志里Found ... at那一行的路徑。5.2 現(xiàn)象虛擬機建出來了一按開機窗口就消失原因vmware-vmx.exe的校驗沒被去掉。最常見的是補丁只改了其中一個變體——安裝目錄里往往有vmware-vmx.exe、vmware-vmx-debug.exe、vmware-vmx-stats.exe幾個文件正常開機走的是第一個調試模式走的是第二個。只改了一個就出現(xiàn)「調試能開、正常開不了」的怪現(xiàn)象。另一種可能是 VMware 升級把文件換回了官方版。解決在安裝目錄按修改時間排序確認所有vmware-vmx*.exe都是剛才的時間戳打開虛擬機目錄下的vmware.log搜索darwin和not supported能直接看到是哪一段校驗攔下來的。確認后關機、結束所有 VMware 進程、重跑補丁。5.3 現(xiàn)象卡在蘋果 logo進度條走到一半黑屏或五國原因補丁這一層已經過了卡在 SMC 相關檢查上。vmx 里缺smc.present TRUE或者smc.version沒寫內核讀不到需要的鍵值。解決虛擬機關機直接編輯 vmx 補上這兩行再開機。如果補上后仍然黑屏把firmware改成efi再試一次——有些模板是從別的系統(tǒng)復制過來的這一行還是傳統(tǒng) BIOS。改完記得保存文件再啟動VMware 在運行時會鎖定 vmx改了不生效。5.4 現(xiàn)象安裝器彈窗說「此副本已損壞」原因不是文件真壞了是 10.12 這一代安裝器的簽名證書過期加上客戶機時間沒有同步到正確年份。解決在安裝器界面打開菜單里的終端把系統(tǒng)日期設到 2016 年關掉彈窗繼續(xù)安裝裝完進系統(tǒng)后再把時間同步打開。這個操作只影響客戶機和宿主機無關。5.5 現(xiàn)象VMware 升級之后原來的 macOS 虛擬機打不開原因升級安裝把vmwarebase.dll和vmware-vmx*.exe全部換成了官方版本補丁自然沒了。有些升級還會順帶提高硬件版本導致 vmx 里的virtualHW.version和實際不匹配。解決升級前先導出一份虛擬機配置升級后先確認硬件版本再從對應的補丁版本重新打一遍不要拿舊補丁往新文件上打。如果升級后虛擬機直接報「文件損壞」先別急著刪把 vmx 里的硬件版本改回升級前的數(shù)字多數(shù)情況能救回來。6. 三處校驗確認補丁生效以及我給每個 VMware 版本留的存檔目錄判斷補丁到底有沒有生效不要只看「向導里有沒有 Apple」這一條那只覆蓋了三道閘門里的第一道。我一般做三項交叉驗證向導條目、日志、客戶機內部信息任何一項對不上都說明還有環(huán)節(jié)沒走通。下面的表是這三項的具體查法。校驗點位置正常表現(xiàn)客戶機條目新建虛擬機向導出現(xiàn) Apple Mac OS X版本含 10.12開機校驗虛擬機目錄vmware.log搜索not supported無命中客戶機內部系統(tǒng)內的終端能讀到 CPU 型號與硬件信息客戶機內部這一項最容易被忽略但它能反向證明引導鏈路是通的。進系統(tǒng)后開終端# 讀 CPU 標識確認 VMware 把宿主 CPU 正確透傳進來 sysctl -n machdep.cpu.brand_string # 只看硬件概覽前幾行機型、內存、序列號都在這里 system_profiler SPHardwareDataType | sed -n 1,12p # 檢查 VMware Tools 的內核擴展是否加載有輸出說明 Tools 生效 kextstat | grep -i vmware第一條命令的輸出應該能對上宿主的物理 CPU 型號如果是空的或者明顯錯亂說明 vmx 里的 CPU 相關配置有問題。第二條的重點是內存和機型字段內存應該等于memsize的值。第三條最實用Tools 裝沒裝、裝完有沒有真正加載這條命令一查便知比看分辨率有沒有變化直觀得多。最后一個習慣是我在被坑過幾次之后固定下來的在備份盤上按 VMware 版本號建目錄比如VMware-12.5/下面放這一代的原版vmwarebase.dll和全部vmware-vmx*.exe旁邊再放一份對應版本的補丁包。這樣不管是升級后要重打、還是補丁把文件寫壞了要退回都能在兩分鐘內搞定不用去翻舊安裝包。我還習慣在目錄里放一個文本文件寫清楚這一代跑通過哪個客戶機版本、用的哪份 vmx下次遇到同樣需求直接抄。從那以后我每次動 VMware 之前都會先把整個安裝目錄復制一份并標上版本號再去跑補丁。這個動作只花十幾秒?yún)s能省掉一整個下午的重裝。希望幫到你。本文還有配套的精品資源點擊獲取