Proxmox集群管理

技能简介

通过REST API连接Proxmox VE集群，执行虚拟机与LXC容器的生命周期管理、节点监控、快照操作及任务追踪。

能做什么

• 查看集群状态与节点资源使用情况
• 列出、启动、停止、重启VM和LXC容器
• 创建、回滚、删除虚拟机快照
• 查看存储使用情况及备份内容
• 发起备份任务并追踪异步操作日志

使用说明

1. 安装依赖

# 需安装curl与jq
sudo apt-get install curl jq

2. 配置认证信息

# 方式一：环境变量
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"

# 方式二：凭证文件
cat > ~/.proxmox-credentials << 'EOF'
PROXMOX_HOST=https://192.168.1.100:8006
PROXMOX_TOKEN_ID=user@pam!monitoring
PROXMOX_TOKEN_SECRET=your-token-secret
EOF
chmod 600 ~/.proxmox-credentials

3. 生成API令牌

登录Proxmox Web界面：数据中心 → 权限 → API令牌 → 添加

4. 加载并使用

source ~/.proxmox-credentials 2>/dev/null
AUTH="Authorization: PVEAPIToken=$PROXMOX_TOKEN_ID=$PROXMOX_TOKEN_SECRET"

# 示例：查看集群状态
curl -ks -H "$AUTH" "$PROXMOX_HOST/api2/json/cluster/status" | jq

输入与输出

见下方输入与输出表格。

风险提示

• API令牌拥有配置的全部权限，需妥善保管凭证文件
• 生产环境建议使用HTTPS证书而非跳过SSL验证
• 停止/关机操作可能导致运行中服务中断
• 快照回滚会丢失该快照之后的数据变更
• 备份任务占用存储I/O，高峰期执行可能影响性能

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/weird-aftertaste/proxmox/SKILL.md
来源类型：GitHub仓库