# vmboxy-pc

**Repository Path**: scicat-team/vmboxy-pc

## Basic Information

- **Project Name**: vmboxy-pc
- **Description**: VMBoxy是一个跨平台的QEMU虚拟机启动配置生成工具，帮助用户快速创建复杂的QEMU启动命令。通过交互式菜单界面，用户可以轻松配置虚拟机的各项参数，包括硬件规格、存储设备、网络设置等，工具会自动生成完整的QEMU命令。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-23
- **Last Updated**: 2025-07-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# VMBoxy - QEMU虚拟机管理器

VMBoxy是一个现代化的QEMU虚拟机图形化管理工具，专为不熟悉命令行的用户设计，同时提供高级配置选项满足专业用户需求。

## 🌟 功能特性

### 基础功能
- **直观的图形界面**: 基于tkinter的现代化界面设计
- **多架构支持**: 支持x86_64、arm64、arm32、arm_m_profile、arm_r_profile等架构
- **智能路径检测**: 自动检测QEMU可执行文件路径
- **虚拟机管理**: 创建、编辑、删除虚拟机配置
- **磁盘管理**: 支持创建和管理虚拟磁盘镜像

### 高级配置
- **CPU高级配置**: 
  - 支持自定义CPU显示名称（model_id）
  - 完整的CPU特性配置（family、model、stepping等）
  - CPU拓扑配置（核心数、线程数、插槽数）
- **内存配置**: 支持内存大小和型号配置
- **网络配置**: 端口转发、MAC地址生成
- **存储配置**: 多种磁盘接口和缓存模式
- **GPU直通**: 支持GPU设备直通配置
- **BIOS配置**: 自定义BIOS和OVMF支持

### 实验性功能
- **调试模式**: GDB服务器支持
- **性能优化**: TCG线程模式配置
- **SMBIOS配置**: 硬件信息模拟
- **音频配置**: 高级音频驱动和格式设置

## 🚀 快速开始

### 系统要求
- Windows 10/11 或 Linux/macOS
- Python 3.7+
- QEMU (建议安装最新版本)

### 安装步骤

#### Windows
1. 下载并安装QEMU：
   ```
   访问 https://qemu.weilnetz.de/w64/ 下载Windows版本
   安装到 C:\qemu 目录
   ```

2. 克隆项目：
   ```bash
   git clone https://github.com/your-repo/vmboxy.git
   cd vmboxy
   ```

3. 运行程序：
   ```bash
   python vmboxy-dev.py  # 开发版（最新功能）
   # 或
   python vmboxy-stable.py  # 稳定版
   ```

#### Linux/macOS
1. 安装QEMU：
   ```bash
   # Ubuntu/Debian
   sudo apt install qemu-system-x86 qemu-utils
   
   # CentOS/RHEL
   sudo yum install qemu-kvm qemu-img
   
   # macOS
   brew install qemu
   ```

2. 克隆并运行：
   ```bash
   git clone https://github.com/your-repo/vmboxy.git
   cd vmboxy
   python3 vmboxy-dev.py
   ```

## 📖 使用指南

### 创建虚拟机
1. **选择架构**: 在"基本配置"中选择目标架构（x86_64、arm64等）
2. **选择机器类型**: 根据架构选择合适的机器类型
3. **配置CPU**: 
   - 基础模式：直接选择CPU型号
   - 高级模式：启用"高级CPU配置"进行详细设置
4. **设置内存**: 配置虚拟机内存大小
5. **添加存储**: 
   - 创建新磁盘或选择现有磁盘
   - 加载ISO镜像用于安装操作系统
6. **网络配置**: 设置网络模式和端口转发
7. **启动虚拟机**: 点击"启动虚拟机"按钮

### 高级CPU配置示例

#### 自定义CPU显示名称
按照B站教程配置CPU显示名称：

1. 启用"高级CPU配置"
2. 在"CPU显示名称"字段输入：
   ```
   12th Gen Intel(R) Core(TM) i9-12900KS @ 5.50GHz
   ```
3. 配置其他CPU参数：
   - CPU Family: 6
   - CPU Model: 151 (十进制)
   - CPU Stepping: 2
   - CPU Vendor: GenuineIntel

生成的QEMU命令示例：
```bash
qemu-system-x86_64 -M q35 -m 4096 -cpu Cascadelake-Server-v5,family=6,model=151,stepping=2,model_id='12th Gen Intel(R) Core(TM) i9-12900KS @ 5.50GHz' -hda disk.qcow2
```

### 支持的架构和机器类型

#### x86_64架构
- **机器类型**: pc, q35, pc-q35-*系列
- **CPU类型**: qemu64, kvm64, host, SandyBridge, Haswell, Skylake-Client, Cascadelake-Server等

#### ARM64架构
- **机器类型**: virt, raspi3, raspi4
- **CPU类型**: cortex-a53, cortex-a57, cortex-a72, max

#### ARM32架构
- **机器类型**: versatilepb, vexpress-a9
- **CPU类型**: arm1176, cortex-a9, cortex-a15

## 🛠️ 开发说明

### 项目结构
```
vmboxy/
├── vmboxy-dev.py      # 开发版本（包含最新功能）
├── vmboxy-stable.py   # 稳定版本
├── README.md          # 项目文档
└── 架构相关文档/
    ├── x86和x64的-machine列表.txt
    ├── arm64和arm32的-machine列表.txt
    └── arm64和arm32的cpu列表.txt
```

### 技术栈
- **GUI框架**: tkinter (Python标准库)
- **虚拟化**: QEMU/KVM
- **语言**: Python 3.7+
- **依赖**: 纯Python实现，无额外依赖

### 开发环境设置
```bash
# 克隆项目
git clone https://github.com/your-repo/vmboxy.git
cd vmboxy

# 创建虚拟环境（可选）
python -m venv venv
source venv/bin/activate  # Linux/macOS
# 或
venv\Scripts\activate     # Windows

# 运行测试
python vmboxy-dev.py
```

## 📝 常见问题

### Q: 如何选择正确的QEMU路径？
A: VMBoxy会自动检测QEMU安装路径。如果未找到，可以手动指定：
- Windows: `C:\qemu\qemu-system-x86_64.exe`
- Linux: `/usr/bin/qemu-system-x86_64`
- macOS: `/opt/homebrew/bin/qemu-system-x86_64`

### Q: 支持哪些磁盘格式？
A: 支持qcow2、raw、vdi、vmdk等常见格式，推荐使用qcow2。

### Q: 如何配置GPU直通？
A: 在"高级配置"中启用GPU直通，配置GPU设备路径（如Linux下的`vfio-pci,host=01:00.0`）。

### Q: 网络连接失败怎么办？
A: 检查：
1. 网络模式选择是否正确（用户模式通常最简单）
2. 端口转发配置是否有冲突
3. 防火墙设置

## 🤝 贡献

欢迎提交Issue和Pull Request！

### 贡献指南
1. Fork项目
2. 创建功能分支
3. 提交更改
4. 创建Pull Request

## 📄 许可证

本项目采用MIT许可证，详见[LICENSE](LICENSE)文件。

## 🔗 相关链接

- [QEMU官方文档](https://qemu.readthedocs.io/)
- [KVM文档](https://www.linux-kvm.org/page/Main_Page)
- [B站VMBoxy教程](https://b23.tv/OYzZXXy)  

## 📞 联系

如有问题或建议，请通过以下方式联系：
- Gitee Issues
- 邮箱: 3671745081@qq.com
- B站私信: scicat科技猫

---

**VMBoxy - 让虚拟机管理变得简单！**