文档教程【免费下载链接】OpenCore-Install-GuideRepo for the OpenCore Install Guide项目地址https://gitcode.com/gh_mirrors/op/OpenCore-Install-Guide点击查看免费下载本篇以 OpenCore-Install-Guide 仓库的 config.plist/skylake.md 为核心骨架面向 6 代酷睿Skylake2015–2016 年代台式机用户逐步讲解从 Sample.plist 出发构建一套可用 OpenCore 引导配置的完整流程。读完本文你将掌握 ACPI/Booter/DeviceProperties/Kernel/Misc/NVRAM/PlatformInfo/UEFI 各大区的每一项关键设置、Skylake 独有的 iGPU framebuffer 注入与 SMBIOS 选择方法以及 BIOS 层面必须开启与关闭的选项能够独立完成一台 Skylake 台式机的 config.plist 配置与排障。起点理解 OpenCore 配置的三大铁律Skylake 台式机与仓库中其他 Intel 平台如 Kaby Lake、Coffee Lake共享同一套配置方法论。在动手之前请先牢记 OpenCore 配置的三个核心原则所有属性都必须显式定义OpenCore 不会为缺失的属性提供默认回退值因此除非指南明确说明否则不要删除任何分区凡文档未提及的选项一律保持默认。Sample.plist 不能直接使用它只是模板你必须根据自己平台逐项修改config.plist/README.md 详细介绍了从 OpenCorePkg 发布包Docs目录中取出 Sample.plist、复制到 USB 的 EFI 分区EFI/OC/下并重命名为config.plist的流程。不要使用任何图形化 Configurator 工具这类工具往往不尊重 OpenCore 的配置结构甚至会写入 Clover 专有属性、损坏 plist。推荐的编辑工具组合是ProperTree通用 plist 编辑器打开后按Cmd/Ctrl Shift R指向 EFI/OC 目录执行 Clean Snapshot即可按正确顺序自动载入全部 SSDT、Kext 与 .efi 驱动和GenSMBIOS用于生成 SMBIOS 数据。ProperTree 快照时若弹出 Disable the following kexts with Duplicate CFBundleIdentifiers?请选择Yes以避免重复注入例如 VoodooInput 同时存在于 VoodooPS2 与 VoodooI2C 的插件目录中。::: warning 建议在正式搭建前把本文通读一遍以上文中的截图未必总是最新版本请以截图下方的文字说明为准未提及的选项保持默认。 :::ACPI 分区SSDT 是 Skylake 启动的前提Add必须添加的两个 SSDTACPI 分区的Add用于加载系统所需的 SSDT 表它们对能否启动 macOS至关重要也可用于 USB 映射、禁用不支持的 GPU 等。Skylake 台式机需要补回两个由 Clover 时代提供的功能必需 SSDT说明SSDT-PLUG为 Haswell 及更新平台提供原生 CPU 电源管理XCPM支持SSDT-EC-USBX同时修复嵌入式控制器EC与 USB 供电问题注意不要把自制的DSDT.aml加入此处——你的固件里已经包含 DSDT。如果配置中存在该条目请从config.plist的ACPI - Add以及EFI/OC/ACPI中一并移除。编译后的 SSDT 以.amlAssembled扩展名存放在EFI/OC/ACPI目录且必须在ACPI - Add中逐条登记。Delete 与 Patch交给 SSDT 而非补丁Delete用于阻止某些 ACPI 表加载Skylake 平台可以忽略。Patch用于通过 OpenCore 动态修改 ACPIDSDT、SSDT 等。对我们而言补丁工作由 SSDT 承担即可——这种方式更干净且能让 OpenCore 同时引导 Windows 等其他操作系统。Quirks与 ACPI 相关的设置项本平台没有需要调整的全部保持默认。Booter 分区boot.efi 修补相关设置本分区专门配置与boot.efi修补相关的 quirk由OpenRuntime.efiAptioMemoryFix.efi 的替代品驱动。MmioWhitelist用于把通常被忽略的内存空间透传给 macOS与DevirtualiseMmio配合使用Skylake 平台保持默认即可。QuirksQuirk值说明AvoidRuntimeDefragYES修复 UEFI 运行时服务日期、时间、NVRAM、电源控制等EnableSafeModeSlideYES允许在安全模式下使用 slide 变量EnableWriteUnprotectorYES移除 CR0 寄存器的写保护ProvideCustomSlideYES用于 slide 变量计算若调试日志出现OCABC: All slides are usable! You can disable ProvideCustomSlide!可关闭此 quirk若出现OCABC: Only N/256 slide values are usable!则必须保留SetupVirtualMapYES将 SetVirtualAddresses 调用修复为虚拟地址Gigabyte 主板上解决早期内核恐慌必需DeviceProperties 分区Skylake iGPU 帧缓冲注入AddiGPU 关键属性PciRoot(0x0)/Pci(0x2,0x0)这一节依据 WhateverGreen 的 Framebuffer Patching 指南设置用于注入 iGPU 关键属性。Sample.plist 默认没有该节需要手动创建。核心属性AAPL,ig-platform-id决定 macOS 如何让 iGPU 驱动与硬件交互Skylake 台式机二选一AAPL,ig-platform-id适用场景00001219台式机 iGPU 直接驱动显示器时使用01001219台式机 iGPU 仅用于计算任务、不驱动显示器无头模式时使用此外还需添加 3 个 framebuffer 相关属性framebuffer-patch-enable开启 WhateverGreen 补丁能力framebuffer-stolenmem将最小 stolen memory 设为 19MBframebuffer-fbmem将 framebuffer 内存设为 9MB。通常这一步并非必需BIOS 中设置 64MB 即可但当 BIOS 无法配置 iGPU 内存时则必须添加。注意无头 framebuffer由 dGPU 负责输出不需要framebuffer-patch-enable、framebuffer-stolenmem与framebuffer-fbmem。P530 用户注意HD P530 的 iGPU 不被原生支持必须额外添加device-id属性KeyTypeValuedevice-idData1B190000完成后的完整示例适用于“无 dGPU 且 BIOS 无 iGPU 内存选项的 HD P530 台式机”KeyTypeValueAAPL,ig-platform-idData00001219framebuffer-patch-enableData01000000framebuffer-stolenmemData00003001framebuffer-fbmemData00009000device-idData1B190000若安装 macOS VenturaSkylake 的 HD 5xx/P5xx、Iris 5xx、Iris Pro 5xx 等 iGPU 已不被支持需按 extras/ventura.md 的说明将device-id与AAPL,ig-platform-id改为最接近的 Kaby Lake 型号配合 WhateverGreen v1.6.1 及以上版本实现 spoof若同一份 EFI 还需要引导 Monterey 及以下版本请追加 boot-arg-igfxsklaskbl。Add音频注入PciRoot(0x0)/Pci(0x1b,0x0)layout-id用于 AppleALC 音频注入你需要自行调研主板声卡型号并匹配 AppleALC 支持的 layout。对本平台而言可以直接删除该属性改用 boot-argalcidxxx完成注入——alcid会覆盖所有已存在的 layout-id。Delete用于从映射中移除设备属性本平台可以忽略。Kernel 分区Kext 加载顺序与内核 QuirkAddKext 清单与加载顺序此处声明要加载的 kext、加载顺序及目标架构。关键规则加载顺序任何插件的加载必须晚于其依赖项因此 Lilu必须排在 VirtualSMC、AppleALC、WhateverGreen 等之前。ProperTree 的Cmd/Ctrl Shift R会自动按正确顺序加入所有 kext无需手动逐个输入。Archkext 支持的架构可取Any、i38632 位、x86_6464 位。BundlePathkext 名称例如Lilu.kext。Enabled启用或禁用该 kext。ExecutablePathkext 内可执行文件路径右键 “Show Package Contents” 查看通常为Contents/MacOS/Kext部分 kext 藏在Plugin文件夹内纯 plist kext 无需填写。例如Contents/MacOS/Lilu。MinKernel / MaxKernelkext 注入的内核版本下限/上限取值参见下表例如12.00.00对应 OS X 10.8。PlistPathkext 内info.plist的路径例如Contents/Info.plist。内核版本对照表OS X 版本MinKernelMaxKernel10.48.0.08.99.9910.59.0.09.99.9910.610.0.010.99.9910.711.0.011.99.9910.812.0.012.99.9910.913.0.013.99.9910.1014.0.014.99.9910.1115.0.015.99.9910.1216.0.016.99.9910.1317.0.017.99.9910.1418.0.018.99.9910.1519.0.019.99.991120.0.020.99.991221.0.021.99.991322.0.022.99.991423.0.023.99.991524.0.024.99.99Emulate / Force / Block / PatchEmulate用于伪装不支持的 CPU如 Pentium、CeleronCpuid1Mask与Cpuid1Data均留空。Force用于从系统卷以外加载 kext仅对老系统中缓存缺失的 kext如 10.6 的 IONetworkingFamily有意义本平台忽略。Block阻止特定 kext 加载本平台不相关。Patch同时作用于内核与 kext 的补丁本平台无需配置。QuirksSkylake 必须调整的 5 项Quirk值说明AppleXcpmCfgLockYES仅当 BIOS 无法关闭 CFG-Lock 时需要适用于 Haswell 及更新平台含支持 XCPM 的 Ivy Bridge-EDisableIoMapperYES绕过 VT-D若 BIOS 已关闭 VT-D 则无需LapicKernelPanicNO关闭 AP 核心 lapic 中断导致的内核恐慌HP 机型需要启用PanicNoKextDumpYES内核恐慌时允许读取恐慌日志PowerTimeoutKernelPanicYES修复 Catalina 中 Apple 驱动电源变化导致的内核恐慌多见于数字音频XhciPortLimitYES即 15 端口限制补丁运行 macOS 11.3 时请关闭并尽快制作 USB 映射其余 quirk 的完整参考保持默认即可AppleCpuPmCfgLock仅 Ivy Bridge 及更老需要Broadwell 及更老跑 10.10 及以下需要、CustomSMBIOSGuidDell 笔记本配合UpdateSMBIOSMode: Custom使用不推荐用此方式禁止向 non-Apple OS 注入 SMBIOS会破坏 Bootcamp 兼容性、DisableIoMapperMappingVT-D 开启且内存大于 16GB 时若遇到 Wi-Fi/以太网/雷电问题需要且要求已移除 Reserved Memory Regions 的 DMAR 表13.2.1 及以下无需、DisableLinkeditJettison让 Lilu 等无需keepsyms1也能更可靠运行、DisableRtcChecksum阻止 AppleRTC 写入主校验和 0x58-0x59解决重启/关机后 BIOS 重置或进入安全模式、ExtendBTFeatureFlags非 Apple/非 Fenvi 网卡连续性问题的辅助、LegacyCommpage解决 64 位 CPU 的 SSSE3 需求主要针对 Prescott 等、SetApfsTrimTimeout: -1仅 macOS 10.14 且 SSD 有问题时设置 APFS trim 超时。Scheme面向旧系统10.4–10.6的遗留引导设置FuzzyMatch: True用于忽略 kernelcache 校验和KernelArch: x86_64可取Auto/i386/x86_6410.4–10.5 建议Auto其中i386-user32表示 32 位用户空间、供 32 位 CPU 或无 SSSE3 的 CPU 使用KernelCache: Auto推荐保持自动以获得最佳支持。Misc 分区启动行为、调试与安全BootQuirk值说明HideAuxiliaryYES在引导选择器中隐藏辅助条目macOS 恢复、工具等多盘系统可提升启动性能按空格键可随时显示这些条目Debug以下设置用于排查 OpenCore 启动问题除DisplayDelay外全部修改Quirk值AppleDebugYESApplePanicYESDisableWatchDogYESTarget67这些数值基于 troubleshooting/debug.md 的计算方法Target取0x01记录日志0x02屏幕调试0x40记录到文件0x43换算为十进制即67DisplayLevel取0x80000002DEBUG_ERROR DEBUG_WARN2147483650可显示更多调试信息且需要 DEBUG 版 OpenCore。AppleDebug启用 boot.efi 日志仅 10.15.4 及更新支持ApplePanic将内核恐慌写入磁盘建议搭配 boot-argkeepsyms1DisableWatchDog关闭 UEFI watchdog有助于解决早期启动卡死SysReport可用于转储 ACPI 表等仅限 DEBUG 版。Security不可跳过的安全设置Quirk值说明AllowSetDefaultYES允许在引导选择器中用CTRLEnter/CTRLIndex设定默认启动项BlacklistAppleUpdateYES阻止固件更新Big Sur 起不再使用run-efi-updater变量此设置提供额外保护ScanPolicy00允许看到所有可用驱动器保持默认将无法引导 USB 设备SecureBootModelDefault保持Default让 OpenCore 依据 SMBIOS 自动设置对应值取值策略详见 config.plist/security.mdBig Sur–Sonoma 推荐DefaultHigh Sierra–Catalina 需对照 T2 型号最低版本表若不符或使用 NVIDIA Web Drivers 则设DisabledSonoma 14.4 以上 OTA 升级需设DisabledSierra 及以下无影响VaultOptional该值是字符串而非可省略项必须设为Optional区分大小写设为Secure将无法启动补充参考ApECID个性化安全启动标识当前因 macOS 安装器 bug 并不可靠保持0、AuthRestartFileVault 2 认证重启可选安全风险项、DmgLoading: Signed仅加载签名 DMG、ExposeSensitiveData: 6显示更多调试信息、SecureBootModel升级 OpenCore 后若出现早期启动失败可参考 kernel-issues.md 中 Stuck on OCB: LoadImage failed - Security Violation 一节。Serial / Tools / EntriesSerial用于串口调试保持默认Tools用于运行 shell 等 OC 调试工具ProperTree 快照会自动加入Entries用于指定 OpenCore 无法自动发现的非常规启动路径本文不展开。NVRAM 分区boot-args 与关键变量Add三个关键 GUID4D1EDE05-38C7-4A6A-9CC6-4BCCA8B38C14OpenCore UI 缩放默认即可其中DefaultBackgroundColor可设为00000000Syrah Black或BFBFBF00Light Gray。4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102OpenCore 的 NVRAM GUID主要与 RTCMemoryFixup 用户相关rtc-blacklist留空即可多数用户可忽略该节。7C436110-AB2A-4BBB-A880-FE41995C9F82SIP 位掩码所在 GUID包含关键 boot-args通用 boot-argsboot-args说明-v详细模式verbose启动时滚动显示后台文本而非 Apple logo是排查问题 kext 的利器debug0x100关闭 macOS 的 watchdog内核恐慌时不自动重启便于收集日志keepsyms1配合debug0x100内核恐慌时打印符号信息alcid1为 AppleALC 设置 layout-id按声卡型号查表取值会覆盖其他 layout-idGPU 专用 boot-argsboot-args说明agdpmodpikera关闭部分 Navi GPURX 5000 6000 系列的 board ID 检查否则黑屏非 Navi 卡如 Polaris、Vega不要使用-radcodec允许伪装后的官方不支持的 AMD GPU 使用硬件视频编码器radpg15禁用部分电源门控模式帮助 AMD Cape Verde 系列 GPU 正确初始化unfairgva1修复受支持 AMD GPU 的硬件 DRM 支持nvda_drv_vrl1在 Sierra/High Sierra 中启用 Maxwell/Pascal 卡的 NVIDIA Web Drivers-wegnoegpu禁用除 Intel iGPU 外的所有 GPU适合 dGPU 不受新版 macOS 支持时使用更多禁用方式见 extras/spoof.md其他关键变量csr-active-config00000000为默认值即启用 SIP。一般建议通过恢复分区的csrutil修改并保持 SIP 开启。run-efi-updaterNo阻止 Apple 固件更新包安装并破坏引导顺序这些面向 Mac 的固件更新在 Hackintosh 上无效。prev-lang:kbd非拉丁键盘需要格式为lang-COUNTRY:keyboard推荐留空Sample 默认是俄语。美式键盘为en-US:0HEX 为656e2d55533a30该变量可改为 String 类型直接填入en-US:0也可设为空变量强制首次启动弹出语言选择器。KeyTypeValueprev-lang:kbdStringen-US:0DeleteAdd不会覆盖NVRAM 中已存在的值因此boot-args等变量只能在此处强制重写。本平台需设置Quirk值WriteFlashYESLegacySchema用于为无原生 NVRAM 的系统配合OpenVariableRuntimeDxe.efi分配变量本平台无需。PlatformInfo 分区SMBIOS 生成与注入Generic使用 GenSMBIOS 生成 iMac17,1使用 CorpNewt 的GenSMBIOS选项 1 下载 MacSerial选项 3 选择 SMBIOS。对 Skylake 台式机本指南示例选择iMac17,1输出类似####################################################### # iMac17,1 SMBIOS Info # ####################################################### Type: iMac17,1 Serial: C02S3HYWGG7L Board Serial: C02629102GUGPF7AD SmUUID: 3508AD44-B67D-4AD7-A109-7955130A1033字段对应关系Type→Generic - SystemProductNameSerial→Generic - SystemSerialNumberBoard Serial→Generic - MLBSmUUID→Generic - SystemUUID。Generic - ROM可填 Apple ROM从真机提取、NIC MAC 地址或任意随机 MAC本指南示例用11223300 0000安装完成后可按仓库内 iServices 修复章节找到真实 MAC。Automatic: YES基于 Generic 分区自动生成 PlatformInfo而无需手工维护 DataHub、NVRAM、SMBIOS 三个分区。重要提醒必须使用无效的序列号——在 Apple 的 Check Coverage 页面查询时应得到 Unable to check coverage for this serial number. 的提示。另外iMac17,1 在 macOS Ventura 中被移除若安装 Ventura 请改用 Kaby Lake 系列 SMBIOS可参考 extras/ventura.md 与 extras/smbios-support.md 的 SMBIOS 选择建议带 dGPU 的台式机使用 iMac18,2/MacPro7,1/iMacPro1,1iGPU 不受支持的台式机使用 iMac18,1。Generic 其余字段AdviseFeaturesEFI 分区不是 Windows 盘第一分区时使用、MaxBIOSVersionBig Sur 中阻止固件更新主要针对真 Mac、ProcessorType: 0自动检测可覆盖、SpoofVendor: YES厂商字段替换为 Acidanthera多数情况下不宜使用 Apple 作厂商、SystemMemoryStatus: Auto纯外观项、UpdateDataHub/UpdateNVRAM/UpdateSMBIOS: YES、UpdateSMBIOSMode: CreateDell 笔记本如需CustomSMBIOSGuid则用Custom。UEFI 分区驱动与文件系统支持ConnectDrivers: YES强制连接 .efi 驱动改为 NO 会自动连接已添加的 UEFI 驱动启动略快但并非所有驱动都会自连接部分文件系统驱动可能不加载。Drivers此处只应保留两个驱动HfsPlus.efiOpenRuntime.efi驱动条目字段Path相对OC/Drivers的文件路径、LoadEarly是否在 NVRAM 建立前提前加载仅OpenRuntime.efi及使用遗留 NVRAM 的OpenVariableRuntimeDxe.efi应启用、Arguments部分驱动接受的附加参数。APFS默认情况下 OpenCore 只从 macOS Big Sur 及更新版本加载 APFS 驱动。若引导 Catalina 及更早版本必须设置新的最低版本/日期否则OpenCore 可能找不到 macOS 分区。Sierra 及更早使用 HFS可跳过本节。MinVersion 与 MinDate 需同时设置macOS 版本Min VersionMin DateHigh Sierra10.13.674807700800000020180621Mojave10.14.694527500700000020190820Catalina10.15.4141210100100000020200306无限制-1-1Audio / Input / Output / ProtocolOverrides / Quirks / ReservedMemoryAudio与 AudioDxe 相关与 macOS 内音频支持无关保持默认。Inputboot.efi 键盘透传FileVault、热键支持保持默认。Output视觉输出相关UIScale: 0会自动按分辨率设置-1保持不变、1普通屏 1x、2HiDPI 2x保持默认。ProtocolOverrides主要面向虚拟机、旧 Mac 与 FileVault 用户保持默认。Quirks本平台修改如下Quirk值说明UnblockFsConnectNO部分固件以 By Driver 模式打开分区句柄导致文件系统协议无法安装HP 主板主要需要表现为不列出任何磁盘其余保持默认DisableSecurityPolicy关闭固件平台安全策略适合关闭 Secure Boot 仍无法加载第三方驱动的问题固件Microsoft Surface 建议开启、RequestBootVarRouting: YES将启动变量从EFI_GLOBAL_VARIABLE_GUID重定向到OC_VENDOR_VARIABLE_GUID防止固件删除启动项所有系统都建议开启以保证更新安装与启动磁盘面板正常。ReservedMemory用于把某些内存区域排除在操作系统之外主要针对 Sandy Bridge iGPU 或有故障内存的系统本文不展开。收尾保存、部署与 BIOS 设置保存并部署完成以上配置后即可保存并放入 EFI 分区的EFI/OC/目录。注意config.plist 必须与 EFI 目录内容严格一致——删除文件却保留在 config 中会导致 OpenCore 报错停止启动任何修改后可用 ProperTree 的 OC 快照Cmd/Ctrl R同步更新。若遇到启动问题先查阅仓库的 troubleshooting/troubleshooting.md按 OpenCore 启动问题、内核空间问题、用户空间问题、安装后问题分类排查。Intel BIOS 设置以下选项可能并非全部存在于你的固件中尽量匹配即可不必过分担心缺失项。建议关闭Fast Boot快速启动Secure Boot安全启动Serial/COM Port串口Parallel Port并口VT-d若开启则必须同时启用Kernel - Quirks中的DisableIoMapperCompatibility Support ModuleCSM——大多数情况下必须关闭开启时常见gIO等 GPU 错误或卡死Thunderbolt首次安装时关闭配置不当会引发问题Intel SGXIntel Platform TrustCFG LockMSR 0xE2 写保护——必须关闭若找不到该选项则启用Kernel - Quirks中的AppleXcpmCfgLock否则 CFG-Lock 开启状态下无法启动建议开启VT-xAbove 4G DecodingHyper-ThreadingExecute Disable BitEHCI/XHCI Hand-offOS type: Windows 8.1/10 UEFI Mode部分主板需选 Other OSDVMT Pre-AllocatediGPU 内存64MB 或更高SATA Mode: AHCI下一步BIOS 设置完成后还需修改几项额外值主要是Misc - Security - SecureBootModel等安全相关设置请继续阅读 config.plist/security.md全部就绪后即可进入安装流程见 installation-process.md。赞分享文档教程【免费下载链接】OpenCore-Install-GuideRepo for the OpenCore Install Guide项目地址https://gitcode.com/gh_mirrors/op/OpenCore-Install-Guide点击查看免费下载相关推荐OpenCore-Install-Guide 笔记本 Skylake 平台 config.plist 完整配置指南从 SSDT 注入到 SMBIOS 仿冒的逐项实操OpenCore Install Guide 笔记本 Skylake 平台 config.plist 完整配置指南从 SSDT 注入到 SMBIOS 仿冒的逐文档教程Badger 数据库故障排查实战指南从写入卡死到数据迁移的完整方案Badger 数据库故障排查实战指南从写入卡死到数据迁移的完整方案 本指南以 Badger 官方 docs/troubleshooting.md https:文档教程Swift 注释与运算符解析规则详解SE-0037 如何统一前缀/中缀/后缀运算符的判定Swift 注释与运算符解析规则详解SE 0037 如何统一前缀/中缀/后缀运算符的判定 SE 0037「Clarify interaction betwee文档教程上一篇Betteralign 项目使用教程下一篇5分钟免费安装Akagi麻将AI助手从新手到高手的完整指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考