Multi-Server Subscription Manager

Единая control-plane панель для multi-node инфраструктуры: управление узлами, клиентами, подписками и эксплуатацией — в одном интерфейсе.

---

Почему это удобно

multiserversubgen создан для сценария, где серверов и клиентов уже много, а хаоса должно быть мало.

Вы получаете:

• централизованное управление несколькими узлами;
• операции с inbound/client (включая batch-подход);
• мониторинг статуса и health-сигналов;
• backup/restore без ручного «танца с бубном»;
• production-ориентированный install/update pipeline.

Что внутри 🚀

Область	Возможности
Node management	Добавление/удаление узлов, контроль доступности
Inbounds & Clients	Управление, фильтрация, batch-операции
Traffic & Analytics	Статистика трафика и operational срезы
Backup / Restore	Экспорт/импорт данных, базовые recovery-сценарии
Ops-ready runtime	systemd, nginx, subpath-деплой, health-check

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

1) Установка

git clone https://github.com/Efidripy/multiserversubgen
cd multiserversubgen
chmod +x install.sh
sudo ./install.sh

Что настраивается автоматически:

• backend (FastAPI + venv);
• frontend-сборка (Vite) с публикацией в backend/build;
• systemd-сервис sub-manager;
• nginx-маршрутизация для subpath;
• базовые security/ops элементы профиля.

2) Проверка работоспособности

systemctl is-active sub-manager
curl -s -o /dev/null -w 'health=%{http_code}\n' http://127.0.0.1:666/health

Публичная проверка панели:

curl -k -s -o /dev/null -w 'panel=%{http_code}\n' https://<your-domain>/<web-path>/

3) Обновление

cd multiserversubgen
git pull
sudo ./update.sh

Перед обновлением рекомендуется сделать backup через API.

Архитектура (на пальцах)

flowchart LR
	U[Operator / Admin] --> W[Web UI\nReact + Vite]
	W --> A[API\nFastAPI]
	A --> N1[Node #1]
	A --> N2[Node #2]
	A --> N3[Node #N]
	A --> B[(Backups)]
	A --> M[Metrics / Ops Signals]
	NG[Nginx + Subpath] --> W

Loading

Ключевые директории:

• backend/ — API и сервисная логика;
• frontend/ — интерфейс управления;
• scripts/installer/ — пресеты и installer-flow;
• monitoring/, nginx/, systemd/ — инфраструктурный слой.

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

Стартовая база

• Установка
• Обновление
• Эксплуатация (Ops)
• API (входная точка)

Глубже

• Полная API-документация
• Гайд по компонентам
• Гайд по подпискам
• Статус улучшений

Практичные заметки для production

• Минимум: Ubuntu 20.04+ (рекомендуется 24.04), root, домен/поддомен.
• Аутентификация: Basic Auth (рекомендуется HTTPS и ограничения в nginx).
• Для subpath-сценария фронтенд должен быть собран с корректным VITE_BASE.

Лицензия

Проект распространяется по лицензии MIT.