Download

下载与启动

下载镜像写入 U 盘启动，或在 QEMU 里直接跑，都不用写盘。

—

正在读取版本清单…

Images

可用镜像

Boot media

制作启动 U 盘

镜像是一个完整的磁盘映像（含分区表与引导扇区），需要以「原始映像」方式写入，不能直接复制文件。

警告写入会清空目标 U 盘上的全部数据。请务必确认盘符对应的是 U 盘，而不是你的系统盘。

balenaEtcher（推荐）

跨平台且不易选错盘。选择镜像，选择 U 盘，点 Flash，写入完成后会自动校验一遍。

Rufus（Windows）

设备选择 U 盘，引导类型选择镜像文件，分区类型保持默认，点击「开始」即可。

dd（Linux / macOS）

先确认设备名再执行下方命令。写错设备名会毁掉系统盘，务必核对。

QEMU（不写盘）

最安全的方式。镜像直接当作磁盘挂在虚拟机里，出问题也不会影响真机。

dd 写入示例

# 1) 先看清楚哪块盘是 U 盘（务必确认！）
lsblk

# 2) 卸载已自动挂载的分区
sudo umount /dev/sdX?*

# 3) 以原始映像写入（把 sdX 换成你的 U 盘设备）
sudo dd if=sakura-x86_64.img of=/dev/sdX bs=4M status=progress conv=fsync

# 4) 刷写缓存后拔出
sync

QEMU 直接运行

# 带窗口启动（可交互操作桌面）
qemu-system-x86_64 \
  -drive file=sakura-x86_64.img,format=raw,if=ide \
  -m 256M -vga std -no-reboot

# 无头运行并把串口日志写文件（用于自测）
qemu-system-x86_64 \
  -drive file=sakura-x86_64.img,format=raw,if=ide \
  -m 256M -display none \
  -serial file:gate.log -no-reboot

建议至少 256 MiB 内存。若需要联网测试，追加 -netdev user,id=n0 -device e1000,netdev=n0。

从 U 盘 / 光驱启动

写入完成后重启进入固件设置，把启动顺序里的 USB / 可移动设备提到硬盘之前。系统同时支持 BIOS 与 UEFI 两种引导方式：UEFI 固件会走 \EFI\BOOT\BOOTX64.EFI 路径，传统 BIOS 则读取 MBR 引导扇区，两者最终加载同一份内核。

光驱启动的边界 BIOS 链的 stage2 用固定 ATA 端口（0x1F7）裸读磁盘，无法从光驱引导； UEFI 链走 SimpleFileSystem，可以。因此光盘介质需要 UEFI 固件，且 ISO 需以 UEFI 引导映像形式封装。

From source

从源码构建

仓库里带一个完整的 PowerShell 构建脚本，会编译引导链、内核与用户态程序，最后拼出可直接启动的磁盘镜像。

# 环境：Windows + PowerShell 5.1，以及交叉工具链与 QEMU（见文档页）
git clone https://github.com/ikunshare988/sakura-project.git
cd sakura-project

# 构建：产出 build\disk.img 与内核 ELF
powershell -NoProfile -ExecutionPolicy Bypass -File build.ps1

# 门禁：无头运行并检查串口日志
# 期望结尾包含  Results: 0xdb/0xdb passed, 0 failed
#   以及          [SHELL] desktop ready
qemu-system-x86_64 -drive "file=build\disk.img,format=raw,if=ide" `
  -m 256M -display none -serial file:gate.log -no-reboot

完整的工具链安装、目录结构与常见问题见文档页。