Proxmox Full

核心用法

proxmox-full 提供对 Proxmox VE 企业级虚拟化平台的完整 API 控制能力，涵盖 VM（QEMU/KVM）与 LXC 容器的全生命周期管理。核心操作包括：

• 基础设施监控：获取集群状态、节点资源利用率、存储容量等关键指标
• 虚拟机/容器管理：创建、克隆、启动、停止、重启、删除 VM 和 LXC
• 模板与镜像：下载系统模板、管理 ISO 镜像、将现有实例转换为可复用模板
• 快照与备份：创建时间点快照、执行 vzdump 备份、从归档恢复实例
• 任务追踪：异步任务状态查询与日志获取

认证采用 API Token 机制（PVEAPIToken），需配置 PVE_URL 与 PVE_TOKEN 环境变量，支持 HTTPS 自签名证书（-k 参数）。

显著优点

1. 功能覆盖全面：单一技能覆盖 Proxmox 90%+ 常用运维场景，无需多工具切换
2. 声明式操作：基于标准 REST API，便于集成到 CI/CD 与 IaC 工作流
3. 轻量依赖：仅需 curl + jq，无额外 SDK 或复杂客户端安装
4. 灵活参数支持：完整暴露 CPU、内存、磁盘、网络等细粒度配置选项
5. 集群感知：支持跨节点资源查询与迁移操作

潜在局限

• 无图形交互：纯命令行/脚本驱动，不适合需要可视化确认的场景
• 错误处理原始：依赖 HTTP 状态码与 JSON 解析，需自行实现重试与异常处理
• 权限管理复杂：Token 权限范围由 Proxmox RBAC 控制，误配可能导致操作失败或安全风险
• 无内置幂等性：重复执行创建/克隆可能产生重复资源，需外部状态管理

适合人群

• DevOps/系统管理员：自动化批量部署与日常运维
• Homelab 爱好者：远程管理家庭服务器虚拟化环境
• 云计算开发者：构建基于 Proxmox 的私有云平台

常规风险

| 风险类型 | 说明 | 缓解建议 |

|---------|------|---------|

| 误操作删除 | `DELETE` 请求直接移除资源，无二次确认 | 生产环境启用 Proxmox 回收站或外部备份策略 |

| 凭证泄露 | `PVE_TOKEN` 包含完整认证信息 | 使用最小权限 Token，避免硬编码，优先采用密钥管理系统 |

| 网络中断 | API 调用中途失败可能导致状态不一致 | 重要操作后查询任务状态（UPID）确认完成 |

| 资源耗尽 | 批量创建可能耗尽存储/内存 | 前置检查节点资源容量，设置配额限制 |

核心用法

本 Skill 提供完整的 Proxmox VE 虚拟化平台管理能力，基于 REST API 通过 curl 命令实现基础设施即代码。核心功能覆盖四大维度：

资源生命周期管理：创建/克隆/启动/停止/删除 VM 和 LXC 容器，支持全克隆与链接克隆模式，一键转换为模板实现标准化部署。创建 VM 时可精细配置 CPU、内存、磁盘、网络、启动顺序等参数；LXC 容器则支持特权/非特权模式、SSH 公钥注入等特性。

数据保护与恢复：完整的快照管理（创建、回滚、删除）支持秒级状态保存；集成 vzdump 备份引擎，支持快照模式备份与 ZSTD 压缩；备份文件可直接还原至指定存储，满足灾难恢复需求。

集群与存储管理：获取集群状态、节点资源使用率；枚举存储池容量与可用模板（LXC 模板、ISO 镜像）；通过 cluster/nextid 自动分配 VMID 避免冲突。

任务追踪与调试：所有异步操作返回 UPID，可实时查询任务状态与完整日志输出，便于自动化流水线集成。

显著优点

• 零依赖轻量：纯文档型 Skill，无需安装额外工具，直接复用系统 curl/jq
• API 全覆盖：涵盖 Proxmox VE 核心 API 端点，从日常运维到灾难恢复场景一应俱全
• 参数化配置：通过环境变量 PVE_URL + PVE_TOKEN 实现多环境切换，避免配置硬编码
• 安全认证友好：支持 API Token 认证（无需 CSRF），兼容自签名证书（-k 模式）
• 模板化部署：支持 VM/LXC 转模板 + 克隆链路，实现基础设施标准化与快速扩缩容

潜在缺点与局限性

• 无状态验证：Skill 本身不验证 API 连通性或参数合法性，错误依赖 Proxmox 返回信息
• 手动 URL 替换：示例使用占位符 {node}/{vmid}，需人工替换，增加操作摩擦
• 网络暴露风险：API Token 拥有 Datacenter 级别权限时，误操作可能影响整个集群
• 无回滚保护：删除、强制停止等破坏性操作无二次确认机制，依赖用户审慎操作
• IP 硬编码提示：文档示例包含 192.168.1.10，新手可能直接复制导致连接失败

适合人群

• 系统管理员：负责 Proxmox VE 集群日常运维、资源调度、故障恢复
• DevOps 工程师：构建 CI/CD 流水线，实现测试环境的自动化创建与销毁
• Homelab 爱好者：家庭实验室虚拟化环境的批量管理与模板化部署
• 云迁移从业者：基于 Proxmox 的私有云/混合云场景下的基础设施编排

常规风险

1. 权限滥用：API Token 若配置过高权限（如 root@pam），泄露后可导致整个集群被控
2. 网络传输安全：示例使用 -k 跳过证书验证，生产环境应配置可信 CA 或严格校验证书
3. 资源冲突：并发创建 VM 时若未正确获取 nextid，可能导致 VMID 冲突
4. 数据丢失：stop 操作强制断电可能损坏文件系统；delete?purge=1 不可恢复
5. Token 泄露：环境变量 PVE_TOKEN 可能被进程列表（ps e）或容器镜像层泄露