Files
MSWP/README.md
T
grendervill 49db39c877 version 1.2.2: исправлен парсинг статистики трафика
- app.py: get_traffic_stats() — позиционный парсинг 8 колонок mita get users, без сканирования суффиксов
- bot.py: cmd_users, cmd_dashboard — единый позиционный парсинг вместо поиска единиц
- README: обновлена дорожная карта
2026-06-26 23:48:32 +03:00

6.3 KiB

MSWP — mita Server Web Panel

Веб-панель и система развёртывания для прокси-протокола mieru/mita, с опциональной интеграцией Cloudflare WARP и CLI-утилитой mita-ctl.

Проект рассчитан на Ubuntu/Debian VPS. Включает: скрипты установки, веб-панель на Flask, CLI-утилиту и Telegram-бота.


Архитектура

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-bot (systemd)    — Telegram-бот
    ├── 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

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

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.2 (реализовано)

  • Автоматическая установка mita сервера (systemd)
  • Интеграция Cloudflare WARP через Docker
  • Веб-панель с секретным путём (Flask + Gunicorn, path-based security)
  • Тёмная тема, адаптивный UI: Dashboard, Users, SSL, Security
  • CRUD пользователей (создание, удаление, список) — авто/ручное/bulk
  • Статистика трафика: день, 7 дней, 30 дней (позиционный парсинг mita get users)
  • Онлайн-статус пользователей
  • Генерация клиентских конфигов (mieru JSON и sing-box JSON)
  • Скачивание конфигов и отображение QR-кодов
  • Управление WARP на пользователя (toggle + правила: домены, IP, geosite, geoip, URL источники)
  • SSL-сертификаты: самоподписной (10 лет) создаётся автоматически при установке, Let's Encrypt через UI
  • Кнопка перезапуска панели на вкладке SSL
  • Интеграция fail2ban: rate-limiting панели + fail2ban jail (пресеты)
  • Управление файрволом (UFW/iptables) через CLI и панель
  • Режим SSH-туннеля: панель только на 127.0.0.1
  • Ежедневное автообновление списков WARP (cron + dlc.dat v2fly)
  • CLI mita-ctl — интерактивное меню (10+ функций)
  • CLI manage-users.sh — add/remove/list/quota
  • Полное удаление всех компонентов (+ self-destruct утилиты)
  • Инструкция для клиента Karing (iOS/Android)
  • Защита сессий: динамический Secure cookie, in-memory rate limiter
  • Bootstrap-установщик (одна команда)
  • Мониторинг сервера: CPU, RAM, диск на дашборде (автообновление каждые 2 сек)
  • Telegram-бот: создание/удаление пользователей, трафик, WARP, мониторинг CPU/RAM/диск
  • Установка бота через веб-панель, CLI и полный установщик

Запланировано

  • Квоты пользователей в веб-панели (бэкенд готов, нужен UI)
  • Per-user egress routing (обход ограничения mita)
  • Поддержка нескольких протоколов (TCP + UDP) — доработка
  • Автоматический импорт конфигов в Karing (упрощение ручной инструкции)
  • Резервное копирование и восстановление конфигурации
  • Уведомления (Telegram-бот / email) при событиях
  • Мультиязычность интерфейса (i18n: RU/EN)
  • API-ключи для внешней интеграции
  • Графики использования трафика (история)
  • Автоматическое обновление mita бинарника
  • Развёртывание панели в Docker
  • Логирование действий администратора (audit log)

Лицензия

Проект разработан grendervill. Репозиторий: https://gt.netbird.mhspx.ru/grendervill/MSWP.git