360 Secure SkillHub
360 安全技能中心

Proxmox Management

该 Skill 通过本地 Python 脚本调用 Proxmox VE API：列出集群节点与虚拟机/容器，查看节点硬件健康与资源实时状态，执行电源操作（启动、停止、重启、关机），并管理快照（创建、列出、回滚、删除）。高危操作默认需人工批准，凭据来自环境变量。

robnew
robnew
热度 74.51
最近更新 2026-05-11 15:53:07
分类：自动化依赖：代码执行 / 第三方 API应用场景：DevOps / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add proxmox-skill
Metadata
name
proxmox
description
Manage Proxmox VE nodes, VMs, and containers. Can list hardware stats, resources, control power states (start, stop, reboot, shutdown), and manage snapshots (create, list, rollback, delete).
metadata
{"requires":{"bins":["python3"],"python":["proxmoxer>=2.0.0","requests>=2.0.0"]},"env":["PVE_HOST","PVE_TOKEN_ID","PVE_TOKEN_SECRET"]}

Proxmox Skill

This skill allows the agent to interact with a Proxmox VE cluster to manage virtual machines and containers.

Tools

proxmox_list

List Proxmox nodes or all available VMs and containers across the entire cluster.

  • Command: python3 {{skillDir}}/scripts/proxmox.py {{type}}
  • Args:
    • type: "nodes" or "vms"

proxmox_node_health

Get hardware-level health stats (CPU usage, RAM, Uptime, Version) for a specific physical node.

  • Command: python3 {{skillDir}}/scripts/proxmox.py node_health {{node}}
  • Args:
    • node: The name of the Proxmox host (e.g., "pve" or "hydra")

proxmox_status

Get the real-time status of a specific VM or container.

  • Command: python3 {{skillDir}}/scripts/proxmox.py status {{node}} {{kind}} {{vmid}}
  • Args:
    • node: The Proxmox node name where the resource lives
    • kind: "qemu" for VMs, "lxc" for containers
    • vmid: The numerical ID of the resource (e.g., "100")

proxmox_power_action

Perform power management actions. These actions require human approval by default.

  • Approval: true
  • Command: python3 {{skillDir}}/scripts/proxmox.py {{action}} {{node}} {{kind}} {{vmid}}
  • Args:
    • action: "start", "stop", "reboot", or "shutdown"
    • node: The Proxmox node name
    • kind: "qemu" or "lxc"
    • vmid: The ID of the resource

proxmox_list_snapshots

List all snapshots for a specific VM or container.

  • Command: python3 {{skillDir}}/scripts/proxmox.py list_snapshots {{node}} {{kind}} {{vmid}}
  • Args:
    • node: The Proxmox node name
    • kind: "qemu" or "lxc"
    • vmid: The ID of the resource

proxmox_take_snapshot

Create a new snapshot of a VM or container.

  • Approval: true
  • Command: python3 {{skillDir}}/scripts/proxmox.py take_snapshot {{node}} {{kind}} {{vmid}} {{snapname}} {{description}}
  • Args:
    • node: The Proxmox node name
    • kind: "qemu" or "lxc"
    • vmid: The ID of the resource
    • snapname: Snapshot name (alphanumeric, dashes, underscores; no spaces)
    • description: Optional description of the snapshot

proxmox_rollback_snapshot

Roll a VM or container back to a previously taken snapshot. Destructive — discards changes since the snapshot.

  • Approval: true
  • Command: python3 {{skillDir}}/scripts/proxmox.py rollback_snapshot {{node}} {{kind}} {{vmid}} {{snapname}}
  • Args:
    • node: The Proxmox node name
    • kind: "qemu" or "lxc"
    • vmid: The ID of the resource
    • snapname: Name of the snapshot to roll back to

proxmox_delete_snapshot

Delete a snapshot. Destructive — the snapshot cannot be recovered.

  • Approval: true
  • Command: python3 {{skillDir}}/scripts/proxmox.py delete_snapshot {{node}} {{kind}} {{vmid}} {{snapname}}
  • Args:
    • node: The Proxmox node name
    • kind: "qemu" or "lxc"
    • vmid: The ID of the resource
    • snapname: Name of the snapshot to delete