github地址 github.com/niezhicheng... 





markdown
# 🚀 开源推荐 | pve-ui:基于 Django + Vue3 的 PVE 集群管理系统
> 还在为管理多个 PVE 服务器而烦恼?还在用命令行操作虚拟机?今天推荐一个开源的 PVE 集群管理系统,让你通过 Web 界面轻松管理所有 PVE 资源!
## 📖 项目背景
Proxmox VE (PVE) 是一个功能强大的开源虚拟化平台,但在实际使用中,我们经常会遇到以下问题:
- 需要管理多个 PVE 服务器,每个都要单独登录 Web 界面
- 命令行操作复杂,容易出错
- 缺乏统一的资源监控和任务管理
- 网络拓扑设计需要手动记录和维护
为了解决这些问题,我开发了 **pve-ui** ------ 一个统一的 PVE 集群管理系统。
## ✨ 项目简介
**pve-ui** 是一个基于 Django REST Framework 和 Vue 3 的现代化 PVE 集群管理系统,提供统一的 Web 界面来管理多个 PVE 服务器,支持虚拟机的全生命周期操作、资源监控、网络拓扑编排等功能。
### 核心特性
#### 🖧 PVE 集群管理
- **多服务器统一管理**:在一个界面管理多套 PVE 服务器,支持 API Token 配置、SSL 校验
- **虚拟机全生命周期**:创建、克隆、备份、快照、同步、任务日志等一站式操作
- **实时监控**:节点资源监控、存储内容查看、全局任务管理
- **网络拓扑编排**:基于 LogicFlow 的拖拽式拓扑设计器,可视化设计网络结构
#### 🔐 权限管理
- **RBAC 权限控制**:基于角色的访问控制,支持菜单、按钮级别权限
- **数据权限隔离**:支持组织级数据隔离,多租户场景友好
## 🛠️ 技术栈
### 后端
- **Django 5.2.7** + **Django REST Framework** - 强大的 Web 框架和 RESTful API
- **djangorestframework-simplejwt** - JWT 认证,无状态 API
- **APScheduler** - 定时任务调度
- **Channels** - WebSocket 支持,实时通信
### 前端
- **Vue 3** + **Vite** - 现代化前端框架和构建工具
- **Arco Design** - 字节跳动出品的 UI 组件库
- **LogicFlow** - 流程图/拓扑图编辑器
- **ECharts** - 数据可视化
- **noVNC** - 浏览器 VNC 客户端
## 📸 功能展示
### 1. PVE 服务器管理

统一管理多个 PVE 服务器,配置 API Token 和连接信息。
### 2. 节点监控

实时查看节点资源使用情况,包括 CPU、内存、存储等。
### 3. 虚拟机管理

完整的虚拟机生命周期管理,支持创建、克隆、备份、快照等操作。
### 4. 存储管理

查看和管理存储内容,包括模板、ISO 镜像等。
### 5. 网络拓扑编排

基于 LogicFlow 的可视化网络拓扑设计器,拖拽式操作,支持保存和加载。
### 6. 任务管理

查看和管理 PVE 任务,实时监控任务执行状态。
## 🚀 快速开始
### 环境要求
- Python 3.12+
- Node.js 22+
- MySQL 8.0+ (可选,默认使用 SQLite)
### 后端启动
```bash
# 克隆项目
git clone <repository-url>
cd pve-ui/backend
# 创建虚拟环境
python -m venv venv
source venv/bin/activate # Linux/Mac
# 或 venv\Scripts\activate # Windows
# 安装依赖
pip install -r requirements.txt
# 数据库迁移
python manage.py migrate
# 初始化 RBAC 数据
python manage.py init_rbac --create-superuser
# 启动服务
python manage.py runserver
```
后端服务将在 `http://127.0.0.1:8000` 启动
### 前端启动
```bash
cd front-end
# 安装依赖
npm install
# 启动开发服务器
npm run dev
```
前端服务将在 `http://localhost:5173` 启动
### 默认账号
- **用户名**: `admin`
- **密码**: `admin123`
### Docker 一键部署
```bash
# 构建并启动所有服务
docker-compose up -d
# 查看日志
docker-compose logs -f
```
访问地址:
- **前端**: http://localhost
- **后端 API**: http://localhost:8000
## 💡 项目亮点
### 1. 统一的集群管理
不再需要为每个 PVE 服务器单独登录,一个界面管理所有资源。
### 2. 可视化操作
告别复杂的命令行,所有操作都通过 Web 界面完成,简单直观。
### 3. 网络拓扑编排
基于 LogicFlow 的可视化拓扑设计器,让网络规划变得简单有趣。
### 4. 实时监控
实时查看节点资源、任务状态,及时发现问题。
### 5. 完善的权限体系
RBAC 权限控制,支持多租户场景,数据安全隔离。
### 6. 现代化技术栈
采用最新的 Django 5.2 和 Vue 3,性能优异,开发体验好。
## 🎯 适用场景
- **多 PVE 服务器管理**:统一管理多个 PVE 集群
- **团队协作**:通过权限管理,不同角色访问不同资源
- **资源监控**:实时监控集群资源使用情况
- **网络规划**:可视化设计网络拓扑结构
- **运维自动化**:通过 API 集成到现有运维体系
## 📦 项目结构
```
pve-ui/
├── backend/ # Django 后端
│ ├── apps/
│ │ ├── pve/ # PVE 管理核心模块
│ │ ├── rbac/ # 权限管理模块
│ │ └── ...
│ └── django_vue_adminx/
├── front-end/ # Vue 3 前端
│ ├── src/
│ │ ├── views/pve/ # PVE 管理页面
│ │ └── ...
│ └── ...
└── docker-compose.yml # Docker 部署配置
```
## 🔗 相关链接
- **GitHub**: [项目地址](https://github.com/your-repo/pve-ui)
- **文档**: [详细文档](./README.md)
- **Docker 部署**: [DOCKER.md](./DOCKER.md)
## 🤝 贡献
欢迎提交 Issue 和 Pull Request!
如果你觉得这个项目对你有帮助,请给个 ⭐ Star 支持一下!
## 📝 总结
pve-ui 是一个功能完善的 PVE 集群管理系统,解决了多服务器管理、可视化操作、网络拓扑编排等实际问题。采用现代化的技术栈,代码结构清晰,易于扩展和维护。
如果你也在使用 PVE,或者对虚拟化集群管理感兴趣,不妨试试这个项目。相信它会给你带来更好的管理体验!
---
**作者**: 小聂
**联系方式**: wx: rz1433 | qq: 1433711899
**⭐ 如果这个项目对你有帮助,请给个 Star!**