> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tsukineos.top/llms.txt
> Use this file to discover all available pages before exploring further.

# 安裝 TsukineOS：下載映像檔並啟動

> 取得 TsukineOS 映像檔並啟動（x86_64 ISO / ARM64 IMG）

# 安裝（映像檔啟動）

TsukineOS 當前**沒有圖形安裝程式**，提供的是成品映像檔：x86\_64 使用 `.iso`，ARM64 使用 `.img`。

## 取得映像檔

前往 GitHub Releases 下載最新版（當前 **Infdev-0.2.4**）：

[https://github.com/tsutokiteo/TsukineOS/releases](https://github.com/tsutokiteo/TsukineOS/releases)

| 架構      | 檔案                                 | 用途                  |
| ------- | ---------------------------------- | ------------------- |
| x86\_64 | `tsukineos-infdev0.2.4-x86_64.iso` | 實體機 / QEMU / Ventoy |
| ARM64   | `tsukineos-infdev0.2.4-arm64.img`  | 樹莓派等 ARM 裝置（SD 卡燒錄） |

## x86\_64：三種啟動方式

**1. QEMU（推薦先試，最穩）**

```bash theme={null}
qemu-system-x86_64 -m 2048 \
  -cdrom tsukineos-infdev0.2.4-x86_64.iso -boot d
```

**2. Ventoy 隨身碟**

將 ISO 放入 Ventoy 分割區，開機從 Ventoy 選單選擇該 ISO。

**3. 裸機直裸機直寫（謹慎）**

```bash theme={null}
sudo dd if=tsukineos-infdev0.2.4-x86_64.iso of=/dev/sdX bs=4M status=progress
```

> `sdX` 為目標碟符，寫錯會清空整碟資料。

## ARM64：燒錄 SD 卡

```bash theme={null}
xzcat tsukineos-infdev0.2.4-arm64.img.xz | sudo dd of=/dev/mmcblk0 bs=4M status=progress
```

燒寫完成後插入樹莓派類裝置開機即可。

## 系統需求

| 項目   | 最低              | 建議                 |
| ---- | --------------- | ------------------ |
| CPU  | x86\_64 或 ARM64 | x86\_64            |
| 記憶體  | 512 MB          | 2 GB               |
| 儲存空間 | 足夠存放映像檔         | 16 GB 以上           |
| 其他   | —               | 低延遲音訊裝置（GUI 就緒後使用） |

<Note>
  本頁內容由 AI 翻譯，可能不完全準確。以簡體中文原文為準。
</Note>

***

© 2024-2026 TsutokiTeo/JunweiZhang. All rights reserved.