核心用法
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）确认完成 |
| 资源耗尽 | 批量创建可能耗尽存储/内存 | 前置检查节点资源容量，设置配额限制 |