themartiano/try-omarchy · 上手攻略

  • 仓库：themartiano/try-omarchy
  • 链接：https://github.com/themartiano/try-omarchy
  • 分类：macOS 虚拟化 · Apple Silicon · Linux 桌面
  • 作者：Tom
  • 更新：2026-08-28

是什么

Try Omarchy 是一个 macOS 原生应用，让你在 Apple Silicon Mac 上零配置运行 Omarchy（Basecamp 出的项目管理工具）——不是网页版，是完整的桌面虚拟机构建。

它把三样东西打包成一个 .dmg 安装包：

  1. 一个针对 Apple Silicon 优化构建的 ARM64 Arch Linux 镜像，内置 Omarchy Quattro
  2. 一个基于 QEMU + Apple Hypervisor Framework（HVF）的运行时，享受硬件加速和 VirGL 图形
  3. 一个 Swift/AppKit 的 macOS 启动器，带原生窗口界面

通俗理解：它相当于一个"虚拟机安装包"，你不需要懂 QEMU、不需要手动装 Linux，双击拖到 Applications 就能跑一个完整桌面 Linux 环境，Omarchy 就在里面。

⚠️ Omarchy 本身是 Basecamp 的商业项目，Try Omarchy 是第三方打包，与 Basecamp 无附属关系。

解决什么问题

Omarchy（Basecamp 的下一代项目管理桌面客户端）目前只能通过特定方式运行，对于不想折腾虚拟机、Linux 命令行、QEMU 参数的普通 Mac 用户来说，门槛很高。

Try Omarchy 把这个门槛降到了"安装一个 macOS App"的程度：硬件加速的图形、分辨率自适应、HiDPI 支持、剪贴板互通、文件夹共享——这些在传统 QEMU 方案里都需要手动配置。

典型痛点： - 想用 Omarchy 桌面版但不知道如何在 Mac 上跑 Linux 虚拟机 - 手动配置 QEMU + virglrenderer 参数复杂，容易出错 - 需要 macOS/Linux 双系统之间顺畅复制粘贴文件

快速安装

方式一：直接下载（推荐普通用户）

  1. 打开 Releases 页面
  2. 下载最新的 .dmg（已签名 + 已公证）
  3. 打开 DMG，把 Try Omarchy 拖到 Applications
  4. 从 Applications 启动

要求： Apple Silicon Mac（arm64）+ macOS 15 或更新 + 至少 8 GB 可用空间

首次启动需要较长时间（准备 Linux 环境 + Omarchy 账号初始化），后续启动会快很多。

方式二：开发构建（面向贡献者）

需要：Xcode command-line tools + Swift 6、Homebrew、Python 3、Docker（支持 privileged linux/arm64 容器）、以及以下依赖：

brew install zstd pkg-config glib pixman libslirp sdl2

验证环境：

make doctor          # 基础预检
make runtime         # 检查 libslirp/SDL2 版本是否符合合约

完整构建并运行：

make build run       # 首次构建下载大量资源，需要等待
make run             # 后续快速启动

运行测试套件：

make test

清理构建产物（保留持久 VM）：

make clean           # 清理 repo 构建产物 + 缓存
make clean-all       # 深度清理，包括用户持久 VM 数据

核心用法

基础操作

启动后默认进入开始菜单，从这里：

  • 开启辅助功能：启用 Mac Command 键映射到虚拟机 Super 键（Mac 键盘直接用 Linux 快捷键）
  • 麦克风权限：可选授权
  • 共享文件夹：可选指定一个 Mac 文件夹映射到 Linux 虚拟机内的同名路径（如 ~/Work）

剪贴板共享

登录后自动生效： - Mac 侧复制的文本和 PNG 图片 → Omarchy 剪贴板 - Omarchy 侧复制的内容 → Mac 剪贴板 - 懒加载：只有真正执行复制操作时才传输数据

文件夹共享

首次启动后，在开始菜单点击 Choose… 选择共享文件夹： - Mac 上的 ~/Work 在虚拟机内也是 ~/Work - 完全读写权限 - 不能共享整个 home 目录、~/Library 或系统目录 - 选择"Turn Off"会保留配置但暂停共享

MCP 命令速查

开发者关心的命令（来自 Makefile）：

命令 说明
make build run 完整构建并启动
make run 仅启动（跳过已构建部分）
make test 运行完整合约测试
make clean 清理构建产物（保留 VM）
make clean-all 深度清理（含用户 VM 数据）
make package 构建 + 签名 + 公证 + 生成 DMG
make release 正式发布构建

典型适用场景

  1. Omarchy 桌面体验：想用 Basecamp Omarchy 桌面版但只用 Mac 的用户——最直接的路径
  2. Apple Silicon Linux 开发：需要在 ARM Mac 上跑完整 Linux 桌面环境进行测试
  3. 跨平台开发：在 Mac 上开发 Linux 原生应用，需要原汁原味的 Linux 环境
  4. 硬件加速渲染：需要 GPU 加速（VirGL）的 Linux 桌面虚拟化，且要求比传统 QEMU 更简单

坑与注意

  1. 视频解码是 CPU 软解：README 明确说明高分辨率视频播放性能较差，改进方案在开发中。如需流畅视频播放，当前不是最佳选择。

  2. macOS 15+ 强制要求：不支持旧版 macOS，老系统用户需要升级或换方案。

  3. 首次启动慢：首次启动需要准备 Linux 镜像并初始化账号，这是正常的，不是卡死。

  4. 预 1.0 软件：作者标注了 pre-1.0, under active development，可能会有 breaking changes，更新前注意看 CHANGELOG。

  5. Arm64 only：不支持 Intel Mac（x86_64），只支持 Apple Silicon。

  6. 共享文件夹权限：共享的文件夹需要有 Linux 软件修改的权限，不要拿系统关键目录共享。

  7. 多账号共享局限：共享文件夹属于创建虚拟机账号的第一个账号，访客账号只有常规 Unix 权限位控制。

与同类对比

方案 难度 硬件加速 macOS 集成 适用平台
Try Omarchy ★☆☆☆☆（DMG 直装） ✅ VirGL ✅ 原生窗口/HiDPI/剪贴板 Apple Silicon
手动 QEMU + HVF ★★★★★ ✅ virglrenderer ❌ 需要手动配置 Apple Silicon
UTM ★★☆☆☆（有 GUI） ✅（需配置） ❌ 窗口管理手动 Apple Silicon + Intel
Parallels/VMware Fusion ★★☆☆☆ ✅ ✅ 仅 Intel
Docker + X11 Forwarding ★★★☆☆ ❌ ❌ 全部

结论： Try Omarchy 在 Apple Silicon 上是目前门槛最低的完整 Linux 桌面方案，比 UTM 更"开箱即用"，但专用于 Omarchy 桌面场景。如果需要通用 Linux 虚拟机，UTM 是更成熟的选择。

一句话推荐结论

Apple Silicon Mac 用户想体验 Omarchy 桌面版，或需要一个免配置的硬件加速 Linux 虚拟机，Try Omarchy 是目前最简单直接的途径——双击安装，无需任何命令行配置。