Update README
This commit is contained in:
94
README.md
94
README.md
@@ -1,94 +1,50 @@
|
|||||||
# Proxmox VM 控制工具
|
# Proxmox VM 控制器
|
||||||
|
|
||||||
一个用于控制 Proxmox 虚拟机的工具集,包含 Python 任务控制器和 Rust GUI 应用程序。
|
一个用于控制 Proxmox 虚拟机的 Rust GUI 应用程序。
|
||||||
|
|
||||||
## 项目结构
|
## 功能
|
||||||
|
|
||||||
- **Python 任务控制器** - `proxmox_task_controller.py` / `proxmox_task_runner.py`
|
- **连接管理** - 配置 Proxmox API 地址、端口、令牌
|
||||||
- 待机监听:持续监控命令目录,平时保持低功耗状态
|
- **节点操作** - 刷新获取节点列表,关闭节点
|
||||||
- 自动启停:按需启动/关闭 Proxmox 虚拟机
|
- **虚拟机列表** - 显示所有虚拟机及运行状态
|
||||||
- 任务执行:通过 SSH 在 VM 内执行命令
|
- **虚拟机控制** - 每台虚拟机独立按钮:启动、停止、重启
|
||||||
|
- **实时日志** - 显示操作日志
|
||||||
|
|
||||||
- **Rust GUI 应用** - `src/` (基于 egui)
|
## 技术栈
|
||||||
- 图形界面:简单易用的 VM 控制面板
|
|
||||||
- API 调用:通过 Proxmox REST API 控制虚拟机
|
|
||||||
- 中文界面:支持中文字体显示
|
|
||||||
|
|
||||||
## 快速开始
|
- **GUI**: egui
|
||||||
|
- **HTTP**: reqwest + rustls-tls
|
||||||
|
- **异步**: tokio
|
||||||
|
- **构建**: MSYS2 MinGW
|
||||||
|
|
||||||
### Rust GUI 应用
|
## 环境要求
|
||||||
|
|
||||||
#### 环境要求
|
|
||||||
|
|
||||||
- Rust 1.70+
|
- Rust 1.70+
|
||||||
- MSYS2 + MinGW (x86_64-pc-windows-gnu)
|
- MSYS2 + MinGW (x86_64-pc-windows-gnu 工具链)
|
||||||
|
|
||||||
#### 编译
|
## 编译
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Debug
|
|
||||||
cargo build --target x86_64-pc-windows-gnu
|
|
||||||
|
|
||||||
# Release
|
|
||||||
cargo build --release --target x86_64-pc-windows-gnu
|
cargo build --release --target x86_64-pc-windows-gnu
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 配置
|
## 配置
|
||||||
|
|
||||||
编辑 `.env` 文件:
|
程序启动后在设置中填写:
|
||||||
|
|
||||||
```
|
| 字段 | 说明 |
|
||||||
PROXMOX_HOST=your-proxmox-host
|
|------|------|
|
||||||
PROXMOX_USER=root@pam
|
| Host | Proxmox 主机地址 |
|
||||||
PROXMOX_TOKEN=your-api-token
|
| 端口 | API 端口 (默认 8006) |
|
||||||
VM_ID=100
|
| 令牌ID | API 令牌 ID |
|
||||||
NODE=proxmox
|
| 密钥 | API 令牌密钥 |
|
||||||
```
|
|
||||||
|
|
||||||
#### 运行
|
## 运行
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
./target/x86_64-pc-windows-gnu/release/proxmox-vm-gui.exe
|
./target/x86_64-pc-windows-gnu/release/proxmox-vm-gui.exe
|
||||||
```
|
```
|
||||||
|
|
||||||
### Python 任务控制器
|
|
||||||
|
|
||||||
#### 环境要求
|
|
||||||
|
|
||||||
- Python 3.8+
|
|
||||||
- Proxmox VE 6.x+
|
|
||||||
|
|
||||||
#### 安装
|
|
||||||
|
|
||||||
```bash
|
|
||||||
pip install -r proxmox_task/requirements.txt
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 配置
|
|
||||||
|
|
||||||
```bash
|
|
||||||
export PROXMOX_HOST="your-proxmox-host"
|
|
||||||
export PROXMOX_USER="root@pam"
|
|
||||||
export PROXMOX_TOKEN="your-api-token"
|
|
||||||
export VM_ID="100"
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 运行
|
|
||||||
|
|
||||||
```bash
|
|
||||||
python3 proxmox_task_controller.py
|
|
||||||
```
|
|
||||||
|
|
||||||
## 配置选项
|
|
||||||
|
|
||||||
| 变量名 | 说明 | 默认值 |
|
|
||||||
|--------|------|--------|
|
|
||||||
| PROXMOX_HOST | Proxmox 主机地址 | localhost |
|
|
||||||
| PROXMOX_USER | API 用户 | root@pam |
|
|
||||||
| PROXMOX_TOKEN | API Token | (必需) |
|
|
||||||
| VM_ID | 虚拟机 ID | 100 |
|
|
||||||
| NODE | 节点名称 | proxmox |
|
|
||||||
|
|
||||||
## 许可证
|
## 许可证
|
||||||
|
|
||||||
MIT License
|
MIT License
|
||||||
Reference in New Issue
Block a user