Proxmox

Proxmox VE Management是一款面向虚拟化基础设施管理的API技能，适用于需要自动化管理Proxmox集群的系统管理员和DevOps工程师。

核心用法：技能通过调用Proxmox VE REST API实现对虚拟机、LXC容器及集群资源的管理。支持通过API Token或密码凭证认证，提供集群状态监控、节点管理、VM/容器生命周期控制（启动、停止、重启、关机）、快照创建与回滚、存储与备份管理、任务日志追踪等完整功能。所有操作均可通过curl命令或配套脚本直接执行。

显著优点：
1. 功能全面覆盖——从基础运维到高级备份策略，满足企业级虚拟化管理需求
2. 标准化API接口——基于RESTful设计，易于集成到CI/CD流水线或自动化平台
3. 双认证模式——API Token推荐用于自动化场景，免CSRF验证更安全便捷
4. 无依赖轻量——仅需curl和jq即可操作，无需安装额外客户端工具
5. 异步任务追踪——UPID机制确保长时间操作可监控、可审计

潜在局限：
1. 需手动处理SSL证书——自签名证书需使用-k参数跳过验证，生产环境建议配置可信证书
2. 无内置错误重试——网络异常或节点故障时需调用方实现重试逻辑
3. 权限粒度依赖PVE配置——API Token权限需在Proxmox后台预先配置，技能本身无权限管理能力
4. 仅限已有资源管理——不支持创建新VM或修改硬件配置，聚焦于运维监控场景

适合人群：

• 中小企业IT管理员管理本地虚拟化集群
• 运维工程师构建自动化监控告警体系
• 开发者需要临时启停测试环境的VM实例
• 多云架构中维护私有PVE节点的技术团队

常规风险：
1. 凭证泄露风险——Token明文存储于环境变量或文件，需严格设置文件权限（chmod 600）
2. 误操作导致业务中断——stop为强制断电操作，生产环境建议优先使用shutdown
3. 快照膨胀风险——频繁创建快照未清理可能导致存储空间耗尽
4. 并发操作冲突——同一VM的多人同时操作可能引发状态不一致

核心用法

Proxmox Skill 是一套基于 Bash 的 Proxmox VE 集群管理解决方案，通过标准 REST API 与 Proxmox 服务器交互。用户需预先配置 API Token（推荐）或用户名密码认证，支持通过环境变量或 ~/.proxmox-credentials 文件存储凭据。

主要功能覆盖：

• 集群与节点管理：查看集群状态、节点资源使用率（CPU/内存）
• 虚拟机/容器生命周期：启动、停止、重启、优雅关机
• 快照管理：创建、回滚、删除快照，支持变更前备份场景
• 存储与备份：查看存储使用率、执行 vzdump 备份任务
• 任务追踪：异步任务 UPID 跟踪与日志检索

使用方法上，既可直接使用 curl 命令配合 jq 处理 JSON 响应，也可调用封装的 scripts/pve.sh 辅助脚本简化操作。

显著优点

1. 零外部依赖：仅依赖系统内置工具 curl 和 jq，供应链攻击面极小
2. 清晰的权限边界：无硬编码凭据，强制用户显式配置 API Token，遵循最小权限原则
3. 完整的操作覆盖：涵盖日常运维高频场景（VM 启停、快照、备份、监控）
4. 轻量高效：纯脚本实现，启动开销极低，适合自动化运维 pipeline

潜在缺点与局限性

1. SSL 验证默认关闭：使用 curl -k 跳过证书验证，虽文档说明用于自签名证书场景，但存在中间人攻击风险
2. 无输入校验：vmid、node 等参数未做格式验证，错误输入可能导致意外行为
3. 无超时重试机制：curl 调用未设置 --connect-timeout，网络异常时可能长时间挂起
4. T3 可信度来源：由个人/社区维护，无企业级 SLA 保障
5. 功能范围受限：不支持创建/删除 VM、网络配置修改等高级操作

适合人群

• 家庭实验室（Homelab）用户管理自建虚拟化平台
• 中小型企业 IT 运维人员执行常规 VM 运维任务
• DevOps 工程师集成至 CI/CD pipeline 进行环境部署
• 熟悉命令行的技术用户，而非需要图形界面的初学者

常规风险

• 认证泄露风险：API Token 存储于明文环境变量或文件，需确保 ~/.proxmox-credentials 权限为 600
• 误操作风险：批量停止/重启 VM 可能影响生产业务，建议配合快照使用
• API 版本兼容性：未明确支持 Proxmox VE 版本范围，升级后可能需要调整
• 异步任务状态：备份等操作为异步执行，需主动查询 UPID 确认完成状态