![文章封面](https://developer.qcloudimg.com/http-save/10106350/11fccaacf080e8df7c43af8a82dedf0c.jpg)

我在看 Acelogic/Snapintosh 代码时发现一个有意思的设计：它不改内核二进制，而是在 CPU 特权层之间插入一个伪装层，把骁龙 X2 芯片伪装成 Apple Silicon，骗过 macOS 内核的硬件检查。这个项目让华硕 Zenbook A16 跑起了 macOS 27 桌面，GPU 加速也能工作。它的实现路径是在 ARM EL2 层接管硬件，模拟 Apple 专有的 SPTM、TXM 接口，同时做页表翻译和着色器指令转换。

## EL2 监控器接管了什么

ARM 架构把 CPU 特权分成几个 Exception Level，EL2 通常跑虚拟化监控器。Snapintosh 的 monitor 介于固件代理 q1n1 和运行在 EL1 的 macOS 内核之间，拦截并响应内核发出的平台调用。

macOS 内核启动时会调用只存在于 Apple Silicon 上的底层接口，比如 SPTM 负责内存安全，TXM 负责代码签名校验。普通 ARM 笔记本没有这些接口，内核一启动就会死机。Snapintosh 在 EL2 层伪造这些接口的返回行为，让内核以为仍运行在真正的 Apple 硬件上。

看一段内存页类型转换的代码，来自 compat/sptm.c：

```c
int sptm_mac_apple_retype(uint64_t old_type,uint64_t new_type)
{
    static const uint64_t words[48]={
        [11]=0x8000042ee3f7c802UL,[14]=0x800,[15]=0x800,[16]=0x800,[17]=0x800,
        [18]=0x80800,[19]=0x800,[20]=0x800,[21]=0x800,[24]=0x800,[25]=0x800,
        [32]=0x800,[33]=0x800,[34]=0x800,[35]=0x800000800UL,[37]=0x800,[41]=0x800,
        [42]=0x1802000000000000UL};
    return old_type<48 && new_type<64 && ((words[old_type]>>new_type)&1);
}
```

XNU 内核给每一页标注类型，转换类型前要先问 SPTM 是否允许。这里用位图表示所有合法转换路径，old_type 是行索引，new_type 是列索引，查表取一个比特就知道允许不允许。表里的数字是从真实 Apple 芯片的 SPTM 固件行为逆向推导出来的。没有它，内核做内存保护升级或降级操作时会立刻被拒绝，整个启动流程会在内存初始化阶段卡死。

## 页表翻译解决粒度不匹配

XNU 内核按 16 KiB 为单位管理内存页，但骁龙 X2 的硬件 MMU 只认 4 KiB 页。shadow 目录的代码做页表翻译，把内核的 16 KiB 页映射转换成硬件实际认可的 4 KiB 页表项。

页表遍历器要正确处理内核各种粒度的内存映射请求，再落到硬件认可的 4 KiB 页表项。这一层出错会导致内核访问内存时地址错乱，轻则某个进程崩溃，重则整机死机。

## GPU 指令翻译靠运行时编译器

macOS 图形渲染走 Metal，设备上的显卡是高通 Adreno X2，两者着色器指令集完全不同。项目写了运行时编译器 air2ir3，把 Metal 中间代码 AIR 翻译成 Adreno 能执行的指令。

air2ir3 依赖 Mesa 项目 ir3 后端，ir3 后端是给 Adreno GPU 系列写的开源驱动组件。WindowServer 调用 Metal 画界面时，着色器先被转换成 AIR 中间表示，air2ir3 再把 AIR 转换成 Mesa ir3 后端认识的指令，最后由 ir3 后端生成 Adreno X2 能执行的机器码。

![compare](https://developer.qcloudimg.com/http-save/10106350/9d28f6b32c996003e71b9c442c010dae.png)

gpu/adreno-kext 放了两块代码，kext 子目录是内核扩展 AdrenoX2，plugin 子目录是用户空间加载的 AdrenoMetal.bundle，两者分别负责内核态和用户态的 GPU 操作。

## GPU 参数校验的严格检查

看一段 GPU 初始化时的参数校验，来自 compat/adreno.c：

```c
int adreno_adopt(const struct adreno_ops *o, const struct adreno_params *p,
                 struct adreno_state *s, uint64_t mem_low, uint64_t mem_high)
{
    if (s->quiesce) return ADRENO_E_PARAMS;
    uint64_t end = p->arena_base + p->arena_size, root = p->cb0_ttbr0 & ADRENO_PTE_ADDR;
    const uint64_t in[4][2] = {{p->pool_pa, ADRENO_POOL_BYTES}, {p->ring_pa, p->ring_dwords * 4},
                               {p->fence_pa, 4}, {root, 0x1000}};
    int e = ADRENO_E_PARAMS;
    if ((p->flags & ~(uint64_t)ADRENO_F_ALL) || !(p->flags & ADRENO_F_ENABLE) ||
        (p->gicd & 0xffff) || !p->arena_base || ((p->arena_base | p->arena_size | p->pool_pa) & 0xfff) ||
        end < p->arena_base || (p->arena_base < mem_high && mem_low < end) ||
        (p->fence_pa & 3) || (p->fence_va >> 30) || p->ring_wptr >= p->ring_dwords || p->ring_dwords > 0x2000 ||
        (root >= p->pool_pa && root < p->pool_pa + ADRENO_POOL_BYTES))
        goto out;
```

adreno_adopt 在接手 GPU 控制权之前，确认传入的内存布局参数正确。内存池地址、指令环大小、fence 同步槽地址、页表根地址，每一项都要检查对齐、范围和相互重叠。GPU 操作物理内存地址，一旦某个地址算错或和已有内存区域重叠，轻则渲染花屏，重则写坏内核数据导致系统崩溃。arena 结束地址不能小于起始地址，fence 地址必须 4 字节对齐，ring 队列不能超过 0x2000 大小，页表根地址不能落在内存池区间内。

## 五个模块的分工

![arch](https://developer.qcloudimg.com/http-save/10106350/149293a73ee650c334dbb48ac4fc0727.png)

系统分五个模块：compat、shadow、gpu/adreno-kext、gpu/air2ir3、drivers。

compat 是监控器核心，实现 SPTM/TXM 调用契约、CPU 和中断模拟、设备模型，还要在 GPU 指令环和 SMMU 映射之间做中介，同时提供 NVMe 存储后端支持。

shadow 单独处理页表翻译，页表遍历器要正确处理内核各种粒度的内存映射请求，再落到硬件认可的 4 KiB 页表项。

gpu/adreno-kext 放了两块代码，kext 子目录是内核扩展 AdrenoX2，plugin 子目录是用户空间加载的 AdrenoMetal.bundle，两者分别负责内核态和用户态的 GPU 操作。

gpu/air2ir3 是独立编译器工程，依赖 Mesa 的 ir3 后端完成最终指令生成，靠编译产物对接。

drivers 目录是几个体量较小的 kext，SnapI2CHID 管键盘触控板，snap-qcc2072 管 Wi-Fi 芯片，还有一个启动阶段的帧缓冲驱动。

调用链是固件把机器切到 EL2，q1n1（Asahi Linux m1n1 代理协议的 fork 版本）接管这一层，通过 USB-C 的 NCM 网络协议和 Mac 主机通信。Mac 主机上的 cycle.py 把编译好的监控器镜像传过去，monitor 启动后调用影子页表模块做地址翻译，同时中介 GPU 指令提交，转发给 AdrenoX2 kext，kext 再和用户态的 AdrenoMetal.bundle 配合，后者调用 air2ir3 完成着色器编译。

## 启动流程需要外部设备

![terminal](https://developer.qcloudimg.com/http-save/10106350/3532e105450f7c515faaa64f6a875fed.png)

项目本身不提供可直接运行的二进制，固件和系统镜像需要用户自己准备。README 给出的前置步骤是下载 IPSW 固件包并解包：

```bash
python3 tools/fetch-ipsw.py <url> [destination]
python3 tools/extract-firmware.py <ipsw> j700ap
```

第一条命令从指定链接下载 IPSW 镜像包，第二条命令从 IPSW 里把 j700ap 设备标识对应的固件组件抽取出来，J700 是该机型对应的内部代号。

接下来搭建 GPU 编译器开发环境，air2ir3 依赖 Mesa 的 ir3 后端，需要 Homebrew 安装 LLVM、Meson、Ninja 工具链，再用项目自带的 mesa-setup.sh 拉取并打补丁 Mesa 源码。

完整的开机流程还需要 Mac 主机通过 USB-C 连接 A16 笔记本，由 q1n1 建立 USB NCM 网络链路，再用 tools/cycle.py 把编译好的监控器和 kext 上传到设备。

## 硬件适配范围极窄

硬件适配只支持华硕 Zenbook A16 这一个具体型号，X2E-96-100，寄存器地址和时钟参数都是针对这台机器专门调校的。

功能缺口不小，音频、摄像头、蓝牙、睡眠、外接显示这几项都还没实现，目前只能当一台没有声音也不能休眠的桌面机使用。

交互流畅度没有达到稳定的目标帧率，README 和状态文档都提到桌面能跑、GPU 加速能跑，但流畅度还在打磨阶段。

启动方式依赖外部设备，必须有一台 Mac 主机通过 USB-C 连接才能把监控器和内核传上去，没有独立引导能力。

项目本身不含任何 Apple、高通、华硕的固件和系统镜像，用户需要自己从正规渠道获取 IPSW 文件和设备固件，这一步法律和合规风险需要使用者自己把握。

Snapintosh 是一个技术深度很高但受众很窄的实验项目，需要自备 IPSW 和固件才能跑，功能还有明显缺口，适合对 ARM 架构下的 macOS 兼容性感兴趣的研究者，或者刚好手头有这台特定型号华硕笔记本的人。

---
项目地址：https://github.com/Acelogic/Snapintosh

Snapintosh 通过 ARM EL2 层监控器在华硕 Zenbook A16（骁龙 X2 Elite）上运行未修改的 macOS 内核。

Snapintosh：在骁龙 X2 笔记本上跑 macOS 的 EL2 监控器

编程语言

Snapintosh通过EL2层监控器模拟Apple芯片接口，让华硕ZenbookA16运行macOS桌面，实现GPU加速与页表翻译，但仅支持单一机型，音频、蓝牙等功能缺失，需Mac主机引导。

内存映射

虚拟化

编译器

GitHub

MacOS

4核4G3M云服务器 新用户低至38元/年！

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Snapintosh：在骁龙 X2 笔记本上跑 macOS 的 EL2 监控器-腾讯云开发者社区-腾讯云

Snapintosh：在骁龙 X2 笔记本上跑 macOS 的 EL2 监控器

Snapintosh：在骁龙 X2 笔记本上跑 macOS 的 EL2 监控器

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐