feat: PCA Phobos — web panel for obfuscated WireGuard VPN

Flask web panel for Phobos (wg-obfuscator + WireGuard): - Active sessions monitoring (wg show) - Client management (add/remove via phobos-client.sh) - Labels by Real IP - Subscription expiry with auto-kick - Telegram notifications (connect/disconnect/expiry) - One-command installer - Dark theme UI Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-09-21 12:01:56 +00:00 · 2026-05-28 23:06:08 +03:00
commit e11451b984
4 changed files with 935 additions and 0 deletions
--- a/README.md
+++ b/README.md
@@ -0,0 +1,125 @@
+# PCA Phobos — Web Panel
+
+Веб-панель управления для [Phobos](https://git.zerrolabs.org/Ground-Zerro/Phobos) (обфусцированный WireGuard VPN).
+
+> Где поддержать: [Boosty (донат)](https://boosty.to/andrey27/donate) · [Ozon СБП](https://finance.ozon.ru/apps/sbp/ozonbankpay/019dc200-2a5d-7931-a619-782d285f6798) · [Telegram @lot_andrey](https://t.me/lot_andrey) · [**GitHub** ↗](https://github.com/andrey271192/PCA_Phobos)
+
+## Быстрый старт
+
+**Требование:** Phobos уже установлен на VPS ([инструкция](https://git.zerrolabs.org/Ground-Zerro/Phobos)).
+
+```bash
+bash <(curl -fsSL https://raw.githubusercontent.com/andrey271192/PCA_Phobos/main/install.sh)
+```
+
+### С кастомными параметрами
+
+```bash
+PANEL_PASS=AdminPass456 \
+TG_TOKEN=1234567890:AABBCCDDaabbccdd \
+TG_CHAT=123456789 \
+bash <(curl -fsSL https://raw.githubusercontent.com/andrey271192/PCA_Phobos/main/install.sh)
+```
+
+| Переменная   | По умолчанию   | Описание                        |
+|--------------|----------------|---------------------------------|
+| `PANEL_PASS` | `OcAdmin2026!` | Пароль веб-панели (admin)       |
+| `TG_TOKEN`   | пусто          | Telegram bot token              |
+| `TG_CHAT`    | пусто          | Telegram chat ID для уведомлений|
+| `PANEL_PORT` | `8443`         | Порт веб-панели                 |
+
+---
+
+## Возможности
+
+- **Активные сессии** — VPN IP, Real IP, handshake, трафик RX/TX, Kick
+- **Клиенты VPN** — добавить/удалить через Phobos, статус online/offline
+- **Именование объектов** — привязать имя к Real IP (отображается в сессиях и Telegram)
+- **Срок подписки** — дата окончания для каждого клиента:
+  - Date picker в таблице клиентов
+  - Обратный отсчёт (18д, 3д⚠️, завтра⚠️, истёк⛔)
+  - При истечении: автокик + Telegram уведомление
+  - Предупреждения за 3 дня и 1 день
+- **Telegram уведомления** — 🟢 подключение, 🔴 отключение, ⚠️ за 3 дня, ⛔ истёк
+- **Настройки** — смена пароля панели, Telegram bot token + chat ID, интервал мониторинга
+- **Инфо о сервере** — порты, пути, команда установки на роутер
+
+---
+
+## Архитектура
+
+```
+Keenetic Router → wg-obfuscator (client) → :51821 → wg-obfuscator (server) → :51820 WireGuard → Internet
+                                                                                    │
+                                                                               10.25.0.x
+                                                                                    │
+                                                                          Web Panel :8443
+                                                                          (Flask + Gunicorn)
+```
+
+- Протокол: WireGuard + wg-obfuscator (обфускация от DPI)
+- Аутентификация: ключевые пары (нет паролей — только WireGuard ключи)
+- Подсеть VPN: `10.25.0.0/16`
+- Мониторинг сессий: каждые 30 сек (настраивается)
+
+---
+
+## Управление
+
+```bash
+# Phobos (VPN)
+phobos                          # Интерактивное меню
+systemctl status wg-quick@wg0   # WireGuard
+systemctl status wg-obfuscator  # Обфускатор
+wg show wg0                     # Активные peers
+
+# Веб-панель
+systemctl status phobos-panel
+systemctl restart phobos-panel
+journalctl -u phobos-panel -f
+```
+
+---
+
+## Структура файлов
+
+```
+/opt/Phobos/
+├── clients/           # Клиенты VPN (ключи, конфиги)
+│   └── {name}/
+│       ├── metadata.json
+│       ├── {name}.conf
+│       └── wg-obfuscator.conf
+├── server/
+│   ├── server.env     # Конфигурация сервера
+│   └── wg-obfuscator.conf
+└── repo/server/scripts/
+    └── phobos-client.sh  # Управление клиентами
+
+/opt/phobos-panel/
+├── app.py             # Flask веб-панель
+├── settings.json      # Настройки (пароль, Telegram, метки, сроки)
+└── .secret_key        # Ключ сессии
+
+/etc/wireguard/
+└── wg0.conf           # WireGuard конфигурация
+```
+
+---
+
+## Обновление панели
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/andrey271192/PCA_Phobos/main/app.py \
+  > /opt/phobos-panel/app.py
+systemctl restart phobos-panel
+```
+
+---
+
+## Поддержка проекта
+
+- ⭐ **GitHub:** [andrey271192/PCA_Phobos](https://github.com/andrey271192/PCA_Phobos)
+- 💖 **Boosty:** [boosty.to/andrey27/donate](https://boosty.to/andrey27/donate)
+- 💳 **Ozon Bank (СБП):** [ссылка](https://finance.ozon.ru/apps/sbp/ozonbankpay/019dc200-2a5d-7931-a619-782d285f6798)
+- ✉️ **Telegram:** [@lot_andrey](https://t.me/lot_andrey)