@false00/pi-proxmox
面向生产的Proxmox VE自动化管理工具
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:@false00/pi-proxmox。 它的用途是:面向生产的Proxmox VE自动化管理工具 完整的 Skill 内容见:https://321skill.com/skills/false00-pi-proxmox/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“使用pi-proxmox技能,在集群节点‘pve01’上创建一个2核4G内存、使用‘local-lvm’存储的Ubuntu 22.04虚拟机,并命名为‘ci-runner-01’。”,它会调用相应的API,自动完成虚拟机的创建和基础配置。你还可以接着说:“为这个虚拟机配置一个每周日的自动备份任务到‘nas-backup’存储。”,它便能进一步设置备份策略。
介绍
这个Skill为Pi编码智能体提供了一套专注于生产环境的Proxmox VE自动化工具。它旨在解决在Proxmox虚拟化平台上进行批量、重复性手动操作效率低下的问题,通过封装REST API,实现对虚拟机、容器、存储、集群、防火墙、备份、高可用和复制等核心功能的自动化编排与管理。
使用方式非常简单,智能体通过调用该Skill提供的函数,即可用代码指令替代在Proxmox Web界面中的点击操作。例如,你可以编写脚本来批量创建或配置虚拟机,自动设置备份策略,或者管理集群节点。它本质上是一个API客户端库,将复杂的HTTP请求封装成了更易用的编程接口。
它非常适合需要在Proxmox VE环境中进行自动化运维、持续集成/持续部署(CI/CD)流水线搭建、或需要频繁进行资源调配的DevOps工程师、系统管理员和基础设施开发者。对于希望将基础设施即代码(IaC)实践应用到Proxmox平台的团队来说,这是一个得力助手。
在使用建议上,请确保你已具备Proxmox VE的基础知识,并拥有足够的API权限(如API令牌)。由于专注于生产环境,建议先在测试环境中充分验证你的自动化脚本。注意,该工具依赖于Proxmox官方的API,其功能和限制与API本身保持一致。
核心特点
与同类Proxmox管理工具或通用HTTP请求Skill相比,它专为Pi编码智能体深度定制,提供了更高层级的、面向生产场景的原子操作封装,如直接处理HA、复制和备份等复杂工作流,而非仅仅发送原始API请求。
注意事项
不适合对Proxmox VE没有基础认知,或仅需进行简单、零星界面操作的用户。
常见问题
这个Skill需要Proxmox的什么权限?
需要创建具有相应操作权限(如VM.Allocate, Sys.Audit等)的API令牌。
它能管理Proxmox集群吗?
可以,支持集群节点、资源池和高可用(HA)等集群功能的自动化管理。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/false00-pi-proxmox/raw/index.md 读取 @false00/pi-proxmox 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/false00-pi-proxmox/raw/index.md(查看排版版本)