version 1.2: Telegram-бот, мониторинг сервера на дашборде, README

- bot.py: Telegram-бот (/users, /create, /delete, /warp, /stats, /dashboard) - install-bot.sh: установщик бота (systemd, конфиг /etc/mita/bot.json) - app.py: API /api/bot/{status,install,uninstall,config}, /api/stats (CPU/RAM/диск) - templates: раздел «Telegram бот» в UI, мониторинг CPU/RAM/диск на дашборде (2s auto-refresh) - mita-ctl.sh: пункт 11 «Telegram-бот», удаление бота в полном uninstall - install.sh: опциональная установка бота с инструкцией - README.md: описание проекта и дорожная карта
2026-06-26 23:37:05 +03:00
parent d65f80cf9e
commit 33bdcdce68
9 changed files with 1432 additions and 49 deletions
@@ -0,0 +1,114 @@
+# MSWP — mita Server Web Panel
+
+Веб-панель и система развёртывания для прокси-протокола **[mieru/mita](https://github.com/enfein/mieru)**, с опциональной интеграцией **Cloudflare WARP** и CLI-утилитой `mita-ctl`.
+
+> Проект рассчитан на Ubuntu/Debian VPS. Состоит из трёх компонентов: серверная часть установки, веб-панель на Flask и CLI-утилита.
+
+---
+
+## Архитектура
+
+```
+curl -Ls ... | sudo bash  (bootstrap.sh)
+         │
+         ▼
+   install.sh — установка mita, WARP, веб-панели, cron
+    ├── mita (systemd)        — прокси-сервер
+    ├── WARP Docker           — SOCKS5-прокси (127.0.0.1:40000)
+    ├── mita-panel (Flask)    — веб-интерфейс управления
+    ├── mita-ctl              — CLI-меню
+    ├── manage-users.sh        — CLI для пользователей
+    └── auto-update (cron)    — ежедневное обновление списков WARP
+```
+
+## Технологии
+
+| Компонент | Технология |
+|---|---|
+| Бэкенд | Python 3 / Flask / Gunicorn |
+| Фронтенд | Vanilla JS, Jinja2, QRCode.js |
+| Прокси | mieru/mita |
+| WARP | seiry/cloudflare-warp-proxy (Docker) |
+| CLI | Bash |
+| Защита | fail2ban, UFW/iptables, Let's Encrypt |
+
+## Быстрый старт
+
+```bash
+curl -Ls https://raw.githubusercontent.com/grendervilll/mitactl/main/bootstrap.sh | sudo bash
+```
+
+---
+
+## Структура проекта
+
+```
+.
+├── app.py                 # Бэкенд Flask
+├── bot.py                  # Telegram-бот
+├── bootstrap.sh            # Bootstrap-установщик
+├── install.sh              # Полная установка сервера
+├── install-panel.sh        # Установка только панели
+├── install-bot.sh          # Установка Telegram-бота
+├── mita-ctl.sh             # CLI-утилита
+├── manage-users.sh          # CLI управление пользователями
+├── domains.txt             # Список доменов для WARP
+├── templates/
+│   ├── base.html           # Базовый шаблон: сайдбар, модалы, toast
+│   ├── index.html          # SPA: Dashboard, Users, SSL, Security, Bot
+│   └── login.html          # Страница входа
+└── static/
+    └── qrcode.min.js       # QRCode.js (minified)
+```
+
+---
+
+## Дорожная карта
+
+### ✅ Версия 1.1 (реализовано)
+
+- [x] Автоматическая установка mita сервера (systemd)
+- [x] Интеграция Cloudflare WARP через Docker
+- [x] Веб-панель с секретным путём (Flask + Gunicorn, path-based security)
+- [x] Тёмная тема, адаптивный UI: Dashboard, Users, SSL, Security
+- [x] CRUD пользователей (создание, удаление, список) — авто/ручное/bulk
+- [x] Статистика трафика: день, 7 дней, 30 дней
+- [x] Онлайн-статус пользователей
+- [x] Генерация клиентских конфигов (mieru JSON и sing-box JSON)
+- [x] Скачивание конфигов и отображение QR-кодов
+- [x] Управление WARP на пользователя (toggle + правила: домены, IP, geosite, geoip, URL источники)
+- [x] SSL-сертификаты: self-signed (10 лет) и Let's Encrypt через веб-интерфейс
+- [x] Интеграция fail2ban: rate-limiting панели + fail2ban jail (пресеты)
+- [x] Управление файрволом (UFW/iptables) через CLI и панель
+- [x] Режим SSH-туннеля: панель только на 127.0.0.1
+- [x] Ежедневное автообновление списков WARP (cron + dlc.dat v2fly)
+- [x] CLI `mita-ctl` — интерактивное меню (10+ функций)
+- [x] CLI `manage-users.sh` — add/remove/list/quota
+- [x] Полное удаление всех компонентов (+ self-destruct утилиты)
+- [x] Инструкция для клиента Karing (iOS/Android)
+- [x] Защита сессий: динамический Secure cookie, in-memory rate limiter
+- [x] Bootstrap-установщик (одна команда)
+- [x] Telegram-бот: создание/удаление пользователей, трафик, WARP, CPU/RAM/диск
+- [x] Установка бота через веб-панель, CLI и полный установщик
+
+### ⬜ Запланировано
+
+- [ ] Квоты пользователей в веб-панели (бэкенд готов, нужен UI)
+- [ ] Per-user egress routing (обход ограничения mita)
+- [ ] Поддержка нескольких протоколов (TCP + UDP) — доработка
+- [ ] Автоматический импорт конфигов в Karing (упрощение ручной инструкции)
+- [ ] Резервное копирование и восстановление конфигурации
+- [ ] Мониторинг состояния сервера (CPU, RAM, диск) в Dashboard
+- [ ] Уведомления (Telegram-бот / email) при событиях
+- [ ] Мультиязычность интерфейса (i18n: RU/EN)
+- [ ] API-ключи для внешней интеграции
+- [ ] Графики использования трафика
+- [ ] Автоматическое обновление mita бинарника
+- [ ] Развёртывание панели в Docker
+- [ ] Логирование действий администратора (audit log)
+
+---
+
+## Лицензия
+
+Проект разработан **grendervill**. Репозиторий: `https://gt.netbird.mhspx.ru/grendervill/MSWP.git`