# proxmox

Справочник по администрированию Proxmox VE, управлению VM и LXC, настройке сетей, кластеров и резервного копирования.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 установка · ★ 7 у репозитория
- Автор: poindexter12
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/poindexter12/waypoint/tree/HEAD/technologies/skills/proxmox/SKILL.md
- Обновлён: 2026-01-20
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/proxmox

## Что делает

Скилл подключает справочную базу по Proxmox VE для работы с виртуальными машинами и контейнерами. Внутри собраны шпаргалки по консольным утилитам `qm`, `pct`, `pvecm`, `pvesh` и `vzdump`, чеклист валидации перед деплоем и готовые таблицы для выбора между VM и LXC.

Помимо базовых команд, архитектура скилла опирается на подключаемые тематические файлы. Они охватывают интеграцию с Terraform и Ansible, развёртывание через cloud-init, настройку мостов и VLAN, запуск Docker и диагностику типовых сбоев. Без установленного доступа к консоли хоста или API Proxmox скилл остаётся справочным руководством: исполнять команды он будет только через доступные агенту средства окружения.

## Требования
- Работает с: Terraform

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install poindexter12/waypoint technologies/skills/proxmox
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

### Claude.ai

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

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

## Когда брать
- подобрать консольные команды для управления VM через qm или контейнерами через pct
- выбрать между виртуальной машиной и LXC под конкретную задачу
- проверить готовность кластера, сети и хранилищ перед деплоем
- настроить команды создания бэкапов vzdump и шаблоны cloud-init

## Примеры запросов агенту
- Как снять блокировку с зависшей виртуальной машины с ID 104 в Proxmox?
- Помоги составить команду vzdump для полного сжатого бэкапа всех виртуалок на диск
- Что лучше выбрать в Proxmox для запуска Docker: LXC или полноценную VM?

## Похожие
- [proxmox-admin](https://affpapa.org/nevibecode/skills/proxmox-admin.md) — скилл · 886 установок
- [mcp-proxmox](https://affpapa.org/nevibecode/mcp/mcp-proxmox.md) — MCP-сервер · ★ 17 у репозитория
- [Proxmox VE](https://affpapa.org/nevibecode/mcp/gethosthewalrus-proxmox-ve.md) — MCP-сервер
- [qemu-kvm](https://affpapa.org/nevibecode/skills/qemu-kvm.md) — скилл · 395 установок
- [Proximo — the Proxmox MCP you can hand the keys](https://affpapa.org/nevibecode/mcp/proximo-the-proxmox-mcp-you-can-hand-the-keys.md) — MCP-сервер · ★ 96 у репозитория
- [Proxmox MCP](https://affpapa.org/nevibecode/mcp/proxmox-mcp.md) — MCP-сервер · ★ 87 у репозитория

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

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