oneamendez/crate-ios
运维与部署在 iPhone 和 iPad 上本地运行完整 Linux 桌面虚拟机,适合愿意自签安装并开启 JIT 的用户。
项目介绍
crate 是一个 iOS 应用,把完整的 arm64 Linux 发行版作为虚拟机跑在 iPhone 或 iPad 上,不依赖远程桌面或云端虚拟机。客户机系统由独立的 crate 引擎 执行,这是一个用 Rust 从零编写的 arm64 到 arm64 翻译器。
应用内置目录可安装 Ubuntu 26.04 LTS(GNOME)、Debian 13 或 Arch Linux ARM(KDE Plasma 或 Xfce),安装时创建自己的账户。桌面通过 virglrenderer、ANGLE 和 MoltenVK 使用 iPhone 的 GPU 加速;触摸被当作平板输入,屏幕键盘上方有 Esc、Ctrl、Super、Tab、功能键和方向键。iPad 可接鼠标或触控板,外接显示器可作为虚拟机的屏幕。
快速使用
crate 依赖 JIT,因此无法从 App Store 分发。入口是从 Releases 下载未签名 IPA,再用自己的 Apple 账户签名并从 Mac 安装。签名与安装步骤见 INSTALL.md,其中还提供了一段可交给 Claude Code 执行的提示词。
启动应用后,在设置里通过 StikDebug 或内置 StikJIT 开启 JIT,具体流程见 JIT 一节。随后进入 Install Vms 标签页,选择发行版镜像和内存上限,并填写要在虚拟机内创建的账户。安装会下载并校验镜像、解包磁盘并扩展到 32 GB,过程中需保持应用在前台。完成后虚拟机出现在 Home 页,点击 Start 即可启动到桌面。
从源码构建
构建前需要先获取固定版本的框架,再生成工程:
./Scripts/fetch-frameworks.sh
./Scripts/fetch-stikjit.sh
./Scripts/fetch-crate.sh
xcodegen generate
open Crate.xcodeproj
模拟器构建使用 xcodebuild 和 Crate scheme,目标为 iOS Simulator。模拟器中没有可供 JIT 使用的代码区域,启动虚拟机时会改为模拟显示和终端,不会真正执行客户机。
使用约束
- 必须通过 StikDebug 或 StikJIT 开启 JIT;IPA 未签名,需要用个人证书和描述文件签名,并包含
get-task-allow。 - 虚拟机镜像由 arm64-desktop-images 的工作流构建并出具证明;内核和 initrd 从磁盘外部引导,因此客户机无法自行更新内核。
- 已知问题包括 Xfce 壁纸不随屏幕尺寸变化,以及 GNOME 接外接显示器时可能需要手动设置分辨率,详见 Known issues。
- crate 自身代码采用 MPL-2.0;StikJIT、idevice、SwiftTerm、libslirp、GLib、MoltenVK、ANGLE、libepoxy 和 virglrenderer 等随附组件保留各自许可证,清单见 THIRD_PARTY_NOTICES.md。
HotRepo 点评
crate-ios 创建于 2026 年 11 月,11 月 16 日进入 HotRepo 新项目榜,记录为 361 颗星,报告在约 24 小时窗口内净增 206 颗星。该窗口内的小时采样从 101 颗升至 361 颗,没有全语言日榜名次记录。仓库给出了较具体的实现说明:独立的 Rust 引擎、固定版本的第三方框架、带证明的虚拟机镜像和安装流程,这与只做目录介绍的项目有明显区别。对读者来说,真正的门槛在于侧载安装和 JIT 配置,而不是虚拟机功能本身。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。