文檔教程【免費(fèi)下載鏈接】OpenCore-Install-GuideRepo for the OpenCore Install Guide項(xiàng)目地址https://gitcode.com/gh_mirrors/op/OpenCore-Install-Guide點(diǎn)擊查看免費(fèi)下載macOS 11 Big Sur 是蘋果自 macOS 10.15 Catalina 之后的一次重大版本換代它引入了簽名系統(tǒng)卷Signed System VolumeSSV、APFS 系統(tǒng)卷快照機(jī)制以及新的 SIP 標(biāo)志位同時淘汰了一批老舊 SMBIOS 與硬件驅(qū)動。本文基于 OpenCore Install Guide 倉庫的 extras/big-sur/README.md 整理出完整的 Big Sur 黑蘋果Hackintosh部署指南覆蓋安裝前的 SMBIOS 與硬件兼容性檢查、kext 與 OpenCore 版本要求、已知問題清單以及從啟動卡死到內(nèi)核崩潰Kernel Panic的系統(tǒng)性故障排查方案。閱讀完成后你將能夠判斷自己的平臺是否滿足 Big Sur 安裝前提并能夠針對Forcing CS_RUNTIME for entitlement、max_cpus_from_firmware not yet initialized、X99/X299 RTC 問題、ramrod卡死等典型故障給出可落地的修復(fù)配置。安裝前必備條件Prerequisites在動手安裝 Big Sur 之前需要依次確認(rèn)三個前提你的 SMBIOS 是否仍被系統(tǒng)支持、硬件驅(qū)動是否被裁剪、以及 OpenCore、kext 與 config.plist 是否足夠新。受支持的 SMBIOS哪些機(jī)型被 Big Sur 淘汰Big Sur 從 macOS 中移除了若干基于 Ivy Bridge 與 Haswell 的 SMBIOS。如果你的機(jī)器在 Catalina 下正常工作且不屬于下列被移除的名單那么可以放心繼續(xù)被 Big Sur 移除的 SMBIOS說明iMac14,3 及更早注意 iMac14,4 仍然受支持MacPro5,1 及更早Macmini6,x 及更早MacBook7,1 及更早MacBookAir5,x 及更早MacBookPro10,x 及更早仍受 macOS Big Sur 支持的 SMBIOS 列表如下仍受支持的 SMBIOSiMac14,4 及更新MacPro6,1 及更新iMacPro1,1 及更新Macmini7,1 及更新MacBook8,1 及更新MacBookAir6,x 及更新MacBookPro11,x 及更新完整的 SMBIOS 支持矩陣含各機(jī)型的 CPU 家族、GPU、board-id 與初始/最終支持版本可查閱 extras/smbios-support.md。需要說明的是SMBIOS 的選擇不只是 CPU 配對那么簡單它同時決定 CPU 電源管理XCPM 支持、GPU 電源管理AGPM、USB 映射與 DRM 行為因此被淘汰的老機(jī)型不能簡單沿用舊 SMBIOS。對于手中機(jī)型需要“翻譯”到新 SMBIOS 的用戶官方給出如下遷移建議iMac13,1 → 遷移到 iMac14,4iMac13,2 → 遷移到 iMac15,1iMac14,2 與 iMac14,3 → 遷移到 iMac15,1注意使用 NVIDIA GPU 的 AMD CPU 用戶可能更適合 MacPro7,1iMac14,1 → 遷移到 iMac14,4受支持的硬件哪些驅(qū)動與網(wǎng)卡被移除Big Sur 雖然裁掉了不少 SMBIOS但真正被移除的硬件并不算多主要集中在這幾類消費(fèi)級 Ivy Bridge CPUU / H / S 后綴這些 CPU 依然可以無大礙地引導(dǎo)系統(tǒng)但 Big Sur 中沒有任何官方 Mac 使用消費(fèi)級 Ivy Bridge。Ivy Bridge-E 處理器由于被 MacPro6,1 采用而仍然受支持。Ivy Bridge 核顯HD 4000 與 HD 2500蘋果計(jì)劃移除這兩款核顯驅(qū)動不過在 macOS 11.0.1 中這些驅(qū)動依然存在。BCM4331 與 BCM43224 無線網(wǎng)卡這兩款網(wǎng)卡被移除支持。潛在的變通方案是注入打過補(bǔ)丁的 IO80211Family即社區(qū)流傳的 IO80211 Patches 方案。部分 SATA 控制器蘋果直接從AppleAHCIPort.kext中刪除了AppleIntelPchSeriesAHCI類。由于類是整段移除試圖通過修改 ID 來欺騙系統(tǒng)即 SATA-unsupported.kext 的常見做法在很多情況下會失敗對其他用戶還會引發(fā)不穩(wěn)定。針對 SATA 問題的部分修復(fù)方案是注入 Catalina 版本的修補(bǔ)后AppleAHCIPort.kext倉庫中提供了現(xiàn)成的樣例 extra-files/CtlnaAHCIPort.kext.zip。官方建議為該 kext 設(shè)置MinKernel為20.0.0以規(guī)避潛在沖突。這樣它既能在 Catalina 下工作也能在 Big Sur 下工作如果愿意甚至可以移除 SATA-unsupported.kext。其他值得注意的變化MSI Navi 顯卡用戶不再需要ATY,rom或-wegnoegpu補(bǔ)丁即可引導(dǎo)安裝程序。第二階段安裝要求 NVRAM 正常工作。Asus 9 系列主板以及 NVRAM 有問題的 X99 / X299 用戶需要先在另一臺機(jī)器上完成安裝再把 SSD 移回原機(jī)。保持 OpenCore、kext 與 config.plist 處于最新版本確保你使用的是最新版的 OpenCore、各 kext 與 config.plist避免出現(xiàn)莫名其妙的兼容性問題。不確定自己正在使用哪個 OpenCore 版本時可以在終端執(zhí)行以下命令nvram 4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102:opencore-version注意上述命令要求Misc - Security - ExposeSensitiveData中包含位0x2。推薦值為0x6它同時包含位0x2與位0x4。AMD 用戶特別提醒AMD 用戶務(wù)必更新 AMD OS X 提供的內(nèi)核補(bǔ)丁kernel patches否則將無法引導(dǎo) Big Sur。倉庫中對應(yīng)的 AMD 平臺配置指南可參考 AMD/zen.md覆蓋 Ryzen/Threadripper 17h 與 19h其中詳細(xì)說明了Kernel - Patch中algrey - Force cpuid_cores_per_package等補(bǔ)丁的Replace值需要按 CPU 物理核心數(shù)改寫例如 8 核 5800X 的 Replace 值為B8 08 0000 0000/BA 08 0000 0000/BA 08 0000 0090。若你的平臺還在使用舊的 FX 系列可參考 AMD/fx.md。Intel HEDT 用戶特別提醒X79 / X99 / X299Big Sur 為 ACPI 增加了新要求X79、X99 與 X299 用戶需要補(bǔ)充新的 SSDTX79SSDT-UNCX99SSDT-UNCSSDT-RTC0-RANGEX299SSDT-RTC0-RANGE這些 SSDT 的用途與配置方式在 config-HEDT/skylake-x.md 中有對應(yīng)說明SSDT-RTC0-RANGE用于啟用 macOS 中的 legacy RTC 時鐘是所有 Big Sur 用戶都需要確認(rèn) RTC 設(shè)備兼容性的關(guān)鍵表SSDT-UNC則用于關(guān)閉未被使用的 uncore PCI Bridge避免 IOPCIFamily 內(nèi)核崩潰。倉庫的 ACPI 編譯產(chǎn)物參考可查看 Misc-files/SSDT-GPIO.aml 與 Misc-files/SSDT-XOSI.aml命名與加載方式一致.aml放入EFI/OC/ACPI并在ACPI - Add中登記。需要預(yù)編譯文件時可以參考 Getting Started with ACPI 中的預(yù)編譯 SSDT 章節(jié)本倉庫的 extra-files 目錄也提供了一批可直接引用的補(bǔ)丁樣例例如SSDT-EC-USBX-AMD.aml、SSDT-PMC.aml、SSDT-XOSI.aml等。已知問題清單Known IssuesBig Sur 上線后損壞了不少功能主要集中在以下幾個方面Lilu用戶態(tài)user-space補(bǔ)丁嚴(yán)重?fù)p壞導(dǎo)致部分功能失效包括DiskArbitrationFixupMacProMemoryNotificationDisablerSidecarEnablerSystemProfilerMemoryFixupNoTouchIDWhateverGreen 的 DRM 與-cdfon補(bǔ)丁AirportBrcmFixup強(qiáng)制加載特定驅(qū)動可能有效例如 BCM94352Z 用戶可能需要在 boot-args 中添加brcmfx-driver2其他芯片組需要不同取值。也可以嘗試將AirPortBrcm4360_Injector.kext的MaxKernel設(shè)置為19.9.9。SATA 支持損壞原因即上文提到的蘋果移除AppleIntelPchSeriesAHCI類解決方案是加入 Catalina 修補(bǔ)版AppleAHCIPort.kextextra-files/CtlnaAHCIPort.kext.zip并將MinKernel設(shè)為20.0.0。XhciPortLimit 在 macOS 11.3 Beta 2 及更新版本中損壞自 macOS 11.3 起XhciPortLimit會導(dǎo)致開機(jī)循環(huán)。建議要么安裝更老的系統(tǒng)如 macOS 10.15 Catalina要么尋找 11.2.3 或更早的 Big Sur 安裝包。如果你已經(jīng)完成 USB 端口映射并禁用XhciPortLimit則可以無礙引導(dǎo) macOS 11.3。另外雖然不是故障但 SIP 新增了一個標(biāo)志位要在 Big Sur 上徹底禁用 SIP需要將csr-active-config設(shè)置為FF0F0000。關(guān)于各版本 SIP 標(biāo)志位的完整說明與逐位解讀可參考 troubleshooting/extended/post-issues.md 中的 “Disabling SIP” 一節(jié)——該節(jié)給出了從00000000完全啟用到03000000禁用 kext 簽名與文件系統(tǒng)保護(hù)、FF030000High Sierra 全禁用、FF070000Mojave/Catalina 全禁用、FF0F0000Big Sur 全禁用新增 authenticated root 標(biāo)志的完整取值鏈。同時需要注意Big Sur 的軟件更新可能因禁用 SIP 而失效特別是CSR_ALLOW_UNAUTHENTICATED_ROOT與CSR_ALLOW_APPLE_INTERNAL這兩個標(biāo)志建議只按需關(guān)閉具體位而不是整體禁用。在 OpenCore 中修改csr-active-config后若此前已經(jīng)設(shè)置過該變量還必須同步在NVRAM - Delete中登記覆蓋否則變量不會被改寫。安裝流程官方指南已針對 Big Sur 更新請根據(jù)你的操作系統(tǒng)環(huán)境選擇對應(yīng)的安裝教程macOS 用戶installer-guide/mac-install.mdWindows 用戶installer-guide/windows-install.mdLinux 用戶installer-guide/linux-install.md以 macOS 平臺為例安裝介質(zhì)制作的核心鏈路是通過 App Store、softwareupdate --fetch-full-installer或 Munki 腳本獲取安裝器 → 使用磁盤工具將 U 盤格式化為 GUID 分區(qū)圖的 HFS → 執(zhí)行createinstallmedia寫入安裝器 → 掛載 EFI 分區(qū)并放入 OpenCore 引導(dǎo)環(huán)境詳見 installer-guide/mac-install.md 的 “Setting up the installer” 與 “Setting up OpenCores EFI environment” 小節(jié)。若你希望在 VMware Fusion 虛擬機(jī)中安裝 Big Sur例如用于測試倉庫在 extras/big-sur/fusion.md 中提供了完整流程使用 extra-files/raw2vmdk.jar 將.img磁盤鏡像轉(zhuǎn)換為鏈接式 VMDK再通過原始磁盤直通raw disk passthrough或 USB 直通兩種方式掛載目標(biāo)盤最后編輯 vmx 文件把sata0:1設(shè)備類型改為rawDisk并引導(dǎo)安裝。注意虛擬機(jī)內(nèi)的 macOS 無法使用 AppleHV 框架AMD 平臺常見限制相關(guān)內(nèi)容可參考 troubleshooting/extended/post-issues.md。故障排查TroubleshootingBig Sur 的安裝與使用伴隨著一批具有代表性的故障現(xiàn)象下面按癥狀逐項(xiàng)給出根因與修復(fù)方案?？ㄔ贔orcing CS_RUNTIME for entitlement這個階段實(shí)際上是 macOS 正在對系統(tǒng)卷進(jìn)行密封seal操作表面上看起來像是系統(tǒng)卡死了。千萬不要以為卡住就重啟密封過程需要相當(dāng)長的時間一旦中途重啟會破壞整個安裝。Intel X99 / X299 主板卡在PCI Configuration Begins如前文所述Intel HEDT 主板的 RTC 設(shè)備在 ACPI 中可能存在區(qū)域缺失問題。解決方法是用SSDT-RTC0-RANGE檢查你的 RTC 設(shè)備并補(bǔ)齊缺失的區(qū)域OpenCorePkg 的 AcpiSamples 中提供該表源碼。X299 平臺的完整 ACPI 配置可對照 config-HEDT/skylake-x.md 的 ACPI 小節(jié)?？ㄔ趓amrod^^^^^^^^^^^^^處如果在ramrod段卡住——具體表現(xiàn)為能啟動、命中該錯誤、然后自動重啟回到該錯誤形成循環(huán)——說明你的 SMC 模擬器SMC emulator已損壞。修復(fù)方式有兩種確保使用最新構(gòu)建的 VirtualSMC 與 Lilu并添加vsmcgen1boot-arg切換到 FakeSMC并可用上文提到的MinKernel/MaxKernel技巧將 FakeSMC 限制在 Big Sur 及更新系統(tǒng)上加載。切換 kext 時務(wù)必確認(rèn) config.plist 中沒有同時啟用 FakeSMC 與 VirtualSMC否則會引發(fā)沖突。X79 / X99 在 IOPCIFamily 上內(nèi)核崩潰根因是 ACPI 中啟用了未使用的 uncore PCI BridgeIOPCIFamily 在探測未知設(shè)備時觸發(fā)內(nèi)核崩潰。解決方法是在系統(tǒng)中加入SSDT-UNC。DeviceProperties 注入失效Big Sur 對設(shè)備是否存在于 ACPI 中變得非常挑剔尤其是為 WhateverGreen 或 AppleALC 注入關(guān)鍵屬性時可能發(fā)現(xiàn)注入不再生效。請使用 IORegistryExplorer 檢查硬件上是否有acpi-path屬性驗(yàn)證 ACPI 是否定義了你的硬件。如果找不到該屬性就需要創(chuàng)建一個提供完整路徑的 SSDTOpenCorePkg 的 AcpiSamples 中提供了SSDT-BRG0示例因?yàn)槟愕?ACPI 表中很可能存在一個未被登記的 PCI Bridge。注意這個問題在更早的 macOS 版本上也可能出現(xiàn)但 Big Sur 上最常遇到。鍵盤與鼠標(biāo)失靈legacy 系統(tǒng)某些較老平臺的 USB 端口正常工作但基于 HID 的鍵鼠設(shè)備失靈。解決方法是在config.plist - Kernel - Patch中加入如下補(bǔ)丁KeyTypeValueBaseString_isSingleUserCountInteger1EnabledBooleanTrueFindData空IdentifierStringcom.apple.iokit.IOHIDFamilyLimitInteger0MaskData空MaxKernelString空MinKernelString20.0.0ReplaceDataB801000000C3ReplaceMaskData空SkipInteger0早期內(nèi)核崩潰max_cpus_from_firmware not yet initializedBig Sur 內(nèi)核新增了acpi_count_enabled_logical_processors方法部分硬件會在此處觸發(fā)早期內(nèi)核崩潰。解決方法確保 OpenCore 版本為 0.6.0 或更新并啟用AvoidRuntimeDefragQuirk該 Quirk 位于Booter - Quirks其作用是修復(fù) UEFI 運(yùn)行時服務(wù)如時間、NVRAM 與電源控制等。注意由于崩潰發(fā)生在極早期你只能通過串口日志或重啟進(jìn)入一個已知正常的 macOS 安裝并查看記錄在 NVRAM 中的 panic 日志來捕獲它。大多數(shù)用戶看到的僅僅是[EB|#LOG:EXITBS:START]。以下為典型的崩潰日志形態(tài)屏顯與串口/NVRAM 記錄傳統(tǒng)平臺邊緣情況如 HP DC7900在部分硬件主要是 HP DC7900上內(nèi)核仍無法確定你的 CPU 支持多少線程導(dǎo)致同樣的內(nèi)核崩潰此時需要硬編碼 CPU 核心數(shù)。在config.plist - Kernel - Patch中添加如下補(bǔ)丁將B8 04 00 00 00 C3中的04替換為你硬件支持的 CPU 線程數(shù)KeyTypeValueBaseString_acpi_count_enabled_logical_processorsCountInteger1EnabledBooleanTrueFindData空IdentifierStringKernelLimitInteger0MaskData空MaxKernelString空MinKernelString20.0.0ReplaceDataB804000000C3ReplaceMaskData空SkipInteger0無法更新到更新的 Big Sur 版本一般有兩大原因損壞的更新工具Broken Update Utility——運(yùn)行測試版系統(tǒng)時最常見的錯誤優(yōu)先嘗試此方案損壞的密封Broken Seal。損壞的更新工具這是每個測試版周期都會出現(xiàn)的問題通常重新取消注冊再注冊即可# 從 beta 目錄取消注冊 sudo /System/Library/PrivateFrameworks/Seeding.framework/Resources/seedutil unenroll # 重新注冊 sudo /System/Library/PrivateFrameworks/Seeding.framework/Resources/seedutil enroll DeveloperSeed然后回到系統(tǒng)設(shè)置檢查更新應(yīng)該就會出現(xiàn)。如果仍未出現(xiàn)執(zhí)行以下命令# 通過終端列出軟件更新 softwareupdate -l這通常能讓更新工具重新正常工作。如果依舊有問題請檢查下一節(jié)的 “損壞的密封”。損壞的密封Broken Seal蘋果為系統(tǒng)盤引入快照機(jī)制后OS 更新能否正確應(yīng)用高度依賴快照。因此當(dāng)驅(qū)動器密封損壞時macOS 會拒絕更新?？梢杂胐iskutil apfs list自行驗(yàn)證系統(tǒng)卷的Snapshot Sealed是否返回YES# 列出所有 APFS 卷 diskutil apfs list # 找到你的系統(tǒng)卷 Volume disk1s8 A604D636-3C54-4CAA-9A31-5E1A460DC5C0 --------------------------------------------------- APFS Volume Disk (Role): disk1s8 (System) Name: Big Sur HD (Case-insensitive) Mount Point: Not Mounted Capacity Consumed: 15113809920 B (15.1 GB) Sealed: Broken FileVault: No | Snapshot: 4202EBE5-288B-4701-BA1E-B6EC8AD6397D Snapshot Disk: disk1s8s1 Snapshot Mount Point: / Snapshot Sealed: Yes如果Snapshot Sealed返回Broken按以下步驟處理將 OpenCore 更新到 0.6.4 或更新版本要求包含修復(fù)提交ba10b5d或更新回滾到更舊的快照——主要針對那些動過系統(tǒng)卷的用戶回滾方法參見 troubleshooting/extended/post-issues.md 的 “Rolling back APFS Snapshots” 一節(jié)進(jìn)入恢復(fù)分區(qū)選擇 “Restore From Time Machine Backup” 即可回滾。內(nèi)核崩潰Rooting from the live fs完整錯誤信息為Rooting from the live fs of a sealed volume is not allowed on a RELEASE build這是 Beta 10 中啟用 Secure Boot 引導(dǎo)時與舊版 OpenCore 之間的兼容問題。將 OpenCore 更新到 0.6.4 即可解決同樣要求包含ba10b5d提交或更新。關(guān)于 Apple Secure Boot 在 config.plist 中的配置Misc - Security - SecureBootModelBig Sur 到 Sonoma 推薦值為Default可參考 config.plist/security.md。Asus Z97 與 HEDTX99 / X299第二階段安裝失敗Big Sur 對原生 NVRAM 的依賴更強(qiáng)否則安裝程序會陷入重啟循環(huán)。解決方式二選一在另一臺機(jī)器上完成 Big Sur 安裝然后轉(zhuǎn)移整個驅(qū)動器修復(fù)主板 NVRAM——主要適用于 Asus Z97 系列。筆記本在內(nèi)核cannot perform kext scan上崩潰這是因?yàn)閮?nèi)核緩存中存在同一 kext 的多份拷貝具體來說是存在多份 VoodooInput。請檢查Kernel - Add確保只啟用 1 份 VoodooInput。注意VoodooI2C 與 VoodooPS2 都內(nèi)置捆綁了一份 VoodooInput禁用哪一份視個人偏好而定。macOS 11.3 重啟在AppleUSBHostPort::createDevice: failed to create device根因是XhciPortLimit在 macOS 11.3 及更新版本中損壞。解決辦法是必須禁用Kernel - Quirks下的XhciPortLimit但前提是你已經(jīng)正確完成了 USB 端口映射否則可能丟失設(shè)備識別。USB 映射與 USBX 電源屬性的完整做法可參考倉庫中的 AMD/AMD-USB-map.md 示例流程。結(jié)語與后續(xù)指引macOS 11 Big Sur 的引入使黑蘋果生態(tài)發(fā)生了顯著變化簽名系統(tǒng)卷與快照機(jī)制抬高了安裝與更新的門檻csr-active-config需要新的FF0F0000值XhciPortLimit 在 11.3 失效SMBIOS 支持范圍整體前移。本文覆蓋了從前提檢查到典型故障的完整鏈路對于配置細(xì)節(jié)建議結(jié)合倉庫中的平臺專項(xiàng)文檔如 config-HEDT/skylake-x.md、AMD/zen.md與通用故障手冊如 troubleshooting/extended/post-issues.md、troubleshooting/extended/kernel-issues.md交叉閱讀。若你計(jì)劃在虛擬化環(huán)境VMware Fusion中先行驗(yàn)證extras/big-sur/fusion.md 提供了逐步操作指南后續(xù)若要升級到 macOS 12 Monterey可參考 extras/monterey.md 中的新注意事項(xiàng)如藍(lán)牙棧重寫、藍(lán)延 kext 調(diào)整與 T2 SMBIOS 的 OTA 更新約束。贊分享文檔教程【免費(fèi)下載鏈接】OpenCore-Install-GuideRepo for the OpenCore Install Guide項(xiàng)目地址https://gitcode.com/gh_mirrors/op/OpenCore-Install-Guide點(diǎn)擊查看免費(fèi)下載相關(guān)推薦徹底解決macOS 11兼容性難題360Controller驅(qū)動的Big Sur適配全攻略徹底解決macOS 11兼容性難題360Controller驅(qū)動的Big Sur適配全攻略 macOS Big Sur11.0的系統(tǒng)架構(gòu)升級給硬件驅(qū)動驅(qū)動開發(fā)360Controller驅(qū)動終極解決方案macOS Big Sur兼容性完整指南360Controller驅(qū)動終極解決方案macOS Big Sur兼容性完整指南 360Controller是macOS平臺上最受歡迎的Xbox手柄驅(qū)動程序驅(qū)動開發(fā)為 react-admin 構(gòu)建可測試的組件與 Hooks基于 ra-core 的單元測試完整指南為 react admin 構(gòu)建可測試的組件與 Hooks基于 ra core 的單元測試完整指南 react admin簡稱 ra的核心包 ra cor文檔教程上一篇CANN ops-math 算子解析aclnnRoundDecimals / aclnnInplaceRoundDecimals 四舍五入到指定位數(shù)的 NPU 加速實(shí)現(xiàn)下一篇pwndbg contextsearch 命令詳解在 Context 歷史中快速搜索與回溯調(diào)試現(xiàn)場創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考