（2114期）proxmox-full – Proxmox 虚拟化全栈管控专家

Proxmox 虚拟化全栈管控专家 基于 Proxmox 官方 REST API 的完整虚拟化基础设施管理工具，支持 VM/LXC 全生命周期管理、快照备份与存储运维，为运维人员提供命令行级高效管控能力。 使用说明 核心用法 proxmox-full 是一个面向 Proxmox VE 虚拟化平台的完整管理 Skill，通过标准 REST API 实现对虚拟机（VM）和 LXC 容器的全生命周期管理。用户需配置 PVEURL 和 PVETOKEN 环境变量完成认证，即可执行从基础监控到复杂编排的各类操作。 该 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 端点或参数行为，需关注官方变更日志并测试验证。 原始说明 Complete Proxmox VE management - create/clone/start/stop VMs and LXC containers, manage snapshots, backups, storage, and templates. Use when user wants to manage Proxmox infrastructure, virtual machines, or containers.