From e348dbc075908a9e0085254abb6e3abaf312741d Mon Sep 17 00:00:00 2001 From: xiaji Date: Fri, 24 Apr 2026 07:12:40 +0800 Subject: [PATCH] Update README --- README.md | 94 +++++++++++++++---------------------------------------- 1 file changed, 25 insertions(+), 69 deletions(-) diff --git a/README.md b/README.md index 3e167ef..c7eb93c 100644 --- a/README.md +++ b/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 虚拟机 - - 任务执行:通过 SSH 在 VM 内执行命令 - -- **Rust GUI 应用** - `src/` (基于 egui) - - 图形界面:简单易用的 VM 控制面板 - - API 调用:通过 Proxmox REST API 控制虚拟机 - - 中文界面:支持中文字体显示 +- **连接管理** - 配置 Proxmox API 地址、端口、令牌 +- **节点操作** - 刷新获取节点列表,关闭节点 +- **虚拟机列表** - 显示所有虚拟机及运行状态 +- **虚拟机控制** - 每台虚拟机独立按钮:启动、停止、重启 +- **实时日志** - 显示操作日志 -## 快速开始 +## 技术栈 -### Rust GUI 应用 +- **GUI**: egui +- **HTTP**: reqwest + rustls-tls +- **异步**: tokio +- **构建**: MSYS2 MinGW -#### 环境要求 +## 环境要求 - Rust 1.70+ -- MSYS2 + MinGW (x86_64-pc-windows-gnu) +- MSYS2 + MinGW (x86_64-pc-windows-gnu 工具链) -#### 编译 +## 编译 ```bash -# Debug -cargo build --target x86_64-pc-windows-gnu - -# Release cargo build --release --target x86_64-pc-windows-gnu ``` -#### 配置 +## 配置 -编辑 `.env` 文件: +程序启动后在设置中填写: -``` -PROXMOX_HOST=your-proxmox-host -PROXMOX_USER=root@pam -PROXMOX_TOKEN=your-api-token -VM_ID=100 -NODE=proxmox -``` +| 字段 | 说明 | +|------|------| +| Host | Proxmox 主机地址 | +| 端口 | API 端口 (默认 8006) | +| 令牌ID | API 令牌 ID | +| 密钥 | API 令牌密钥 | -#### 运行 +## 运行 ```bash ./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 \ No newline at end of file