https://github.com/steve372a/sanaka

Sanaka 虚拟机管理器仓库
https://github.com/steve372a/sanaka

electron kvm linux macos qemu qemu-kvm virt virtual-machine windows

Last synced: 4 days ago
JSON representation

Sanaka 虚拟机管理器仓库

• Host: GitHub
• URL: https://github.com/steve372a/sanaka
• Owner: steve372a
• License: gpl-2.0
• Created: 2026-06-04T14:57:56.000Z (9 days ago)
• Default Branch: main
• Last Pushed: 2026-06-05T06:04:25.000Z (8 days ago)
• Last Synced: 2026-06-05T07:21:34.698Z (8 days ago)
• Topics: electron, kvm, linux, macos, qemu, qemu-kvm, virt, virtual-machine, windows
• Language: TypeScript
• Homepage:
• Size: 3.26 MB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Notice: NOTICE
  • Agents: AGENTS.md

Awesome Lists containing this project

README

          




# Sanaka

精致 QEMU 虚拟机管理软件前端

![License: MIT](https://img.shields.io/badge/License-GPL2-yellow.svg)

[![Platform](https://img.shields.io/badge/OS-macOS%2FWindows%2FLinux-blue)](https://github.com/steve372a/pier)

[![Version](https://img.shields.io/badge/version-0.0.2(beta)-brightgreen)]()

[![Stars](https://img.shields.io/github/stars/steve372a/sanaka?style=social)]()





## 💗特点

| 超级跨平台！ | 统一界面 | 内置显示器 | 支持增强工具 |

| --- | --- | --- | --- |

| 支持 macOS/Linux/Windows | 通过 Electron 实现界面统一 | 内置 noVNC 并突破声音传输限制 | 只需安装Sanaka增强功能包，就能支持双方剪贴板共享 |

## 支持系统

| macOS | Windows | Linux |

| --- | --- | --- |

| 至少 macOS 15 Sequoia | 至少 Windows 10 | 建议 QEMU 版本 >= 8.2.0 |

## 🚀 快速上手

前往 [Releases](https://github.com/steve372a/sanaka/releases) 下载最新版适合您系统的包。

**Linux 版本需要安装以下依赖：**

```

sudo apt install qemu-system qemu-utils ovmf qemu-block-extra

```

## 共享剪贴板

Sanaka 支持剪贴板共享功能，不需要 SPICE、GTK 等特定限制，只需安装 Sanaka 增强功能包，就能支持双方剪贴板共享。

支持 Windows XP 及以上、主流 Linux 发行版的剪贴板共享，开箱即用。

![](./assets/pictures/clipboard-linux.png)

**在那遥远的蓝色天国，只有遍地旷野，无限自由，无视一切尘埃。花朵开满山野，天空寄托着远方孩子的思念，光芒照耀世间万物之一切。**

**—— Sanakaprix Sanaka 共享剪贴板寄语**

**剪贴板让我们相连结，相互传递爱与希望，相互感受未来天空。**

## 📦 源码构建

参见 [从零开始的构建指南](./docs/guides/从零开始的构建指南.md)

我为您提供了快速工具！

您可以在本地快速上手：

```

git clone https://github.com/steve372a/sanaka.git

cd sanaka

bash start.sh

```







**从源码打包全流程（macOS）：**

* 创建一个目录

* 输入 `git clone https://github.com/steve372a/sanaka.git` 

* `cd sanaka`进入目录，然后输入`bash start.sh`：

![](./assets/pictures/startsh-macos.png)

* 选择第一步，Sanaka 将为你自动配置好 Sanaka 需要的环境，包括 npm install 等。

## 📚 文档入口

- [从零开始的构建指南](./docs/guides/从零开始的构建指南.md)

- [给人的构建方法](./docs/guides/给人的构建方法.md)

- [感想](./docs/journal/感想.md)

## 🩺 环境修复

建议你直接运行：

```bash

bash scripts/doctor.sh

```

它会测速多个 npm / Electron 镜像，确认后帮你切换，并自动尝试修复依赖与构建问题。

## Sanaka 的内部...







这是 **Sanaka SVM/SAKA 格式的机器包**：点击后，Sanaka就会立刻配置好虚拟机。