SuperAPI AI 工具集

proxmox

通用与其它

查看项目

更新于 10-16 08:05

技能介绍

用途:借助 Proxmox VE 的 REST API 对集群进行日常管理,适合脚本化或由 AI 助手代为执行运维操作。

主要能力:查看集群与节点状态、列出节点上的 QEMU 虚拟机和 LXC 容器、对 VM/容器执行启动、停止、优雅关机、重启;查看与创建、回滚、删除快照;查看最近任务及任务日志;列出存储及存储内容;列出备份并启动 vzdump 备份。

使用方式:先配置认证信息,支持环境变量或 ~/.proxmox-credentials 文件,推荐使用 API Token: export PROXMOX_HOST="https://192.168.1.100:8006" export PROXMOX_TOKEN_ID="user@pam!tokenname" export PROXMOX_TOKEN_SECRET="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" 也可使用凭据文件,创建后建议执行 chmod 600 ~/.proxmox-credentials。API Token 在 Proxmox 界面通过 Datacenter → Permissions → API Tokens → Add 创建。之后用 curl 携带请求头 Authorization: PVEAPIToken=$PROXMOX_TOKEN_ID=$PROXMOX_TOKEN_SECRET 调用接口,例如列出节点: curl -ks -H "$AUTH" "$PROXMOX_HOST/api2/json/nodes" | jq 启动 VM:curl -ks -X POST -H "$AUTH" "$PROXMOX_HOST/api2/json/nodes/{node}/qemu/{vmid}/status/start"。LXC 操作将路径中的 /qemu/ 换成 /lxc/。仓库还提供辅助脚本 scripts/pve.sh,可执行 status、vms、start {vmid}、stop {vmid} 等命令。

限制与注意事项:需替换 {node}、{vmid}、{storage}、{snapname} 为实际值;API Token 执行 POST/PUT/DELETE 无需 CSRF token;自签名证书可用 -k 跳过 SSL 校验;任务类操作会返回 UPID 用于跟踪异步作业。其余平台、计费或效果信息暂未提供。