Archived
68 lines
2.6 KiB
Markdown
68 lines
2.6 KiB
Markdown
# Proxmox VPS Panel Secure
|
|
|
|
Защищённая переработка `Proxmox-VPS-Panel`.
|
|
|
|
## Текущий этап: авторизация
|
|
|
|
Добавлены:
|
|
|
|
- SQLAlchemy-модель `User`;
|
|
- PostgreSQL-сессии;
|
|
- регистрация пользователей;
|
|
- автоматическое назначение роли `admin` первому пользовователю;
|
|
- Argon2id-хеширование паролей;
|
|
- OAuth2 password login;
|
|
- короткоживущий Bearer JWT;
|
|
- endpoint `/auth/me`;
|
|
- проверка активного пользователя;
|
|
- frontend-формы регистрации и входа.
|
|
|
|
API-пути доступны через frontend-прокси:
|
|
|
|
```text
|
|
POST /api/auth/register
|
|
POST /api/auth/login
|
|
GET /api/auth/me
|
|
```
|
|
|
|
## Запуск
|
|
|
|
```bash
|
|
cp .env.example .env
|
|
# задайте SECRET_KEY длиной не менее 32 символов,
|
|
# POSTGRES_PASSWORD, параметры Proxmox и ALLOW_ORIGINS
|
|
docker compose up -d --build
|
|
```
|
|
|
|
Frontend будет доступен на `http://IP-АДРЕС-VM:5173`.
|
|
|
|
## Проверка регистрации через curl
|
|
|
|
```bash
|
|
curl -X POST http://127.0.0.1:5173/api/auth/register \
|
|
-H 'Content-Type: application/json' \
|
|
-d '{"email":"admin@example.local","password":"ChangeMe-Strong-123"}'
|
|
```
|
|
|
|
Проверка входа:
|
|
|
|
```bash
|
|
curl -X POST http://127.0.0.1:5173/api/auth/login \
|
|
-H 'Content-Type: application/x-www-form-urlencoded' \
|
|
-d 'username=admin@example.local&password=ChangeMe-Strong-123'
|
|
```
|
|
|
|
## Следующие этапы
|
|
|
|
1. Перенести модели шаблонов и инстансов.
|
|
2. Добавить Alembic-миграции вместо временного `create_all()`.
|
|
3. Реализовать очередь провижининга и резервирование VMID.
|
|
4. Добавить Proxmox client с ожиданием и повторными попытками задач.
|
|
5. Реализовать административную панель пользователей и шаблонов.
|
|
6. Добавить создание и управление VM/LXC.
|
|
7. Добавить rate limiting, аудит и автоматические тесты.
|
|
|
|
## Безопасность
|
|
|
|
Не используйте `root@pam` для API-токена. Создайте отдельного Proxmox-пользователя с минимальным набором прав. Не публикуйте `.env`, не отключайте TLS-проверку и настройте резервное копирование PostgreSQL.
|