🦉 SOVA VPN - Структура проекта

впн/
├── 📁 client/              # Клиентская часть VPN
│   ├── vpn_gui.py          # Главный GUI клиент
│   ├── run_tun_vless.py    # Модуль VPN подключения
│   ├── updater.py          # Программа обновления
│   ├── build_all.py        # Скрипт сборки обоих .exe
│   ├── update_version.py   # Генератор version.json
│   ├── SOVA_FINAL.spec     # PyInstaller config для SOVA.exe
│   ├── Updater.spec        # PyInstaller config для Updater.exe
│   ├── TUN/                # sing-box.exe
│   ├── templates/          # HTML шаблоны UI
│   ├── static/             # CSS, JS
│   └── ui_files/           # Обновляемые UI файлы
│
├── 📁 server/              # Серверная часть
│   ├── server.py           # Главный FastAPI сервер
│   ├── database.py         # SQLite база данных
│   ├── build_manager.py    # Автоматическая сборка .exe
│   ├── add_server.py       # Управление VPS серверами
│   ├── manage_ad.py        # Реклама
│   ├── manage_servers.py   # Утилиты серверов
│   ├── data/               # Данные сервера
│   │   ├── version.json    # Версии для обновлений
│   │   ├── vpn.db          # SQLite база
│   │   ├── SOVA.exe        # Клиент для раздачи
│   │   └── configs/        # Конфиги клиентов
│   ├── builds/             # История сборок
│   └── templates/          # HTML админ-панели
│       └── build_manager.html
│
└── 📁 docs/                # Документация
    ├── BUILD_MANAGER_GUIDE.md
    ├── UPDATE_SYSTEM_GUIDE.md
    └── BUILD_DOCUMENTATION.py

🚀 Быстрый старт

Запуск сервера:

cd server
python server.py

Сервер будет доступен:

• API: http://localhost:8080
• Админ-панель сборок: http://localhost:8080/admin/build-manager

Сборка клиента:

cd client
python build_all.py

Результат в client/dist/:

• SOVA.exe (основной клиент)
• Updater.exe (программа обновления)

Автоматическая сборка через админ-панель:

1. Откройте http://localhost:8080/admin/build-manager
2. Проверьте изменения
3. Запустите сборку
4. Готово! Клиенты получат обновление автоматически

📦 Распространение клиентов

Из папок на рабочем столе:

• C:\Users\Ganvas\Desktop\vpn klient\ - для раздачи пользователям
• C:\Users\Ganvas\Desktop\vpn сервер\ - бэкап сервера

🔄 Обновления

Изменение UI (HTML/CSS/JS):

• Редактируйте client/templates/ или client/static/
• Сервер автоматически обновит клиентов (minor patch)

Изменение кода (Python):

• Редактируйте client/vpn_gui.py или run_tun_vless.py
• Запустите сборку через админ-панель
• Сервер раздаст новый SOVA.exe (major version)

📚 Документация

Смотрите папку docs/:

• BUILD_MANAGER_GUIDE.md - Как использовать систему сборки
• UPDATE_SYSTEM_GUIDE.md - Как работают обновления
• BUILD_DOCUMENTATION.py - Техническая документация

🛠️ Разработка

Тестирование клиента:

cd client
python vpn_gui.py

Тестирование сервера:

cd server
python server.py

Проверка изменений:

cd client
python update_version.py

🔐 Важные файлы

• server/data/vpn.db - База данных (бэкапить!)
• server/data/version.json - Версии обновлений
• client/api_key.txt - API ключ для клиентов

💡 Полезные команды

# Просмотр структуры
tree /F /A

# Проверка изменений в клиенте
cd client && python -c "from sys import path; path.insert(0, '../server'); from build_manager import check_for_changes; print(check_for_changes())"

# Статус сборки
curl http://localhost:8080/api/admin/build/status

# Версия для клиентов
curl http://localhost:8080/api/ui/version

---

© 2026 SOVA VPN