Skip to content

danielVNru/mtproto-panel

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MTProto Panel

Веб-панель управления MTProto прокси серверами. Позволяет централизованно управлять несколькими сервис-нодами, создавать и настраивать прокси, просматривать статистику и следить за подключениями.

Возможности

  • Управление несколькими сервис-нодами с единой панели
  • Создание / редактирование / удаление MTProto прокси
  • VPN-туннелирование — указание VLESS-подписки для прокси (трафик через зарубежный сервер)
  • Мультипортовые прокси — назначение индивидуального порта каждому прокси
  • Просмотр статистики: CPU, RAM, трафик, аптайм
  • Подключённые IP-адреса с флагами стран
  • Лимиты подключений на прокси (ограничение устройств)
  • Чёрный список IP-адресов на уровне ноды
  • Пользовательские домены для fake TLS (пул 50 доменов по умолчанию)
  • Копирование ссылки tg://proxy?... в один клик
  • Приостановка / возобновление прокси
  • Обновление сервис-ноды из панели
  • JWT авторизация
  • Полностью на русском языке

Архитектура

┌──────────────────────────────┐
│           Panel              │
│  ┌──────────┐  ┌──────────┐ │
│  │  React   │  │ Express  │ │         ┌──────────────────┐
│  │ Frontend │→ │ Backend  │ │────────→│ Service Node #1  │
│  └──────────┘  └──────────┘ │         └──────────────────┘
│                ┌──────────┐  │         ┌──────────────────┐
│                │PostgreSQL│  │────────→│ Service Node #N  │
│                └──────────┘  │         └──────────────────┘
└──────────────────────────────┘
  • Frontend — React + Gravity UI + TypeScript + Vite
  • Backend — Express + PostgreSQL + TypeScript
  • БД — PostgreSQL 16 (Alpine)

Совместимость

Скрипт установки протестирован и поддерживается на следующих системах:

ОС Версия Пакетный менеджер
Ubuntu 20.04, 22.04, 24.04 apt
Debian 11, 12 apt
CentOS / RHEL 8, 9 yum / dnf
AlmaLinux / Rocky Linux 8, 9 yum

⚠️ Скрипт предназначен только для Linux x86_64 и aarch64. Windows и macOS не поддерживаются.

Скрипт автоматически установит недостающие зависимости: curl, openssl, git, Docker, Docker Compose.

Быстрая установка

Одна команда для загрузки и запуска:

bash <(wget -qO- https://raw.githubusercontent.com/danielVNru/mtproto-panel/master/install.sh)

Скрипт автоматически:

  1. Установит Docker и Docker Compose (если отсутствуют)
  2. Скачает последнюю версию из ветки master
  3. Запросит настройки:
    • Порт панели (по умолчанию 80)
    • Логин администратора
    • Пароль администратора
  4. Сгенерирует JWT-секрет и пароль БД
  5. Соберёт и запустит все контейнеры

Панель установится в /opt/mtproto-panel.

Обновление

cd /opt/mtproto-panel
git pull origin master
docker compose up -d --build

Структура контейнеров

Контейнер Описание Порт
mtproto-panel-frontend Nginx + React SPA ${PORT}:80
mtproto-panel-backend Express API 3000 (внутренний)
mtproto-panel-db PostgreSQL 5432 (внутренний)

Конфигурация (.env)

Переменная Описание
PORT Внешний порт панели
ADMIN_USERNAME Логин администратора
ADMIN_PASSWORD Пароль администратора
JWT_SECRET Секрет для JWT токенов
DB_NAME Имя базы данных
DB_USER Пользователь БД
DB_PASSWORD Пароль БД

Использование

  1. Откройте панель: http://SERVER_IP:PORT
  2. Войдите с логином и паролем администратора
  3. Добавьте сервис-ноду (IP, порт, токен)
  4. Создавайте прокси, управляйте лимитами и чёрными списками

Развёртывание в России с VPN

Для работы MTProto прокси в РФ трафик до Telegram нужно пропускать через зарубежный VPN-сервер.

Схема

Пользователь (РФ)
       │
       ▼
┌─────────────┐     ┌───────────────────┐     ┌──────────────┐     ┌─────────────┐
│  Панель     │────→│ Сервис-нода (РФ)  │────→│ VPN-сервер   │────→│ Telegram DC │
│  (любой IP) │     │ telemt + xray     │     │ (за рубежом) │     │             │
└─────────────┘     └───────────────────┘     └──────────────┘     └─────────────┘

Инструкция

  1. Установите панель на любом сервере (может быть в РФ)
  2. Установите сервис-ноду на российский сервер
  3. Подготовьте VPN-сервер за рубежом с xray/VLESS (Reality рекомендуется)
  4. В панели при создании прокси укажите URL подписки VLESS
  5. Сервис-нода автоматически создаст xray-туннель и проксирует трафик

Поддерживаемые VPN-протоколы

Протокол Транспорт Рекомендация
VLESS + Reality TCP Лучший выбор — не детектируется DPI
VLESS + TLS TCP / WS / gRPC Хорошо работает
VLESS TCP Базовый вариант

Требования

  • Linux (Ubuntu 20.04+, Debian 11+, CentOS 8+)
  • Docker Engine 20.10+
  • Docker Compose v2
  • 512 MB RAM, 1 GB диск

Связанный проект

Сервис-нода (устанавливается на каждый прокси-сервер): mtproto-node

About

Панель централизованного управления Telegram Proxy

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors