Skip to content

Therealwh/MTProtoSERVER

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
bot
bot
 
 
scripts
scripts
 
 
webui
webui
 
 
.gitignore
.gitignore
 
 
README.md
README.md
 
 
install.sh
install.sh
 
 
uninstall.sh
uninstall.sh
 
 

Repository files navigation

MTProtoSERVER — Полный комбайн MTProto прокси

Version License Docker FakeTLS Platform

Полноценный MTProto прокси сервер с обходом блокировок РФ

Установка • Возможности • Документация • FAQ

📋 Оглавление

📖 Описание

MTProtoSERVER — это полноценный комбайн для развёртывания MTProto прокси с обходом блокировок. Работает на базе telemt (Rust/Tokio) — самого современного и быстрого движка MTProto на 2026 год.

Ключевые особенности:

  • 🛡️ FakeTLS маскировка — трафик неотличим от обычного HTTPS
  • 🇷🇺 Работает в РФ — обход DPI и блокировок
  • 👥 Мульти-пользователь — отдельные ссылки для каждого
  • 🌐 Web панель — управление через браузер
  • 🤖 Telegram бот — управление из мессенджера
  • 📊 Статистика — графики и мониторинг
  • 🔄 Авто-лечение — перезапуск при падении
  • 💾 Бэкапы — автоматическое резервное копирование

⭐ Возможности

🛡️ Обход блокировок

Функция Описание
FakeTLS Маскировка под HTTPS к легитимным доменам (cloudflare.com, 1c.ru, и др.)
Мульти-прокси Создание нескольких прокси на разных портах с разными доменами
Авто-ротация домена Автоматическая смена домена при обнаружении блокировки
Порт 443 Стандартный HTTPS порт — не вызывает подозрений
DPI обход Невидим для систем глубокой инспекции пакетов

👥 Управление пользователями

Функция Описание
Мульти-секреты Каждый пользователь получает уникальную ссылку
Выбор прокси Привязка пользователя к конкретному прокси серверу
Лимит подключений Ограничение одновременных подключений на пользователя
Лимит IP Ограничение по уникальным IP-адресам
Квота трафика Лимит объёма данных на пользователя
Срок действия Автоматическое отключение по дате
QR-коды Генерация QR для быстрого подключения
Вкл/Выкл Временная блокировка без удаления

🌐 Web UI

Функция Описание
Дашборд Обзор состояния прокси и системы
Управление пользователями Добавление, удаление, блокировка
Статистика Графики трафика по пользователям
Настройки Просмотр конфигурации
Диагностика Проверка состояния системы
Тёмная/Светлая тема Переключение оформления
Мобильная адаптация Работает на телефонах

🤖 Telegram Bot

Команда Описание
/start Главное меню с inline кнопками
📊 Статус Информация о прокси
👥 Пользователи Список и управление
➕ Добавить Создание нового пользователя
📈 Статистика Общая статистика
🔗 Ссылка QR-код и ссылка прокси
🔧 Диагностика Проверка состояния

🔄 Автоматизация

Функция Описание
Auto-Heal Автоперезапуск упавших контейнеров (каждые 5 мин)
Auto-Update Автоматическое обновление образов
Backup Ежедневное резервное копирование
Мониторинг Проверка доступности прокси каждые 5 мин
Алерты Уведомления в Telegram при проблемах

🛡️ Безопасность

Функция Описание
GeoIP фильтрация Блокировка/разрешение стран
Rate Limiting Защита от злоупотребления
IP Whitelist/Blacklist Ручное управление доступом
Авто-бэкап Резервное копирование конфигов

💰 Монетизация

Функция Описание
Ad-Tag Встроенная реклама от Telegram
Реферальная система Учёт приглашённых
Тарифные планы Разные лимиты для групп

🏗️ Архитектура

┌─────────────────────────────────────────────────┐
│                  Ваш VPS сервер                  │
│                                                   │
│  ┌───────────────────────────────────────────┐  │
│  │         Docker Compose                     │  │
│  │                                            │  │
│  │  ┌─────────────┐  ┌──────────┐  ┌───────┐ │  │
│  │  │   MTProxy    │  │  Web UI  │  │  Bot  │ │  │
│  │  │  (telemt)   │  │ (FastAPI)│  │ (PTB) │ │  │
│  │  │  Port 443   │  │Port 8080 │  │       │ │  │
│  │  └──────┬──────┘  └────┬─────┘  └───┬───┘ │  │
│  │         │              │             │      │  │
│  │  ┌──────┴──────────────┴─────────────┴───┐ │  │
│  │  │         Docker Network                 │ │  │
│  │  └────────────────────────────────────────┘ │  │
│  └───────────────────────────────────────────┘  │
│                                                   │
│  ┌───────────────────────────────────────────┐  │
│  │  /opt/mtprotoserver/                       │  │
│  │  ├── config/     (настройки)               │  │
│  │  ├── data/       (пользователи, статистика)│  │
│  │  ├── scripts/    (auto-heal, backup...)    │  │
│  │  └── docker-compose.yml                    │  │
│  └───────────────────────────────────────────┘  │
└─────────────────────────────────────────────────┘
           │                        │
           ▼                        ▼
    Telegram DC           Telegram клиенты
   (Amsterdam)          (через FakeTLS)

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

sudo bash -c "$(curl -fsSL https://raw.githubusercontent.com/Therealwh/MTProtoSERVER/main/install.sh)"

⚠️ Требования: Linux (Ubuntu/Debian/CentOS), root доступ, открытый порт 443

📖 Пошаговая установка (подробно)

Шаг 1: Подготовка сервера

Рекомендуемые VPS провайдеры:

  • 🇷🇺 Для пользователей из РФ: VPS внутри России (меньше фильтрация)
  • 🌍 Для остальных: любой зарубежный VPS

Минимальные требования:

  • CPU: 1 ядро
  • RAM: 512 MB
  • Диск: 5 GB
  • ОС: Ubuntu 20.04+ / Debian 11+ / CentOS 8+
# Обновление системы
sudo apt update && sudo apt upgrade -y

# Скачивание установщика
curl -fsSL https://raw.githubusercontent.com/Therealwh/MTProtoSERVER/main/install.sh -o install.sh
chmod +x install.sh

Шаг 2: Запуск установщика

sudo bash install.sh

Установщик задаст вопросы:

  1. Количество прокси — сколько прокси серверов создать (1-10):

    • Каждый прокси будет на своём порту
    • Каждый прокси может иметь свой домен маскировки
    • Если один домен заблокируют — другие продолжат работать

  2. Для каждого прокси:

    • Метка (например: main, backup, friends)
    • Домен маскировки (cloudflare.com, 1c.ru, sberbank.ru и др.)
    • Порт (по умолчанию 443, 444, 445...)

  3. Порт Web UI — по умолчанию 8080

  4. Telegram бот — хотите ли установить бота:

    • Введите y для установки
    • Укажите токен от @BotFather
    • Укажите Chat ID для уведомлений (опционально)

Шаг 3: Получение токена бота (опционально)

Если вы выбрали установку бота:

  1. Откройте @BotFather в Telegram
  2. Отправьте /newbot
  3. Введите имя бота (например, My MTProto Manager)
  4. Введите username бота (должен заканчиваться на bot, например my_mtproto_bot)
  5. Скопируйте полученный токен (вида 123456789:ABCdef...)

Шаг 4: Подключение к прокси

После установки вы получите ссылку вида:

tg://proxy?server=1.2.3.4&port=443&secret=ee...

Как подключить:

  1. Откройте Telegram
  2. Настройки → Данные и память → Использовать прокси
  3. Вставьте ссылку или отсканируйте QR-код
  4. Готово!

🎛️ Управление

Web Панель

Откройте в браузере: http://ВАШ_IP:8080

Разделы:

  • 📊 Дашборд — обзор, быстрые действия
  • 👥 Пользователи — управление доступом
  • 📈 Статистика — графики трафика
  • ⚙️ Настройки — конфигурация
  • 🔧 Диагностика — проверка системы

Telegram Bot

Откройте вашего бота в Telegram и используйте inline меню:

  • 📊 Статус прокси
  • 👥 Список пользователей
  • ➕ Добавить пользователя
  • 📈 Статистика
  • 🔗 Ссылка с QR-кодом
  • 🔧 Диагностика

💻 Полезные команды

# Перейти в каталог установки
cd /opt/mtprotoserver

# Просмотр статуса контейнеров
docker compose ps

# Просмотр логов
docker compose logs -f

# Перезапуск
docker compose restart

# Остановка
docker compose down

# Обновление
docker compose pull && docker compose up -d

# Добавить новый прокси (интерактивно)
bash /opt/mtprotoserver/scripts/add-proxy.sh

# Удалить прокси
bash /opt/mtprotoserver/scripts/remove-proxy.sh <label>

# Health Check
bash /opt/mtprotoserver/scripts/health-check.sh

# Speedtest
bash /opt/mtprotoserver/scripts/speedtest.sh

# Бэкап
bash /opt/mtprotoserver/scripts/backup.sh

# Авто-ротация домена
bash /opt/mtprotoserver/scripts/rotate-domain.sh

# Мониторинг
bash /opt/mtprotoserver/scripts/monitor.sh

🛡️ Безопасность

Рекомендации

  1. Не публикуйте ссылку на прокси — она персональная
  2. Используйте сложный домен маскировки — cloudflare.com, sberbank.ru
  3. Откройте только порт 443 в файрволе
  4. Регулярно обновляйте — docker compose pull && docker compose up -d
  5. Включите бэкапы — работают автоматически
  6. Используйте лимиты — ограничьте пользователей по подключениям и трафику

Файрвол (UFW)

sudo ufw allow 443/tcp
sudo ufw allow 8080/tcp  # Web UI (опционально, ограничьте по IP)
sudo ufw enable

Файрвол (iptables)

sudo iptables -A INPUT -p tcp --dport 443 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 8080 -j ACCEPT

🔧 Устранение проблем

Прокси не подключается

  1. Проверьте контейнеры:

    docker compose ps

  2. Проверьте порт 443:

    ss -tlnp | grep 443

  3. Проверьте файрвол:

    sudo ufw status

  4. Проверьте IP в ссылке:

    curl -s ifconfig.me

    IP должен совпадать с тем, что в ссылке прокси.

  5. Проверьте логи:

    docker compose logs mtproto-proxy

Web UI не открывается

  1. Проверьте что контейнер запущен:

    docker compose ps mtproto-webui

  2. Проверьте порт:

    ss -tlnp | grep 8080

  3. Откройте порт в файрволе:

    sudo ufw allow 8080/tcp

Бот не отвечает

  1. Проверьте токен в config/settings.json
  2. Проверьте логи: 
    docker compose logs mtproto-bot
  3. Перезапустите бота: 
    docker compose restart mtproto-bot

Health Check

Запустите полную диагностику:

bash /opt/mtprotoserver/scripts/health-check.sh

❓ FAQ

Q: Это легально?

A: MTProto — официальный протокол прокси от Telegram. Использование прокси для доступа к легальным ресурсам не запрещено.

Q: Какой VPS выбрать?

A: Для пользователей из РФ рекомендуется VPS внутри России (меньше фильтрация на границе сети). Для остальных — любой зарубежный VPS.

Q: Сколько пользователей поддерживает?

A: Зависит от ресурсов сервера. На минимальном VPS (1 ядро, 512MB RAM) — до 100 пользователей.

Q: Как добавить пользователя?

A: Через Web UI (/users), Telegram бота (➕ Добавить пользователя), или вручную в data/users.json.

Q: Как сменить домен маскировки?

A: Запустите bash /opt/mtprotoserver/scripts/rotate-domain.sh или измените вручную в docker-compose.yml.

Q: Прокси работает медленно?

A: Проверьте скорость соединения: bash /opt/mtprotoserver/scripts/speedtest.sh. Возможно, стоит сменить VPS провайдера.

Q: Как добавить ещё один прокси?

A: Через Web UI (раздел "Прокси" → "Добавить прокси") или командой: bash /opt/mtprotoserver/scripts/add-proxy.sh

Q: Зачем несколько прокси?

A: Если один домен заблокируют — другие продолжат работать. Можно раздавать разные прокси разным группам пользователей.

Q: Как обновить?

A: cd /opt/mtprotoserver && docker compose pull && docker compose up -d

🗑️ Удаление

curl -fsSL https://raw.githubusercontent.com/Therealwh/MTProtoSERVER/main/uninstall.sh | sudo bash

Или вручную:

cd /opt/mtprotoserver
docker compose down
cd ..
sudo rm -rf /opt/mtprotoserver

📁 Структура проекта

MTProtoSERVER/
├── install.sh                    # Главный установщик
├── uninstall.sh                  # Скрипт удаления
├── README.md                     # Документация
├── .gitignore
│
├── mtproxy/
│   └── config.toml               # Конфигурация прокси
│
├── webui/
│   ├── Dockerfile
│   ├── app.py                    # FastAPI приложение
│   ├── requirements.txt
│   ├── templates/                # HTML шаблоны
│   │   ├── base.html
│   │   ├── index.html            # Дашборд
│   │   ├── users.html            # Пользователи
│   │   ├── stats.html            # Статистика
│   │   ├── settings.html         # Настройки
│   │   └── diagnostics.html      # Диагностика
│   └── static/
│       ├── css/style.css         # Стили
│       └── js/app.js             # JavaScript
│
├── bot/
│   ├── Dockerfile
│   ├── bot.py                    # Telegram бот
│   └── requirements.txt
│
├── scripts/
│   ├── auto-heal.sh              # Авто-лечение
│   ├── auto-update.sh            # Авто-обновление
│   ├── backup.sh                 # Бэкап
│   ├── monitor.sh                # Мониторинг
│   ├── rotate-domain.sh          # Ротация домена
│   ├── health-check.sh           # Диагностика
│   └── speedtest.sh              # Speedtest
│
└── config/
    ├── domains.txt               # Список доменов FakeTLS
    └── geoblock.txt              # GeoIP список

📄 Лицензия

MIT License — свободное использование с указанием авторства.

MTProtoSERVER v1.0.0 | 2026

Сделано с ❤️ для свободного доступа к Telegram

About

MTProto Proxy Control Panel - Multi-Node, FakeTLS, SOCKS5, HTTP, Web UI, Telegram Bot, 2FA, Real-time Monitoring, Client Management

github.com/Therealwh/MTProtoSERVER

Topics

docker monitoring telegram telegram-bot proxy multi-node web-ui proxy-server http-proxy socks5 mtproto totp client-management 2fa mtproxy mtproto-proxy fastapi fake-tls dpi-bypass russia-bypass

Resources

Readme
Activity

Stars

0 stars

Watchers

0 watching

Forks

1 fork
Report repository

Releases

No releases published

Packages

 
 
 

Contributors 1

Languages