Skip to content

Установка Telegram MTProto прокси в Docker ​

В этом руководстве мы рассмотрим развёртывание официального MTProto прокси-сервера Telegram с помощью Docker. MTProto прокси использует нативный протокол Telegram, что делает его быстрым и надёжным способом доступа к Telegram в условиях ограниченных сетей или активных блокировок.

Что такое MTProto Proxy ​

MTProto Proxy - это собственный прокси протокол Telegram, специально разработанный для этой платформы. В отличие от стандартных SOCKS5 или HTTP прокси, MTProto создан исключительно для трафика Telegram и обладает рядом преимуществ:

  • Нулевая конфигурация - официальный Docker-образ настраивает всё автоматически
  • Поддержка нативного протокола - не требуется дополнительное ПО на стороне клиента, достаточно вставить ссылку в Telegram
  • Обфускация - трафик зашифрован, и его сложнее обнаружить по сравнению с обычными SOCKS или HTTP прокси
  • Многопользовательский режим - один прокси-сервер может обслуживать десятки тысяч одновременных подключений
  • Спонсорские каналы - вы можете продвигать свой канал среди всех пользователей вашего прокси

Подсказка

Для автоматической установки MTProto выберите его шаблон скрипта при заказе VPS или запустите его из панели управления ВМ после активации услуги. Скрипт установит и настроит MTProto на вашем сервере.

Требования ​

  • VPS-сервер с Linux (в примере используется Ubuntu 24.04)
  • root или sudo доступ в системе для ручной установки
  • Установленный и запущенный Docker для ручной установки
  • Открытый порт 443 (или другой выбранный вами порт) в брандмауэре

TIP

Если вы ещё не установили Docker, следуйте инструкции из нашего руководства по WireGuard Easy - процесс установки одинаковый.

Установка ​

Автоматическая установка для клиентов хостинга ​

Поддерживаемые операционные системы: Debian 11, Debian 12, Debian 13, Ubuntu 20.04, Ubuntu 22.04, Ubuntu 24.04.

При заказе услуги ​

В форме заказа выберите шаблон скрипта «MTProto», завершите заказ и дождитесь окончания его выполнения на VPS.

Выбор скрипта MTProto при заказе сервера в личном кабинете

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

Через панель управления ВМ ​

Перейдите в панель управления ВМ, перейдите в управление нужным сервером, в правом верхнем углу раскройте «Меню» и выберите опцию «Запустить скрипт».

Открытие опции «Запустить скрипт» в меню панели управления ВМ

В диалоге выберите шаблон скрипта «MTProto», включите опцию «Отправить письмо, которое привязано к скрипту» и запустите скрипт.

Мастер запуска скрипта с выбранным MTProto и включённым уведомлением по email

По окончанию установки вы получите письмо со ссылкой для подключения к MTProto прокси.

Что устанавливается ​

Скрипт разворачивает официальный MTProto прокси Telegram в Docker. Контейнер автоматически генерирует секретную фразу и ссылки для подключения без какой-либо дополнительной настройки.

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

  • connection-info.txt — содержит ссылку tg://, веб-ссылку t.me, секретную фразу, IP сервера и порт

Как подключиться ​

  1. Откройте ссылку t.me из connection-info.txt в любом браузере — Telegram автоматически предложит включить прокси
  2. Или: в Telegram перейдите в Настройки → Продвинутые настройки → Тип соединения → Использовать прокси → MTProto и введите IP сервера, порт и секретную фразу вручную

Брандмауэр ​

Скрипт настраивает достаточно ограниченный брандмауэр — открыты только лишь порты SSH и MTProto (443/tcp). Весь остальной входящий трафик по умолчанию блокируется.

Ежедневный перезапуск в 04:00 UTC автоматически обновляет IP-адреса ядра Telegram.

Управление сервером ​

bash
cd /opt/mtproto-docker && docker compose up -d    # запуск
cd /opt/mtproto-docker && docker compose down      # остановка
cd /opt/mtproto-docker && docker compose logs -f   # логи
docker logs mtproto_proxy                          # просмотр ссылок для подключения

Ручная установка ​

Если вы уже запустили шаблон скрипта «MTProto», пропустите этот способ установки и используйте полученные данные для подключения.

Выполняйте серверные команды от root (sudo -i) или используйте sudo для команд Docker. MTProto передаёт только трафик Telegram; это не VPN для остальных приложений.

Установка Docker ​

Если Docker ещё не установлен, проще всего воспользоваться официальным скриптом установки:

bash
curl -sSL https://get.docker.com/ | CHANNEL=stable bash

Скрипт автоматически определит ваш дистрибутив Linux и установит последнюю стабильную версию Docker.

Развёртывание MTProto Proxy ​

Базовое развёртывание ​

Простейший способ запустить прокси одной командой:

bash
docker run -d \
  -p 443:443 \
  --name=mtproto-proxy \
  --restart=always \
  -v proxy-config:/data \
  telegrammessenger/proxy:latest

Эта команда:

  • Запускает контейнер в фоновом режиме (-d)
  • Пробрасывает порты между сетью контейнера и вашим сервером
  • Присваивает контейнеру название mtproto-proxy для более удобной навигации
  • Автоматически перезапускает контейнер при остановке или перезагрузке сервера
  • Сохраняет конфигурацию (включая секрет) в volume контейнера

Получение ссылок для подключения ​

После запуска контейнера проверьте логи, чтобы получить актуальные ссылки для подключения:

bash
docker logs mtproto-proxy

Вы увидите вывод, похожий на этот:

[+] No secret passed. Will generate 1 random ones.
[+] Saving generated secret to /data/secret.
[*] Final configuration:
[*]   Secret 1: 00baadf00d15abad1deaa515baadcafe
[*]   tg:// link for secret 1 auto configuration: tg://proxy?server=YOUR_IP&port=443&secret=00baadf00d15abad1deaa515baadcafe
[*]   t.me link for secret 1: https://t.me/proxy?server=YOUR_IP&port=443&secret=00baadf00d15abad1deaa515baadcafe
[*]   Tag: no tag
[*]   External IP: YOUR_IP

Скопируйте ссылку tg:// или t.me и вставьте её в Telegram на любом устройстве - прокси настроится автоматически.

WARNING

Убедитесь, что IP-адрес в ссылке совпадает с публичным IP вашего сервера. Если прокси работает за NAT, ссылки может потребоваться исправить вручную.

Пользовательская конфигурация ​

Ниже приведены альтернативные варианты запуска. Если mtproto-proxy уже существует, сохраните его настройки, остановите и удалите контейнер перед пересозданием. Сохраните том proxy-config. Сгенерируйте свои секреты: значения ниже приведены только для примера.

Установка своей секретной фразы ​

Если вы хотите использовать собственную секретную фразу (достаточно полезно при развёртывании нескольких прокси для балансировки нагрузки), вы можете передать её в виде переменной при запуске контейнера. Секретная фраза должна быть ровно 16 байт в шестнадцатеричном формате и быть в нижнем регистре (32 символа).

Сгенерировать случайную секретную фразу можно командой:

bash
openssl rand -hex 16

Затем передайте её в виде переменной контейнеру:

bash
docker run -d \
  -p 443:443 \
  --name=mtproto-proxy \
  --restart=always \
  -v proxy-config:/data \
  -e SECRET=00baadf00d15abad1deaa515baadcafe \
  telegrammessenger/proxy:latest

Несколько секретных фраз ​

Прокси поддерживает до 16 различных секретных фраз. Вы можете указать их явно через запятую или позволить контейнеру сгенерировать указанное количество секретных фраз:

bash
# Явное указание нескольких секретных фраз
docker run -d \
  -p 443:443 \
  --name=mtproto-proxy \
  --restart=always \
  -v proxy-config:/data \
  -e SECRET=935ddceb2f6bbbb78363b224099f75c8,2084c7e58d8213296a3206da70356c81 \
  telegrammessenger/proxy:latest
bash
# Автоматическая генерация 4 секретных фраз
docker run -d \
  -p 443:443 \
  --name=mtproto-proxy \
  --restart=always \
  -v proxy-config:/data \
  -e SECRET_COUNT=4 \
  telegrammessenger/proxy:latest

Использование другого порта ​

Вы можете пробросить любой другой порт с вашего сервера на внутренний порт контейнера 443. Например, чтобы использовать порт 8443 для прокси:

bash
docker run -d \
  -p 8443:443 \
  --name=mtproto-proxy \
  --restart=always \
  -v proxy-config:/data \
  telegrammessenger/proxy:latest

WARNING

При изменении внешнего порта также необходимо вручную обновить номер порта в ссылках tg:// и t.me из логов контейнера.

Добавление тега спонсорского канала ​

Вы можете зарегистрировать свой прокси в Telegram-боте @MTProxybot и получить тег для продвижения своего канала. Этот тег позволяет показывать спонсорский канал всем пользователям, подключённым через ваш прокси:

bash
docker run -d \
  -p 443:443 \
  --name=mtproto-proxy \
  --restart=always \
  -v proxy-config:/data \
  -e TAG=3f40462915a3e6026a4d790127b95ded \
  telegrammessenger/proxy:latest

TIP

Тег сохраняется при обычном перезапуске контейнера, но при пересоздании его нужно снова передать через TAG. Секрет сохраняется в томе proxy-config, пока вы не удалите или не замените этот том.

Настройка количества воркеров ​

Один рабочий процесс (воркер) способен обслуживать десятки тысяч подключений. По умолчанию прокси запускает 2 воркера с лимитом 60 000 соединений на один поток. Если вы ожидаете высокую нагрузку на ваше прокси, рекомендуем увеличить количество воркеров:

bash
docker run -d \
  -p 443:443 \
  --name=mtproto-proxy \
  --restart=always \
  -v proxy-config:/data \
  -e WORKERS=16 \
  telegrammessenger/proxy:latest

Docker публикует порт контейнера с помощью собственных правил брандмауэра. Такой трафик может обходить фильтрацию UFW; перед ограничением доступа ознакомьтесь с документацией Docker и UFW.

Открытие порта в брандмауэре ​

Если вы используете UFW (Uncomplicated Firewall), разрешите трафик на порту прокси:

bash
# Для порта 443 по умолчанию
sudo ufw allow 443/tcp

# Для кастомного порта (например, 8443)
sudo ufw allow 8443/tcp

Регистрация прокси в Telegram ​

Для получения доступа к статистике использования и опциональной рекламы:

  1. Откройте Telegram и найдите бота @MTProxybot
  2. Отправьте команду /newproxy
  3. Укажите IP-адрес и порт вашего сервера
  4. Укажите секрет вашего прокси
  5. Бот выдаст вам тег - используйте его с переменной окружения TAG, как показано выше

Подключение клиентов ​

На мобильных устройствах (Android / iOS) ​

  1. Откройте ссылку tg:// или t.me из логов контейнера в браузере
  2. Telegram откроется и предложит включить прокси
  3. Нажмите Подключить

На компьютере (Telegram Desktop) ​

  1. Откройте ссылку tg:// или t.me
  2. Telegram Desktop предложит добавить прокси
  3. Нажмите Включить

Ручная настройка ​

Если вы предпочитаете настроить прокси вручную:

  1. Перейдите в Настройки > Продвинутые настройки > Тип соединения > Использовать собственный прокси
  2. Выберите MTProto
  3. Введите IP-адрес сервера, порт и секретную фразу
  4. Нажмите Сохранить и затем Подключиться

Управление контейнером ​

Основные команды ​

bash
# Просмотр статуса контейнера
docker ps -a | grep mtproto-proxy

# Просмотр логов
docker logs mtproto-proxy

# Просмотр логов в реальном времени
docker logs -f mtproto-proxy

# Остановка прокси
docker stop mtproto-proxy

# Запуск прокси
docker start mtproto-proxy

# Перезапуск прокси
docker restart mtproto-proxy

# Удаление контейнера (данные сохраняются в volume контейнера)
docker rm -f mtproto-proxy

Обновление прокси ​

Сначала сохраните текущий проброс портов и значения SECRET, TAG и WORKERS, если вы их задавали. Используйте их при пересоздании контейнера; ниже приведена базовая конфигурация:

bash
# Скачать последнюю доступную версию Docker образа
docker pull telegrammessenger/proxy:latest

# Удалить старый контейнер
docker rm -f mtproto-proxy

# Запустить новый контейнер (секрет сохраняется в volume контейнера)
docker run -d \
  -p 443:443 \
  --name=mtproto-proxy \
  --restart=always \
  -v proxy-config:/data \
  telegrammessenger/proxy:latest

Мониторинг ​

Прокси предоставляет внутреннюю статистику по адресу http://localhost:2398/stats внутри контейнера.

Для просмотра статистики выполните:

bash
docker exec mtproto-proxy curl http://localhost:2398/stats

Ключевые метрики:

МетрикаОписание
ready_targetsКоличество серверов Telegram, к которым прокси попытается подключиться
active_targetsКоличество серверов Telegram, к которым прокси подключён (должно совпадать с ready_targets)
total_special_connectionsКоличество текущих подключённых клиентов
total_max_special_connectionsМаксимально допустимое количество подключений (60 000 x количество воркеров)

Автоматический ежедневный перезапуск ​

Прокси получает IP-адреса серверов Telegram при запуске. Эти адреса всегда могут меняться, поэтому рекомендуется перезапускать контейнер раз в сутки для актуализации списка IP:

bash
# Открыть редактор crontab
crontab -e

Добавьте следующую строку для перезапуска прокси каждый день в 4:00 утра (по локальному времени настроенном в сервере):

0 4 * * * docker restart mtproto-proxy

Решение проблем ​

Клиенты зависают на подключении ​

Это означает, что клиенты не могут достучаться до вашего прокси-сервера. Проверьте следующее:

  • Брандмауэр: убедитесь, что порт прокси (443 или ваш пользовательский порт) открыт
    bash
    sudo ufw status
  • Проброс портов Docker: убедитесь, что контейнер запущен и порт проброшен корректно
    bash
    docker ps
  • Сетевые ограничения: некоторые сети могут блокировать порт 443 для не-HTTPS трафика. Попробуйте использовать другой порт

Клиенты зависают на обновлении ​

Это означает, что прокси не может подключиться к серверам ядра Telegram. Проверьте:

  • Исходящий брандмауэр: убедитесь, что ваш сервер может устанавливать исходящие соединения
    bash
    curl -I https://telegram.org
  • Системное время: прокси требует, чтобы системные часы были в пределах 5 секунд от UTC. Установите и включите синхронизацию времени:
    bash
    sudo apt install systemd-timesyncd
    sudo timedatectl set-ntp true
    timedatectl status
  • Перезапустите контейнер: IP-адреса серверов Telegram могли измениться с момента запуска контейнера
    bash
    docker restart mtproto-proxy

Контейнер сразу завершается ​

Проверьте логи контейнера на наличие ошибок:

bash
docker logs mtproto-proxy

Частые причины:

  • Порт 443 уже занят другим сервисом (например, Nginx, Apache)
  • Ошибки в переменных окружения, правах доступа или конфигурации. Сначала изучите сообщение в логе. Не удаляйте proxy-config в качестве обычного шага диагностики: в нём хранятся секреты, и после его удаления старые ссылки клиентов могут перестать работать.

Заключение ​

Развёртывание MTProto прокси с Docker - это очень даже простой процесс. Одна команда - и у вас уже есть полноценный, рабочий прокси сервер. Не забывайте перезапускать контейнер раз в сутки и поддерживать систему в актуальном состоянии для надёжной работы.

Если у вас возникнут вопросы, вы всегда можете обратиться в нашу службу поддержки.

Авторы статьи

Загрузка авторов...