Proxmox VPS Panel Secure

Защищённая переработка Proxmox-VPS-Panel.

Реализовано

• регистрация и OAuth2 password login;
• Argon2id-хеширование паролей;
• короткоживущий Bearer JWT;
• модели User, Template и Instance;
• строгая валидация ресурсов шаблонов;
• CRUD шаблонов для администратора;
• список инстансов с проверкой ownership;
• Proxmox client через API-токен;
• создание VM из cloud-init-шаблона;
• создание LXC из CT-шаблона;
• настройка DHCP, CPU, RAM и диска;
• frontend-кабинет шаблонов и инстансов.

Текущий API

POST   /api/auth/register
POST   /api/auth/login
GET    /api/auth/me
GET    /api/templates
POST   /api/templates
DELETE /api/templates/{template_id}
GET    /api/instances
POST   /api/instances
GET    /api/admin/ping

Настройка Proxmox

В .env укажите:

PVE_HOST=https://192.168.31.4:8006
PVE_NODE=pve1
PVE_TOKEN_NAME=panel@pve!panel
PVE_TOKEN_VALUE=...
PVE_VERIFY_SSL=true
PVE_VM_STORAGE=SSD
PVE_LXC_STORAGE=SSD
PVE_BRIDGE=vmbr0

Для VM-шаблона укажите source_vmid. Для LXC — полный source_template, например:

local:vztmpl/debian-12-standard.tar.zst

Создание VPS

curl -X POST https://cloud.rummail.ru/api/instances \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "name":"test-vm",
    "template_id":1,
    "username":"paneluser",
    "password":"ChangeMe-Strong-123"
  }'

Операция сейчас синхронная и может занимать несколько минут. Пароль возвращается только в ответе создания и не сохраняется в БД.

Обновление VM

cd ~/Proxmox-VPS-Panel-secure
git pull origin main
docker compose up -d --build
docker compose ps
docker compose logs --tail=100 backend

Следующие этапы

1. Добавить очередь провижининга и резервирование VMID.
2. Добавить UI формы создания VPS с одноразовым отображением пароля.
3. Добавить получение IP через QEMU Guest Agent и LXC interfaces.
4. Добавить start/stop/shutdown/reboot/delete.
5. Добавить Alembic-миграции вместо временного create_all().
6. Добавить rate limiting, аудит и тесты.

Безопасность

Не используйте root@pam для API-токена. Создайте отдельного Proxmox-пользователя с минимальным набором прав. Не публикуйте .env, не отключайте TLS-проверку и настройте резервное копирование PostgreSQL.