Proxmox全管理

技能简介

通过REST API对Proxmox VE虚拟化平台进行完整管理，覆盖虚拟机与LXC容器的生命周期操作、存储模板管理及集群监控。

业务背景

运维团队可通过统一接口集中管控Proxmox虚拟化集群，无需登录多台节点即可批量操作虚拟机与容器。从创建、克隆到启停维护，全流程自动化减少人工干预；实时掌握集群负载与资源分布，提前规避容量瓶颈，提升基础设施管理效率。

落地案例：某企业需要快速部署20套测试环境，运维人员调用API自动克隆系统模板并分配VMID，批量启动后通过集群状态接口监控各节点CPU内存占用，发现某节点过载时即时迁移实例。日常巡检中一键导出全集群VM清单，结合存储池数据判断扩容时机。

能做什么

• 创建、克隆、启动、停止、重启VM和LXC容器
• 管理快照、备份、存储池及系统模板
• 查看集群状态、节点负载及资源分布
• 批量查询跨节点的全部虚拟化实例

使用说明

安装准备

1. 确保目标环境已安装curl与jq命令行工具
2. 在Proxmox Web界面生成API Token：Datacenter → Permissions → API Tokens → Add（取消勾选Privilege Separation）

配置环境变量

export PVE_URL="https://192.168.1.10:8006"
export PVE_TOKEN="user@pam!tokenid=secret-uuid"

构建认证头

AUTH="Authorization: PVEAPIToken=$PVE_TOKEN"

常用操作示例

查看集群状态：

curl -sk -H "$AUTH" "$PVE_URL/api2/json/cluster/status" | jq

列出某节点所有VM：

curl -sk -H "$AUTH" "$PVE_URL/api2/json/nodes/{node}/qemu" | jq '.data[] | {vmid, name, status}'

启动指定VM：

curl -sk -X POST -H "$AUTH" "$PVE_URL/api2/json/nodes/{node}/qemu/{vmid}/status/start"

创建LXC容器（自动获取新VMID）：

NEWID=$(curl -sk -H "$AUTH" "$PVE_URL/api2/json/cluster/nextid" | jq -r '.data')
curl -sk -X POST -H "$AUTH" "$PVE_URL/api2/json/nodes/{node}/lxc" \
  -d "vmid=$NEWID" \
  -d "hostname=my-container" \
  -d "ostemplate=local:vztmpl/debian-12-standard_12.2-1_amd64.tar.zst" \
  -d "storage=local-lvm" \
  -d "rootfs=local-lvm:8" \
  -d "memory=1024" \
  -d "cores=2" \
  -d "net0=name=eth0,bridge=vmbr0,ip=dhcp" \
  -d "start=1"

克隆VM：

curl -sk -X POST -H "$AUTH" "$PVE_URL/api2/json/nodes/{node}/qemu/{vmid}/clone" \
  -d "newid=201" -d "name=cloned-vm" -d "full=1" -d "storage=local-lvm"

输入与输出

见下方输入与输出表格。

项目	内容
输入	PVE_URL服务器地址、PVE_TOKEN认证令牌、节点名称、VMID/容器ID、创建参数（主机名/模板/存储/资源配置）
输出	集群/节点状态JSON、虚拟化实例清单、操作执行结果、新生成VMID
适用人群	运维工程师、DevOps人员、系统管理员、私有云管理者、需自动化Proxmox操作的技术团队
不包含	图形界面操作、Proxmox安装部署、底层网络设计、物理硬件管理、HA集群详细配置

 

风险提示

• stop操作为强制断电，可能导致数据丢失，生产环境优先使用shutdown
• API Token需妥善保管，避免泄露至代码仓库
• 删除或克隆操作前请确认目标VMID，防止误操作影响运行中业务
• HTTPS证书校验被跳过（-k参数），建议在内网可信环境使用

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/msarheed/proxmox-full/SKILL.md
来源类型：GitHub开源技能库