这是一份给 macOS 用户的 Omarchy 上手教程。你会在 Mac 上运行一个 Omarchy Linux 虚拟机，不需要抹掉 macOS，也不需要改成双启动。文章从检查 Mac 开始，直到安装、配置、共享文件和更新。
Apple Silicon
M 系列 Mac。
macOS 15+
最低系统版本。
约 15 GB
首次准备空间。
Omarchy 在 Apple Silicon Mac 的 macOS 窗口中运行。
先弄清楚：你安装的是什么。
Omarchy 是一套面向开发者的 Linux 桌面方案。它建立在 Arch Linux 上，使用 Hyprland 管理平铺窗口，再加入预选的开发工具、主题、快捷键和 Shell 配置。
macOS 用户走的是虚拟机路径。启动器在 Mac 上运行 QEMU，并调用 Apple Hypervisor Framework。Omarchy 运行在 Linux 客体系统里，Mac 负责提供窗口、网络、音频、摄像头和部分文件共享能力。
因此，文章中的“安装 Omarchy”指的是在 Mac 上准备一个可运行的 Omarchy 虚拟机。它不会改变 Mac 的启动磁盘，也不会把 macOS 替换成 Linux。
第一步：检查前置条件。
1. 芯片。打开左上角 Apple 菜单，选择“关于本机”。处理器应显示 Apple M 系列芯片。当前 Mac 虚拟机路径面向 Apple Silicon，Intel Mac 不在这条支持范围内。
2. 系统。在“关于本机”中确认 macOS 为 15 或更高版本。系统版本过低时，先完成 macOS 更新，再安装启动器。
3. 内存。16 GB 内存是更合适的起点。项目默认给 16 GB 及以上的 Mac 分配 8 GB 给虚拟机，内存较小的 Mac 默认分配 4 GB。8 GB 内存的 Mac 也能尝试，但 macOS 与 Omarchy 需要共同使用这部分内存。
4. 存储。首次启动会下载约 3 GB 镜像，并准备虚拟磁盘。官方说明的初始空间约为 15 GB。建议在此基础上再留出 20 GB 以上可用空间，用于 Linux 更新、软件和项目文件。
5. 权限。安装应用需要把 DMG 中的应用拖入 Applications。首次运行可能需要 macOS 的网络、摄像头、麦克风或辅助功能授权。没有这些权限时，Omarchy 仍可能启动，但对应的硬件桥接和快捷键会受影响。
6. 网络。首次启动需要下载镜像。准备一条稳定的网络连接，避免在 Mac 即将休眠、网络频繁切换或磁盘空间接近满额时安装。
7. 备份。第一次体验前，先把重要项目和配置放到 Mac 原有目录或云端。Factory Reset 会删除虚拟机，不能把虚拟磁盘当成唯一备份。
适合先试用的人：经常使用终端、编辑器、Git、Docker 和 Linux 服务的开发者。
需要 Xcode、macOS 专属设计软件或稳定视频硬件加速的人，应先把它当作独立试用环境。
第二步：下载并安装 Mac 启动器。
打开项目的 GitHub Releases 页面。下载最新的签名并完成公证的 DMG 文件。不要从不明的网盘、镜像站或第三方打包页面下载。
双击 DMG，打开安装窗口。把应用拖入 Applications。然后从 Applications 启动应用，首次启动不要直接从下载目录运行。
如果 macOS 弹出开发者或安全提示，先确认你下载的是项目 Release 中的签名版本。不要为了启动未知文件而关闭系统安全保护。
第三步：完成第一次启动。
启动器第一次运行会下载约 3 GB 的 Omarchy 镜像。下载进度会显示在启动按钮附近。下载中断后，再次打开应用可以继续之前的进度。
镜像分片使用 SHA-256 校验。下载完成后，启动器会创建虚拟磁盘，启动 Linux，并进入 Omarchy 的账户配置流程。第一次启动比后续启动慢，这是正常现象。
按照屏幕提示设置键盘布局、用户名和密码。Omarchy 的安装向导和菜单主要使用英文，中文用户可以先保持默认键盘布局，进入系统后再调整。
第一次进入桌面后，先不要急着安装大量软件。确认网络、键盘、触控板、声音和窗口显示正常，再进入下一步资源配置。
第四步：配置资源，决定它是否好用。
启动菜单中选择 Resources → Configure…。这里可以调整处理器核心数、内存和虚拟磁盘上限。
16 GB 内存的 Mac 可以先保留默认的 8 GB。8 GB 内存的 Mac 不要盲目把虚拟机调到 8 GB，至少给 macOS 保留 4 GB，避免宿主系统频繁交换内存。
处理器核心数可以先使用默认值。运行编译、测试或多个容器时，再逐步增加。核心数越多，不代表所有任务都会更快，Mac 还要为 macOS 和其他应用留出资源。
虚拟磁盘按实际写入增长。设置 256 GB 上限不会立即占满 Mac 存储，但当 Linux 软件和项目文件增加时，Mac 的可用空间也会减少。虚拟磁盘可以扩大，现有磁盘不能缩小。
保存资源设置后，使用 Restart Omarchy 让配置生效。重启前保存 Linux 内的工作，避免编辑器或终端中的未保存内容丢失。
第五步：理解 Omarchy 的桌面操作。
Omarchy 默认以 Immersive 全屏运行。Mac 菜单栏和 Dock 会隐藏，关闭 Immersive 后可以切换为可调整大小的窗口。
Hyprland 会自动安排窗口。打开新应用时，已有窗口会重新布局。用户主要通过键盘切换窗口、工作区和应用，鼠标拖动窗口不再是主要操作方式。
窗口获得焦点时，Mac 的 Command 键会映射为 Linux 侧的 Super 键。部分 macOS 系统快捷键需要在系统设置中允许辅助功能，才能传入 Omarchy。
想让应用启动后直接进入上次的环境，可以在启动器中启用 Skip launcher。以后按住 Option 再启动应用，可以重新打开启动器。
在 Omarchy 中选择 Setup → Try Omarchy Settings。也可以运行 omarchy-native-settings。这两个入口都可以重新打开 Mac 端设置窗口。
第六步：把 Mac 文件和硬件接进 Omarchy。
剪贴板。文字和 PNG 图片支持双向复制。Mac 上复制的内容可以粘贴到 Omarchy，Omarchy 中复制的内容也可以回到 Mac。剪贴板只在发生复制动作时传输内容。
共享文件夹。在启动菜单中找到 Shared folder，点击 Choose…，选择一个 Mac 文件夹。Mac 的 ~/Work 会在 Omarchy 中以同名目录出现。
共享目录具有读写权限。不要选择整个 Home、Library 或包含密钥和系统配置的目录。Linux 软件可以修改共享目录中的文件，重要项目仍应保留独立备份。
摄像头。在启动菜单选择 Camera access → Allow…。Omarchy 会把 FaceTime HD 摄像头显示为 Mac Camera，Linux 应用按普通 V4L2 摄像头使用。
摄像头只有被 Omarchy 应用实际调用时才会开启。拒绝摄像头权限不会阻止整个虚拟机启动。
声音。Mac 音频输入和输出可以在 Omarchy 设置中选择。第一次遇到无声时，先检查 Omarchy 当前输出设备，再检查 macOS 的音频输出设备。
第七步：配置网络和开发服务。
普通上网使用默认的 NAT。Omarchy 通过 Mac 共享网络，适合浏览网页、安装软件和拉取代码。
需要让虚拟机在局域网里获得独立地址时，在 Networking → Configure… 中选择 Bridged。第一次使用 Bridged 可能需要 macOS 批准网络辅助服务，设置通常在下次启动生效。
如果只想从 Mac 访问 Omarchy 中的开发服务，使用 NAT 加 Port forwarding 更简单。端口转发默认绑定到 Mac 的 127.0.0.1，局域网中的其他设备不能直接访问。
Omarchy 访问 Mac 上的服务时，可以使用 10.0.2.2。开发服务器应明确监听地址和端口，不要在没有防火墙判断的情况下把服务暴露到局域网。
第八步：更新、关机和重置。
更新 Mac 端启动器时，先在 Omarchy 中执行关机，再退出 Mac 应用。下载新的 DMG，重新替换 Applications 里的旧应用。这个操作不等于删除虚拟机。
更新 Omarchy 系统时，在 Linux 终端运行 omarchy update，或者使用 Update → Omarchy。Mac 应用更新和 Linux 系统更新需要分别执行。
正常退出使用 Shut Down。如果只是关闭窗口，虚拟机状态和后台资源可能仍需确认。
Factory Reset 会删除保存的虚拟机。确认时需要输入 Try Omarchy。重置前先复制项目、SSH 配置和编辑器配置。
安装前后的限制。
当前移植版本的视频解码走 CPU，高分辨率播放可能较慢；硬件视频解码和 Vulkan 不可用。
窗口跨 HiDPI 边界、输出设备切换、共享文件夹和剪贴板等链路，README 标注为尚未在当前移植版本中重新验证。重要工作应保留 macOS 或云端备份。
SOURCES。
来源：Omarchy 官方网站与手册。
来源：The New Stack 对 Omarchy 的介绍。
来源：37signals 关于迁移 Omarchy 的说明。
来源：Try Omarchy README 与 Release。