proxmox-full

核心用法

proxmox-full 是一个面向 Proxmox VE 虚拟化平台的完整管理 Skill，通过标准 REST API 实现对虚拟机（VM）和 LXC 容器的全生命周期管理。用户需配置 PVE_URL 和 PVE_TOKEN 环境变量完成认证，即可执行从基础监控到复杂编排的各类操作。

该 Skill 覆盖六大核心场景：集群与节点状态监控、VM/LXC 的创建与克隆、电源状态控制（启动/停止/重启/关机）、快照与备份管理、模板与存储运维、以及任务追踪与资源清理。所有操作均通过 curl 调用 Proxmox API 实现，返回 JSON 数据经 jq 解析后呈现结构化结果。

典型工作流包括：获取集群资源概览 → 创建或克隆虚拟机 → 配置存储与网络 → 执行快照备份 → 监控任务状态 → 按需回滚或恢复。Skill 提供了详尽的参数表格和快速参考索引，降低了 API 学习成本。

显著优点

功能完整性：覆盖 Proxmox VE 90% 以上的日常管理需求，从简单的状态查询到复杂的跨节点迁移均有对应命令，无需频繁切换 Web 界面或 SSH 登录节点。

标准化接口：直接对接 Proxmox 原生 REST API，无中间层抽象，确保功能与官方版本同步，避免第三方工具常见的兼容性问题。

自动化友好：纯命令行设计便于集成到 CI/CD 流水线、Ansible Playbook 或 Shell 脚本中，支持通过 UPID 追踪异步任务状态，适合批量运维场景。

安全认证机制：采用 API Token 而非密码认证，支持 Proxmox 的 RBAC 权限体系，可实现最小权限原则的配置。

潜在缺点与局限性

证书验证妥协：默认使用 -k 参数跳过 SSL 证书验证，虽便利测试环境，但存在中间人攻击风险，生产环境需手动移除。

无交互式确认：删除 VM、回滚快照等高危操作直接执行，无二次确认机制，误操作可能导致不可逆的数据丢失。

错误处理简陋：依赖 curl 和 jq 的退出状态，缺乏统一的错误码解析和重试逻辑，网络波动时可能返回不友好的原始错误信息。

模板依赖本地资源：创建 LXC 需预先下载模板至节点存储，Skill 未内置模板自动获取逻辑，新环境首次使用需手动准备。

无并发控制：大量并行操作可能触发 Proxmox 任务队列拥塞，Skill 本身不提供速率限制或队列管理功能。

适合的目标群体

• 系统运维工程师：需要批量管理数十至数百台 VM/容器的中大型基础设施团队
• DevOps 工程师：将虚拟化资源编排集成到自动化部署流程中
• Homelab 爱好者：通过命令行高效管理个人虚拟化环境
• 云服务提供商：基于 Proxmox 构建 VPS 或私有云平台的运营团队
• 技术教育者：用于虚拟化技术教学与实验环境快速搭建

使用风险

权限扩散风险：API Token 若配置不当（如未启用 Privilege Separation），可能获得超出预期的集群管理权限，建议严格遵循最小权限原则。

数据丢失风险：stop 为强制断电，，delete 配合 purge 参数会永久清除磁盘数据，生产环境执行前务必确认 VMID 与节点名称。

网络依赖风险：所有操作依赖与 Proxmox API 的持续连通，网络中断可能导致任务状态丢失或重复执行。

版本兼容性风险：Proxmox 大版本升级可能调整 API 端点或参数行为，需关注官方变更日志并测试验证。