
Omarchy 在 Intel Mac 上的安装指南支持范围、自动硬件适配与已知限制【免费下载链接】omarchyBeautiful, Modern Opinionated Linux项目地址: https://gitcode.com/GitHub_Trending/om/omarchyOmarchyBeautiful, Modern Opinionated Linux基于 Arch Hyprland Quickshell对Intel Mac 提供了开箱即用的内置支持安装器可自动识别 Mac 硬件并完成 Broadcom 无线网卡、SPI 键盘、NVMe 休眠等一系列修复。本文以官方手册 manual/44-mac-support.md 为骨架结合仓库中 install/hardware/apple/ 目录下的真实硬件适配脚本完整梳理 Intel Mac 的安装流程含关闭 Apple Secure Boot、T1/T2 芯片机型逐型号支持矩阵、底层自动修复原理与已知限制帮助你把闲置的老款 MacBook 重新激活为可日常使用的 Linux 主力机。Omarchy 运行在 MacBook 上的实机截图来源manual/images/macbook-omarchy.webp。官方手册记录了一次简单测试仅通过安装 Omarchy就在一台 2019 款 MacBook Pro 上获得了约 36% 的性能提升。支持范围概览Intel Mac 支持M 系列暂不支持在动手之前先明确 Omarchy 当前对 Mac 硬件的支持边界依据 manual/44-mac-support.md硬件世代支持状态说明Intel Mac含 T1/T2 安全芯片机型✅ 内置支持安装器自动检测并施加对应修复官方社区持续维护Apple siliconM1/M2/M3 等 M 系列❌ 暂不直接支持官方安装流程不支持直接安装需绕道社区方案需要注意的是本文介绍的支持路径仅针对 Intel Mac。M 系列 Mac 的现状与进展官方指引读者前往社区 Discord 的#omarchy-on-other频道了解实时状态仓库中也有一份独立的 manual/49-omarchy-on.md 记录了 M1/M2基于 Asahi Linux 的社区方案、Parallels 虚拟机等非默认硬件上运行 Omarchy的社区做法可作为延伸参考。安装前必须接受的几条事实Omarchy 在 Mac 上的安装模式与普通 PC 上的全盘安装一致因此有两个前提需要你提前确认详见 manual/44-mac-support.md当前仅支持将 Omarchy 作为唯一的操作系统。安装过程中整块硬盘会被清空并重写macOS 将不再可引导。macOS 仍可恢复。如果你之后反悔了可以通过 macOS 的Internet Recovery网络恢复重新装回 macOS——换句话说这是一条单向但可逆的路重要数据请务必提前备份。动手前请先完整阅读 Getting Started入门指南并准备好已经烧录好 Omarchy ISO 的 U 盘。ISO 下载后在 Mac/Windows 上可用 balenaEtcher 写入 U 盘在 Linux 上可用 caligula 写入。如果你打算与 Windows 或其他系统共存则属于空闲空间安装的场景需参考 双系统安装指南但如前述在 Mac 上目前仅支持 Omarchy 独占整盘。此外Mac 上的全盘安装同样默认启用全盘加密这与你用惯了 FileVault 的体验一致。若启动时需要输入加密密码记得准备有线或 2.4GHz 无线键盘——蓝牙键盘在引导阶段无法输入加密密码。第一步关闭 Apple Secure Boot与普通 PC 需要关闭 BIOS 中的 Secure Boot 一样参见 manual/02-getting-started.md要在 Intel Mac 上引导安装 U 盘和 Omarchy 系统必须关闭 Apple 的 Secure Boot。请严格按以下步骤操作依据 manual/44-mac-support.md先完全关闭 Mac 电源。开机后立刻按住Command (⌘) R直到出现加载画面。选择你的用户账户如有提示则输入密码这一步进入的是 macOS 恢复分区。在恢复界面中从菜单栏选择Utilities实用工具 Startup Security Utility启动安全性实用工具。按提示输入密码完成身份验证。在Secure Boot安全启动选项中选择No Security无安全性。在External Boot外部启动选项中选择Allow booting from external or removable media允许从外部介质或可移动介质启动。T2 芯片机型的 Secure Boot 策略由 T2 安全芯片强制执行因此这一步对 2018 年及以后的 Intel MacBook Pro/MacBook Air/iMac Pro/Mac mini 同样必不可少只有完成设置U 盘上的 EFI 引导程序才被允许运行。第二步从 U 盘引导并完成安装Secure Boot 关闭后按如下流程启动安装依据 manual/44-mac-support.md插入烧录好的 Omarchy 启动 U 盘。重启 Mac并在开机后立刻按住Option (⌥)键直到出现启动设备列表。在列表中选择橙色的 EFI Boot 设备即 U 盘。之后与普通 PC 的安装流程完全一致按 Getting Started 的向导逐步完成即可。关键点在于安装器会自动识别 Mac 硬件并应用所需修复全程无需手工干预。官方手册明确列出的自动修复包括Broadcom Wi-Fi 驱动与固件SPI 键盘驱动适用于需要它的 MacBook 机型针对这些机型的 NVMe 休眠修复。在仓库中这些自动修复被拆分为四个可独立运行的检测脚本统一由 install/hardware/all.sh 在安装阶段按顺序调用run_logged $OMARCHY_INSTALL/hardware/apple/fix-spi-keyboard.sh run_logged $OMARCHY_INSTALL/hardware/apple/fix-suspend-nvme.sh run_logged $OMARCHY_INSTALL/hardware/apple/fix-t2.sh run_logged $OMARCHY_INSTALL/hardware/apple/fix-brcmfmac-supplicant.sh这四个脚本都采用同一设计哲学先通过lspci/DMI 信息探测硬件命中才动手因此对非 Mac 设备零副作用。安装器背后的自动修复仓库源码逐条拆解下面结合 install/hardware/apple/ 目录中的脚本看看官方手册描述的每项自动修复在系统层面到底做了什么。Broadcom Wi-Fi关掉固件里的 WPA 握手卸载install/hardware/apple/fix-brcmfmac-supplicant.sh 针对的是 Apple Mac 上由brcmfmac驱动的 Broadcom Wi-Fi 芯片。这类芯片的固件会把 WPA 四次握手放在固件内完成即 offload但当接入点是WPA2/WPA3 过渡模式时固件握手会失败——表现为能关联上 AP四次握手永不完成NetworkManager 一直报密码错误。脚本的修复方式是写入 modprobe 配置把固件侧的握手功能关掉把握手交还给软件态的wpa_supplicant# /etc/modprobe.d/brcmfmac.conf # 关闭固件 supplicantFWSUP, 0x2000与固件 authenticatorFWAUTH, 0x80000 options brcmfmac feature_disable0x82000其中0x82000 0x2000 | 0x80000正好对应注释中说明的两个固件功能位。脚本的触发条件是检测到 T2 安全芯片的 PCI ID106b:1801/1802或sys_vendor为 Apple 且无线网卡命中一系列 Broadcom PCI ID如 BCM43602 及其变体、BCM4350/4355/4364、以及 T2 时代的 BCM4377/4378/4387。脚本注释特别指出这个 bug 出在 Broadcom 固件本身而非 T2 桥接所以所有由brcmfmac驱动的 Mac包括 2015 年采用 BCM43602 的 MacBookPro11,4都需要它而 2013–2015 年使用 BCM4360 的机器之所以被刻意排除是因为它们跑的是树外的wl驱动根本不读brcmfmac的选项。老机型 Wi-Fibroadcom-wl闭源驱动对应地install/hardware/fix-bcm43xx.sh 负责为更老的 MacBook 芯片安装驱动包当lspci命中14e4:43a0BCM43602013–2015 款 MacBook或14e4:4331BCM43312012/2013 初款 MacBook时安装broadcom-wl dkms linux-headers由 DKMS 在本地编译树外的wl驱动。SPI 键盘让内置键盘在 initramfs 阶段就可用install/hardware/apple/fix-spi-keyboard.sh 通过读取 DMI 的product_name命中MacBook8,1 | 9,1 | 10,1 | MacBookPro13,1-3 | MacBookPro14,1-3即 2015–2017 年的 12 英寸 MacBook 与 2016–2017 年的 Touch Bar MacBook Pro时安装macbook12-spi-driver-dkms并根据机型写入对应内核模块# MacBook8,12015/2016 款 12 英寸 MacBook MODULES(applespi spi_pxa2xx_platform spi_pxa2xx_pci) # 其余机型2016–2017 MacBook Pro 等 MODULES(applespi intel_lpss_pci spi_pxa2xx_platform)这些模块被写入/etc/mkinitcpio.conf.d/macbook_spi_modules.conf从而保证内置键盘驱动在 initramfs 阶段即被加载——否则解锁全盘加密时你将无键盘可用。NVMe 休眠禁止设备进入 D3coldinstall/hardware/apple/fix-suspend-nvme.sh 针对同样的机型集合MacBook(8,1|9,1|10,1)|MacBookPro13,[123]|MacBookPro14,[123]解决 NVMe 固态从睡眠唤醒失败的问题。做法是创建一个 systemd 服务omarchy-nvme-suspend-fix.service在每次开机时将0000:01:00.0这个 PCI 设备的d3cold_allowed写为0禁止 NVMe 控制器进入 D3cold 电源状态[Service] ExecStart/bin/bash -c echo 0 /sys/bus/pci/devices/0000\:01\:00.0/d3cold_allowed [Install] WantedBymulti-user.target脚本同时做了防御性检查若该 PCI 地址不存在会给出警告并跳过避免在不需要此修复的机型上误写。T1 芯片机型支持范围与已知问题Apple T1 芯片于 2016 年底推出仅用于第一代带 Touch Bar 的 MacBook Pro依据 manual/44-mac-support.md。受支持的具体型号如下机型型号标识ModelMacBook Pro 13 英寸2016两个雷雳 3 端口A1706MacBook Pro 13 英寸2016四个雷雳 3 端口A1708MacBook Pro 15 英寸2016A1707在 T1 机型上Omarchy 可以正常安装运行但官方明确标注了以下已知问题Touch Bar 无法工作non-functional声音无法工作not functioning。从仓库脚本看T1 世代机型的自动修复主要落在 fix-spi-keyboard.sh 与 fix-suspend-nvme.sh 两个脚本覆盖的MacBookPro13,x机型集合上而上述 Touch Bar、音频两项短板至今仍是官方列出的未解决事项。T2 芯片机型linux-t2内核与全家桶驱动Apple T2 安全芯片于 2017 年随 iMac Pro 引入并一直沿用到 2020 年转向 Apple silicon 为止依据 manual/44-mac-support.md。官方列出以下受支持机型机型型号标识ModeliMac Pro2017A1862MacBook Pro 13 英寸2018四个雷雳 3 端口A1989MacBook Pro 15 英寸2018A1990MacBook Air视网膜屏13 英寸2018A1932Mac mini2018A1998MacBook Pro 13 英寸2019两个雷雳 3 端口A2159MacBook Pro 13 英寸2019四个雷雳 3 端口A2178MacBook Pro 15 英寸2019A1990MacBook Pro 13 英寸2020两个雷雳 3 端口A2265MacBook Pro 15 英寸2020A1990在这些机型上安装器会自动完成以下配置官方手册原文 fix-t2.sh 脚本双重印证打补丁的linux-t2内核含linux-t2-headersT2 音频配置apple-t2-audio-configApple 的 Broadcom Wi-Fi / 蓝牙固件apple-bcm-firmware通过t2fanrd实现风扇控制Touch Bar则运行在内核内置的 Boot Camp 风格的触摸条支持之上。T2 检测与驱动装载的源码细节install/hardware/apple/fix-t2.sh 用一行 PCI 探测完成识别——Applevendor106b的 T2 安全芯片设备 ID 是1801或1802if lspci -nn | grep 106b:180[12] /dev/null; then命中后依次执行安装内核与驱动包linux-t2、linux-t2-headers、apple-t2-audio-config、apple-bcm-firmware、t2fanrd启用风扇控制服务systemctl enable t2fanrd.service写入内核模块预加载/etc/modules-load.d/t2.conft2bce_vhci与hci_bcm4377。脚本注释说明linux-t27.1.4 起用t2bce驱动取代了旧的apple-bcet2bce_vhci是内置键盘所挂载的虚拟 USB 主机控制器而t2bce_core/t2bce_dma会由 mkinitcpio 依据模块依赖自动纳入写入 mkinitcpio 模块列表/etc/mkinitcpio.conf.d/apple-t2.confMODULES(t2bce_vhci usbhid hid_apple hid_generic xhci_pci xhci_hcd)确保键盘在解密启动阶段可用追加内核命令行/etc/limine-entry-tool.d/t2-mac.confKERNEL_CMDLINE[default] intel_iommuon iommupt pm_asyncoff mem_sleep_defaultdeep其中intel_iommuon iommupt打开 IOMMU 并采用直通模式pm_asyncoff、mem_sleep_defaultdeep则与 T2 平台的电源管理稳定性相关。风扇曲线配置脚本还生成了/etc/t2fand.conf风扇控制配置。其注释说明t2fanrd只会读取检测到的风扇所对应的 section因此双风扇配置中的[Fan2]在单风扇机型上被安全忽略、在双风扇 MacBook Pro 上则必不可少[Fan1] low_temp55 high_temp75 speed_curvelinear always_full_speedfalse [Fan2] low_temp55 high_temp75 speed_curvelinear always_full_speedfalse即温度低于 55℃ 时风扇低速运行高于 75℃ 时按线性曲线拉升到满速。日常使用体验与键盘适配安装完成后Intel Mac 上的日常体验与普通 Omarchy 机器一致且官方手册 manual/03-coming-from-mac-or-windows.md 的 On Mac hardware 一节专门说明了键盘适配细节Omarchy runs well on Intel Macs — see Mac support. And the keyboard is kind to you: Omarchy doesnt remap anything, and Linux treats the Command key as Super, so Super sits right where Cmd always was.也就是说Omarchy 不做任何按键重映射Linux 天然把 Command 键当作 Super 键处理Super 恰好就在你熟悉的 Cmd 位置上。因此来自 macOS 的用户在 Omarchy 上沿用肌肉记忆即可Super 1/2/3/4切换工作区对应 macOS 的 Spaces、Super C/X/V全局复制粘贴包括终端内无需为终端单独学习CtrlShiftC/V。已知限制与社区生态官方在 manual/44-mac-support.md 中明确提示社区成员一直在持续攻克这些挑战。如果你遇到的正是上面列出的限制T1 机型的 Touch Bar / 音频、或任何文档未覆盖的硬件问题可以加入社区 Discord 的#omarchy-on-other频道查看是否有最新的社区解决方案——这类官方未完成但社区有解法的状态变化较快以频道内实时信息为准。此外如果你手头不是 Intel Mac也可以参考 manual/49-omarchy-on.md 中记录的社区路线图M1/M2 Mac 上有基于 Asahi Linux 的社区发行版与配套的 Omarchy 用户配置指南还有 Parallels 虚拟机内安装的用户驱动教程。这些方案属于需要额外折腾的社区路径与本文的 Intel Mac 原生安装不在同一支持层级选择时请注意区分。小结把老款 Intel Mac 变成 Omarchy 机器的完整路径阶段关键动作依据准备通读 Getting Started备好 Omarchy 启动 U 盘接受独占整盘、macOS 仅可通过 Internet Recovery 恢复manual/44-mac-support.md解锁恢复模式CmdR→ Startup Security Utility → Secure Boot 选 No Security、External Boot 允许外部介质同上引导安装开机按住Option→ 选择橙色 EFI Boot 设备 → 按正常向导安装同上自动修复安装器调用 apple/ 目录 四个脚本SPI 键盘、NVMe 休眠、T2 全家桶、brcmfmac WPA 修复老芯片另装broadcom-wlinstall/hardware/all.sh日常使用Command Super无需重映射全盘加密、工作区、全局剪贴板等体验与普通 Omarchy 一致manual/03-coming-from-mac-or-windows.md自知之明T1 机型 Touch Bar 与音频不可用M 系列不直接支持manual/44-mac-support.md总而言之只要你的机器落在上文列出的 T1/T2 Intel 型号范围内、且能接受官方标注的两三项硬件限制Intel Mac 就是 Omarchy 的一等公民硬件安装器自动完成内核、固件、驱动、风扇与电源管理的一整套适配官方记录的一次简单测试甚至在一台 2019 款 MacBook Pro 上测出了约 36% 的性能提升——给吃灰的老 MacBook 换上 Omarchy或许正是它重获新生的最快路径。【免费下载链接】omarchyBeautiful, Modern Opinionated Linux项目地址: https://gitcode.com/GitHub_Trending/om/omarchy创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考