# proxmox-admin

Скилл для работы с Proxmox VE из терминала: создаёт ВМ через qm, контейнеры через pct, настраивает хранилища и кластеры.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 828 установок · ★ 7
- Автор: github.com/bastos
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/bastos/skills/tree/HEAD/proxmox-admin/SKILL.md
- Обновлён: 2026-08-06
- HTML: https://affpapa.org/nevibecode/skills/proxmox-admin

## Что делает

Скилл описывает администрирование хостов Proxmox VE через CLI. Внутри — справочник по `qm` для KVM-машин и `pct` для LXC-контейнеров, плюс утилиты `pvesm` (хранилища), `pvecm` (кластер), `pveam` (шаблоны), `pvesh` (API из шелла) и `pveperf` (бенчмарк хоста).

Агент подскажет конкретные команды: создать ВМ с нужным числом ядер и памяти, подключить ISO, сделать снапшот, склонировать шаблон, перенести машину на другой узел. Для контейнеров — скачать шаблон, задать статический IP, пробросить каталог хоста через `mp0`, включить вложенность. Есть разделы про cloud-init, PCI passthrough, EFI-загрузку и серийную консоль.

Скилл рассчитан на работу через CLI, а не через веб-интерфейс. Команды меняют конфигурацию хоста и гостей, поэтому запускать их стоит на стенде, а не сразу на боевом кластере.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add bastos/skills --skill proxmox-admin -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/proxmox-admin/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/proxmox-admin/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add bastos/skills --skill proxmox-admin -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/proxmox-admin/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add bastos/skills --skill proxmox-admin -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/proxmox-admin/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install bastos/skills proxmox-admin
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/proxmox-admin/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add bastos/skills --skill proxmox-admin -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/bastos/skills --path proxmox-admin
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/proxmox-admin/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add bastos/skills --skill proxmox-admin -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/bastos/skills/tree/HEAD/proxmox-admin/SKILL.md

## Когда брать
- создать KVM-машину с нужными ядрами, памятью и сетью
- развернуть LXC-контейнер из скачанного шаблона
- сделать снапшот перед обновлением ядра и откатиться при сбое
- подключить NFS или ZFS-хранилище к узлу
- перенести работающую ВМ на другой узел кластера

## Примеры запросов агенту
- Создай ВМ с ID 100, 4 ядрами и 8 ГБ памяти на хранилище local-lvm
- Сделай снапшот контейнера 200 перед обновлением и назови его clean-install
- Покажи конфиг ВМ 100 и добавь второй сетевой интерфейс в bridge vmbr1

## Похожие
- [qemu-kvm](https://affpapa.org/nevibecode/skills/qemu-kvm.md) — скилл · 304 установки
- [ProxmoxMCP-Plus](https://affpapa.org/nevibecode/mcp/proxmoxmcp-plus.md) — MCP-сервер · ★ 615
- [windows-infra-admin](https://affpapa.org/nevibecode/agents/windows-infra-admin.md) — субагент · 221 установка
- [cx-platform-admin](https://affpapa.org/nevibecode/skills/cx-platform-admin.md) — скилл · 3200 установок
- [groove-admin-update](https://affpapa.org/nevibecode/skills/groove-admin-update.md) — скилл · 528 установок
- [gws-admin-reports](https://affpapa.org/nevibecode/skills/gws-admin-reports.md) — скилл · 30700 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md