核心用法
proxmox-ops 是一套面向运维场景的 Proxmox VE 管理工具，通过 REST API 实现对虚拟机（QEMU/KVM）和 LXC 容器的全面管控。核心依赖 curl 和 jq，通过 API Token 认证，提供读取集群状态、启停容器、管理快照、调整磁盘、查询任务日志等全生命周期操作。
主要工作流包括：加载 ~/.proxmox-credentials 凭据文件 → 判定操作风险等级（只读/可逆/破坏性）→ 执行 API 调用 → 用 jq 解析 JSON → 跟踪异步任务 UPID。配套 pve.sh 辅助脚本实现节点自动发现，简化 VMID 到节点的映射。
显著优点
- 操作分级安全：明确区分只读（status/list）、可逆（start/stop/snapshot）、破坏性（delete/resize/rollback）三类操作，破坏性操作强制用户确认
- 凭据管理规范：API Token 存储于
~/.proxmox-credentials，强制 600 权限，不输出到日志 - 快照安全提示：明确警告
vmstate=1会导致 I/O 风暴，默认使用磁盘快照保护节点性能 - 扩容流程完整：API 扩容后提供 guest 内文件系统调整步骤（parted/pvresize/resize2fs/xfs_growfs）
- Guest Agent 集成：支持通过 qemu-guest-agent 动态获取 IP，避免硬编码
潜在缺点与局限性
- TLS 验证关闭：使用
-k跳过自签名证书验证，存在中间人攻击风险 - Token 权限集中：需关闭 Privilege Separation 获得完整权限，细粒度 RBAC 支持有限
- 无内置并发控制：高频操作可能触发 Proxmox 任务队列拥塞
- 磁盘扩容限制：仅支持绝对尺寸（20G），不支持相对增量（+10G），需外部计算目标大小
- 依赖外部脚本：
pve.sh为 shell 脚本，跨平台兼容性依赖 bash 环境
适合人群
- 中小型私有云运维工程师
- DevOps/SRE 负责 Proxmox 集群日常管理
- 需要自动化 VM 生命周期的工作流开发者
- 有一定 Linux/Shell 基础，熟悉 REST API 的技术用户
常规风险
- 凭据泄露：
~/.proxmox-credentials若权限设置不当或备份未排除，可导致集群完全失陷 - 误删数据：破坏性操作（delete/rollback）无二次确认机制，依赖用户层面确认
- I/O 性能冲击：误用
vmstate=1快照会冻结 VM 并产生大量写入，影响同节点其他业务 - 网络隔离失效：若 Proxmox 管理网络与业务网络未隔离，API 暴露面扩大攻击风险
- 磁盘扩容失败：guest 内未执行文件系统扩容步骤，导致实际空间未扩展