Archived
93 lines
3.0 KiB
Markdown
93 lines
3.0 KiB
Markdown
# 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
|
||
|
||
```text
|
||
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` укажите:
|
||
|
||
```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`, например:
|
||
|
||
```text
|
||
local:vztmpl/debian-12-standard.tar.zst
|
||
```
|
||
|
||
## Создание VPS
|
||
|
||
```bash
|
||
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
|
||
|
||
```bash
|
||
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.
|