Stela README

项目的 README,来自 github.com/tylertms/Stela。合并为一个 markdown 文件:README.md。


Stela

A translation-based Apple Silicon layer for x86-64 PCs. It is a UEFI boot program with an arm64-to-x86-64 translator, a Metal driver for NVIDIA GPUs and a model of Apple silicon hardware. Stela currently presents itself as an M2 Mac mini.

[!WARNING] Stela is still in development. It is slow and still may not boot on supported hardware. Fixes are on the way, please submit a GitHub Issue with your boot logs if you encounter an error!

Translator

An ahead-of-time and just-in-time compiler translates arm64e code to x86-64. It covers more than 3,000 AArch64 instruction encodings, maps guest registers to host registers and caches translated code.

NVIDIA driver

The Metal driver compiles AIR, Metal's shader IR, directly to NIR, Mesa's IR, and supports the Metal3 and Apple7 GPU families.

Hardware requirements

Part Requirement
CPU Intel or AMD x86-64-v2 (Intel Nehalem, AMD Bulldozer or newer). AVX2 and AVX-512 are used when present.
Memory 8 GB or more.
Firmware 64-bit UEFI with Secure Boot off.
GPU NVIDIA GeForce GTX 16 or RTX 20, 30, 40 or 50 series.
Disk NVMe, or SATA in AHCI mode. 60 GB or more for macOS: a GPT partition or a whole disk to erase.
USB stick 8 GB for the Online installer, 32 GB for the Offline installer.
Ethernet Intel I225, I226, I210, I211, I350, 82574L, 82575, 82576, 82579, 82580, I217, I218, I219.
Realtek RTL8111, RTL8168, RTL8169, RTL8411, RTL8125, RTL8126, Killer E2600, E3000.
Broadcom BCM5720, BCM5761, BCM5762.
Aquantia AQC100, AQC107, AQC108, AQC109, AQC111, AQC112, AQC113, AQC114, AQC115C, AQC116C.
Qualcomm Atheros AR8131, AR8132, AR8151, AR8152, AR8161, AR8162, AR8171, AR8172, Killer E2200, E2400, E2500.
USB: Realtek RTL8152, RTL8153, RTL8156, ASIX AX88179, AX88178A, AX88772, CDC ECM and NCM.
Wi-Fi None currently supported.
Bluetooth None currently supported.
Audio None currently supported.
USB xHCI (USB 3) and EHCI controllers, hubs, USB disks.
Input USB keyboards and mice. PS/2 keyboards, mice and Synaptics or Elantech touchpads.

Install

  1. Download stela from the releases page.
  2. Run sudo ./stela (Linux, macOS) or double-click stela.exe (Windows).
  3. Choose the USB stick and the installer, then confirm. This erases the USB stick.
  4. Boot the PC from the USB stick.

Update

Download the new stela, plug the USB stick in and run:

sudo ./stela update

On Windows, open Terminal with Run as administrator and run:

.\stela.exe update

Logs

If Stela does not work, plug the USB stick into the computer that made it and save the boot log. Include log.txt in your GitHub Issue.

sudo ./stela log --output log.txt

On Windows, open Terminal with Run as administrator and run:

.\stela.exe log --output log.txt

Build

You need Rust, git, Python 3.10 or newer, and LLVM 21, 22 or 23 with Clang, LLD and libclang. On macOS, Xcode's Apple clang 21 or newer also works.

git clone https://github.com/tylertms/Stela
cd Stela
cargo xtask dist

This writes target/release/stela. The first build fetches and compiles Linux, Mesa and LLVM sources and takes a long time.

Stela contains no Apple software. You are responsible for following Apple's software license agreement and terms of use.

Stela's code is GPL-2.0-or-later. See LICENSE and NOTICE.

Community

Discord Server

Stela (tylertms/Stela)

正在搜索数据库…

这是什么?Stela 是一个通用层,可以让 Apple Silicon 版 macOS 运行在普通的 x86-64 电脑上。安装程序会把一个 UEFI 启动程序写入 U 盘,然后你从这个 U 盘启动电脑。
它是我要安装到系统里的普通应用吗?不是,它是一个可启动的运行环境,而不是普通应用。stela setup 工具会把它写入 U 盘,电脑从该 U 盘启动后,会进入一个 arm64 到 x86-64 的翻译器、一个用于 NVIDIA 显卡的 Metal 驱动,以及一个 Apple 芯片硬件模型。
怎么让它运行起来?从发布页面下载 stela,然后在 Linux 或 macOS 上运行 sudo ./stela setup,或在 Windows 上双击 stela.exe。接着选择 U 盘、macOS 版本和 Mac 机型(目前模拟的是 Mac mini M2,运行 macOS 27),确认后从 U 盘启动电脑。安装程序会清除该 U 盘上的全部数据。
开始之前需要准备什么?一块 x86-64-v2 架构的 CPU(大约 2011 年或更新的型号)、已关闭安全启动(Secure Boot)的 UEFI、8 GB 内存、NVIDIA GTX 16 或 RTX 20 系列及更新的显卡、一个 8 GB 或更大的 U 盘、至少 60 GB 的空 GPT 分区,以及安装期间的网络连接,因为安装过程需要下载 macOS。
现在效果好吗?不太好。README 提醒说,目前能成功启动的可能性很低,macOS 和大多数应用虽然能启动,但运行很慢。主要的硬件支持和修复仍在开发中。
它需要苹果硬件,还是能在普通电脑上运行?它面向普通电脑。翻译器可以在任何 Intel 或 AMD 的 x86-64-v2 CPU 上运行,因此不需要任何苹果硬件。
没有网络还能用吗?安装期间需要联网以下载 macOS。README 没有说明安装完成后是否可以离线使用。
它是免费的吗?包含 macOS 吗?代码采用 GPL-2.0-or-later 许可证,可以免费使用。Stela 不包含任何苹果软件,因此 macOS 会在安装时下载,你需要自行遵守苹果的许可条款。
哪些显卡可以用?README 只列出了 NVIDIA。Metal 驱动支持 GTX 16 和 RTX 20 系列及更新的显卡,会将 Metal 的 AIR 着色器 IR 编译为 Mesa 的 NIR,并支持 Metal3 和 Apple7 GPU 系列。
设置程序会清空我电脑的硬盘吗?设置程序只会清除你所选的那个 U 盘。安装本身需要电脑上有一个至少 60 GB 的空 GPT 分区。
翻译是怎么工作的?提前编译(AOT)与即时编译(JIT)编译器会把 arm64e 代码翻译为 x86-64。它覆盖了 3000 多种 AArch64 指令编码,将客户机寄存器映射到宿主机寄存器,并缓存已翻译的代码。
能用旧版本制作的 U 盘进行更新吗?可以。下载新版 stela,插入 U 盘,然后在 Linux 或 macOS 上运行 sudo ./stela setup update stela,或在 Windows 上运行 stela.exe setup update stela。
作者
tylertms
大小
436 MB
星标
3K
时长
1个月
提交 · 90 天