open-webui/knowledge-base/tools/proxmox-tools-kybinka.md

Proxmox Tools (Kybinka)

Описание

Инструменты для управления Proxmox VE на сервере Kybinka (192.168.31.2:8006).

Настройки по умолчанию

• Proxmox host: https://192.168.31.2:8006
• Пользователь API: root@pam
• Нода по умолчанию: pve
• Хранилище по умолчанию: local
• Мост по умолчанию: vmbr0
• VMID шаблона: 1000
• Таймаут запросов: 30 секунд

Доступные функции

connection()

Проверка подключения к API Proxmox VE.

Возвращает: OK Proxmox VE X.Y.Z | node: pve | host: https://192.168.31.2:8006 или ERR <описание ошибки>

nodes()

Список всех нод кластера с загрузкой CPU/RAM и аптаймом.

Возвращает: список нод со статусом, CPU, RAM, аптаймом.

node_status(node=None)

Подробный статус ноды: модель CPU, нагрузка, RAM, swap, диск, аптайм, ядро и версия PVE.

Аргументы:

• node — имя ноды (по умолчанию: pve)

cluster()

Статус кластера: кворум и участники.

resources(ftype="")

Список всех ресурсов кластера (ноды, QEMU VM, LXC, хранилища).

Аргументы:

• ftype — фильтр по типу: "node", "qemu", "lxc", "storage" (пусто = все)

storage()

Список всех настроенных хранилищ с типами контента и занятостью.

tasks(limit=10, node=None)

Последние задачи на ноде.

Аргументы:

• limit — максимальное количество задач
• node — имя ноды (по умолчанию: pve)

lxc_list(node=None)

Список LXC-контейнеров на ноде.

lxc_detail(vmid, node=None)

Подробная информация о LXC-контейнере: ОС, CPU, RAM, диск, сеть, использование и аптайм.

Аргументы:

• vmid — числовой ID контейнера
• node — имя ноды (по умолчанию: pve)

lxc_action(vmid, action, node=None)

Управление жизненным циклом LXC.

Аргументы:

• vmid — ID контейнера
• action — одно из: "start", "stop", "shutdown", "restart", "suspend", "resume", "delete"
• node — имя ноды (по умолчанию: pve)

templates(storage=None, node=None)

Список доступных шаблонов LXC в хранилище.

Аргументы:

• storage — имя хранилища (по умолчанию: local)
• node — имя ноды (по умолчанию: pve)

lxc_create(...)

Создание нового LXC-контейнера из шаблона.

Основные аргументы:

• vmid — новый ID (не должен существовать)
• hostname — имя хоста
• ostemplate — ID шаблона, например "local:vztmpl/debian-12-standard_12.7-1_amd64.tar.zst"
• password — пароль root (обязателен если нет sshkey)
• sshkey — публичный SSH-ключ (обязателен если нет password)
• cores — количество ядер (по умолчанию: 1)
• memory — RAM в МБ (по умолчанию: 512)
• disk — размер диска, например "8G" (по умолчанию: "8G")
• ip — IP-адрес или "dhcp" (по умолчанию: "dhcp")
• netmask — префикс маски (по умолчанию: 24)
• gw — шлюз
• start_now — запустить сразу (по умолчанию: true)

vm_list(node=None)

Список QEMU VM на ноде.

vm_detail(vmid, node=None)

Подробный статус VM.

vm_action(vmid, action, node=None)

Управление жизненным циклом VM.

vm_create_from_template(...)

Создание VM клонированием из шаблона (cloud-init).

Основные аргументы:

• vmid — новый ID
• name — имя VM
• template_vmid — VMID шаблона (по умолчанию: 1000)
• full — полный клон (true) или связанный (false)
• memory — RAM в МБ
• cores — ядра CPU
• ciuser — пользователь cloud-init
• cipassword — пароль cloud-init
• sshkeys — SSH-ключи (через новую строку)

vm_create(...)

Создание VM (два режима: клон из шаблона или создание с ISO).

Режим 1 (клонирование):

• template_vmid — VMID шаблона (по умолчанию: 1000)

Режим 2 (ISO):

• template_vmid=0
• iso — ID ISO, например "local:iso/debian-12.iso"
• ostype — тип ОС, например "l26"
• agent — включить QEMU guest agent (1/0)