# ProxmoxAdmin

**Repository Path**: devop/ProxmoxAdmin

## Basic Information

- **Project Name**: ProxmoxAdmin
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-27
- **Last Updated**: 2026-04-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Proxmox Admin

Proxmox 集群管理平台，支持 Proxmox VE 6/7/8。

## 功能特性

- **多主机管理**：同时管理多个 Proxmox 主机
- **虚拟机管理**：创建、启动、停止、重启、恢复、扩容磁盘
- **存储管理**：查看存储状态、同步存储内容
- **存储文件**：管理 ISO 镜像和备份文件
- **用户权限**：基于 RBAC 的细粒度权限控制
- **操作日志**：完整的操作审计追踪
- **实时通知**：虚拟机操作状态实时推送

## 技术栈

### 后端
- Go 1.21+
- Gin Web 框架
- GORM ORM
- 支持 SQLite/MySQL/PostgreSQL

### 前端
- Vue 3 + TypeScript
- Naive UI
- Vite

## 快速开始

### 环境要求

- Go 1.21+
- Node.js 18+
- MySQL 8.0+ / PostgreSQL 14+ / SQLite

### 后端启动

```bash
cd backend
cp .env.example .env
go mod tidy
go run ./cmd/server
```

默认管理员账号：`admin` / `Admin@123`

### 前端启动

```bash
cd frontend
pnpm install
pnpm dev
```

### Docker 部署

```bash
docker-compose up -d
```

## 界面预览

### 首页
![首页](./screen/首页.png)

### 主机管理
![主机管理](./screen/主机管理.png)

### 虚拟机管理
![虚拟机管理](./screen/虚拟机管理.png)

### 存储管理
![存储管理](./screen/存储管理.png)

### 存储文件
![存储文件](./screen/存储文件.png)

## 项目结构

```
proxmoxadmin/
├── backend/               # Go 后端服务
│   ├── cmd/server/       # 主入口
│   └── internal/
│       ├── handler/      # HTTP 处理器
│       ├── service/      # 业务逻辑层
│       ├── model/        # 数据模型
│       ├── scheduler/    # 定时任务
│       └── ...
├── frontend/             # Vue.js 前端
│   └── src/
│       ├── views/       # 页面组件
│       ├── components/  # 通用组件
│       └── ...
├── screen/              # 界面截图
└── docker-compose.yml   # Docker 部署配置
```

## API 列表

### 认证
- `POST /api/auth/login` - 用户登录
- `GET /api/auth/me` - 获取当前用户信息

### 主机管理
- `GET/POST /api/hosts` - 获取/创建主机
- `PUT/DELETE /api/hosts/:id` - 更新/删除主机
- `POST /api/hosts/:id/refresh` - 刷新主机数据
- `POST /api/hosts/:id/test` - 测试主机连接

### 虚拟机管理
- `GET /api/hosts/:id/vms` - 获取虚拟机列表
- `POST /api/hosts/:id/vms/:vmid/:action` - 虚拟机操作（start/stop/reboot）
- `PUT /api/hosts/:id/vms/:vmid/resize` - 扩容磁盘

### 存储管理
- `GET /api/hosts/:id/storages` - 获取存储列表
- `GET /api/hosts/:id/storages/:storage/content` - 获取存储内容
- `POST /api/hosts/:id/storages/:storage/sync` - 同步存储内容
- `POST /api/hosts/:id/storages/sync-all` - 同步所有存储

### 用户权限
- `GET/POST/PUT/DELETE /api/users` - 用户管理
- `GET/POST/PUT/DELETE /api/roles` - 角色管理
- `GET /api/permissions` - 权限列表

## 注意事项

- Proxmox API 使用 `github.com/luthermonson/go-proxmox`
- 支持为每个主机配置 `insecureSkipVerify=true` 以使用自签名证书
- 删除主机只删除本地数据库记录，不删除 Proxmox 上的实际资源