3SELLER Journal 3SELLER →

Web proxy телеграмм как настроить: 6 шагов на своем домене и 5 грабель, которые ловят всех

16.11.2026

Админ небольшой продуктовой команды пришел ко мне с типовой задачей: сотрудники в коворкинге и в поездках должны стабильно работать с Telegram, а трафик идет через их собственный узел. Не через чужой бесплатный сервер и не через случайное приложение из стора, а через инфраструктуру, которую они контролируют. Спросил, что уже пробовали. Ответ стандартный: настроили MTProto, раздали ссылку, половина подключилась, половина нет. Через неделю выяснилось, что в сети коворкинга режут нестандартные порты, а в отеле на Бали работает только 443.

Вот тут и всплывает web proxy. Его часто путают с обычным прокси-сервером или с VPN. На деле это отдельный режим: трафик Telegram идет через ваш домен по HTTPS или WebSocket, а внутри разворачивается в MTProto. Снаружи выглядит как обычный запрос к сайту. Для вас - управляемый узел с понятной архитектурой и предсказуемой задержкой.

Web proxy - это про архитектуру, а не про чудеса

У вас есть домен, например proxy.yourcompany.ru. На нем Nginx с валидным TLS-сертификатом. Клиент Telegram стучится на 443, Nginx принимает соединение и проксирует его на внутренний listener telEgo. Тот разбирает запрос и превращает его в MTProto-соединение с серверами Telegram. Обратный путь такой же.

Ключевой момент: снаружи нет никакого «прокси-порта». Есть стандартный HTTPS на 443. Такой подход решает проблему с сетями, где разрешен только веб. Контроль при этом не теряется: все соединения идут через ваш сервер, видно нагрузку, можно балансировать, ставить лимиты и снимать метрики.

Внутри telEgo web proxy описывается отдельной секцией [web-proxy]. Именно она включает режим, в котором сервер принимает веб-запросы и конвертирует их в MTProto. Без этой секции Nginx будет стучаться в пустоту и получать 502.

Чем web proxy отличается от MTProto и SOCKS5

Три режима, три сценария. MTProto-прокси работает по своему протоколу и требует секрет, который генерируется на сервере. SOCKS5 - классический прокси с логином и паролем, он проксирует не только Telegram, но и другие приложения. Web proxy - надстройка над MTProto, которая маскирует соединение под обычный веб-трафик.

Секреты путают часто. Перенести secret из MTProto в поле пароля SOCKS5 нельзя: это разные сущности, клиент просто не подключится. Владелец сервера всегда указывает тип подключения, и клиент должен использовать ровно его. Если прислали ссылку с параметром secret, это MTProto или web proxy, но не SOCKS5.

Встроенный прокси в Telegram направляет через посредника только трафик мессенджера. Это не VPN для всего устройства. Нужен прокси для браузера или других приложений - это отдельная задача и отдельная инфраструктура. Смешаете и получите жалобы «у меня половина сайтов не грузится».

Для настройки прокси никогда не нужно передавать владельцу сервера код входа в Telegram или пароль двухэтапной аутентификации. Базовая гигиена. Если кто-то просит такие данные под предлогом настройки, прекращайте общение.

Что понадобится до первого запуска

Список короткий, но без любого пункта ничего не взлетит. VPS с публичным адресом и root-доступом. Домен, который вы контролируете, с A-записью на этот сервер. Валидный TLS-сертификат: клиент Telegram проверяет цепочку и без доверия откажется работать. Nginx и telEgo. И базовое понимание, как выглядит конфиг Nginx, иначе отладка превратится в боль.

Сервер берите в той локации, где основная аудитория. Если сотрудники в Москве, а сервер в Америке, каждая отправка сообщения добавляет сотни миллисекунд. Для текста терпимо, для звонков и медиа уже заметно. При распределенной аудитории я советую европейский дата-центр с хорошей связностью.

Каталог прокси для инфраструктурных задач

Схема, которую стоит нарисовать на бумаге

Клиент идет на 443 вашего домена. Nginx терминирует TLS и передает запрос на приватный listener. В типовой конфигурации telEgo внутренние listener'ы слушают приватные порты, а WEB listener смотрит только в docker-сеть. Наружу они смотреть не должны.

Режим https-lanes требует HTTP/2 на публичном TLS listener: меньше задержки, аккуратнее мультиплексирование. Режим WebSocket требует передачи заголовков Upgrade и Connection, иначе соединение оборвется на рукопожатии. Это две самые частые причины, почему «вроде все настроил, а не работает».

Дальше nginx -t. Команда ловит синтаксические ошибки до перезапуска. Потом перезапуск telEgo и reload Nginx. Порядок важен: сначала бэкенд, потом фронт. Иначе получите несколько секунд с 502 и лишние седые волосы.

Быстрый путь через Docker Compose

Если не хочется собирать руками, в репозитории telEgo есть готовый пример web-proxy. Клонируете, заходите в examples/web-proxy и видите три файла: docker-compose.yml с контейнерами и приватной сетью, telego.toml с настройками MTProxy, TLS fronting и web proxy, и nginx/nginx.conf с TLS, WEB ingress и обычным сайтом.

Дальше заменить proxy.example.com на свой домен во всех трех файлах. На этом месте многие ленятся и забывают один файл, а потом удивляются: сертификат выписан на один хост, конфиг ссылается на другой. Проверяйте все три места, даже если кажется, что помните.

Секрет генерируется отдельно и в открытом виде в репозитории не хранится. Для установки Nginx есть скрипт deploy/install-nginx.sh: принимает hostname, base-path, secret и флаг site-upstream. Конфигурацию он разворачивает, но понимать, что внутри, все равно придется. Скрипты удобны, пока не сломались. Когда сломались, без понимания структуры вы будете смотреть в логи и гадать.

Заголовок Host, из-за которого ломается все

Главная грабля, на которую наступают почти все. Клиент Telegram формирует хеш и передает его в параметре запроса. Имя хоста для хеша берется из адреса, который ввел пользователь. Если Nginx перезапишет заголовок Host на внутренний адрес, проверка не пройдет: клиент посчитал хеш от одного имени, сервер проверит от другого.

Решение простое, но неочевидное: для нужного location запретить перезапись Host и сохранить исходный хост. В Nginx это строка proxy_set_header Host your-proxy.ru;. В заголовке остается именно то имя, которое использует клиент.

Полдня дебага на эту тему я видел не раз. Логи чистые, сертификат валидный, соединение устанавливается, а авторизация не проходит. В обсуждениях на Reddit админы описывают тот же квест: перебрали сертификаты, порты и версии клиента, а виновата одна строка в конфиге. Поэтому первое, что я проверяю на чужой установке, - заголовок Host.

WebSocket или https-lanes: что выбрать

Оба режима рабочие, но под разные условия. WebSocket ближе к поведению обычных веб-приложений с постоянным соединением. Он лучше проходит через прокси-серверы и корпоративные шлюзы, которые привыкли видеть upgrade-запросы. В сетях со строгим инспектором трафика WebSocket вызывает меньше вопросов.

https-lanes дает более предсказуемую задержку и проще масштабируется. Требует HTTP/2 на публичном listener и внимательной настройки таймаутов. При большом числе одновременных подключений на одном домене вариант экономнее по ресурсам.

На практике начинайте с WebSocket, если нет специфических требований. Он проще в отладке, и большинство готовых конфигов в примерах заточены под него. Переключиться на https-lanes можно позже, когда базовая схема работает и видно узкие места.

Где взять прокси, если администрировать не хочется

Свой узел хорош, но нужен не всем. Кому-то требуется готовый прокси для парсинга, работы с маркетплейсами, проверки рекламы в разных гео. Держать под это отдельный VPS с Nginx и сертификатами нерационально. Проще взять готовое решение из каталога прокси: выбрать тип, гео и объем под задачу.

В каталоге есть разные форматы подключения, включая те, что подходят для инфраструктурных задач и больших объемов запросов. Для бизнеса это часто быстрее, чем разворачивать узел с нуля. Особенно когда нужен не один адрес, а пул с ротацией и понятными лимитами.

Логика простая. Разовая техническая задача - берите готовое. Нужен полный контроль над трафиком, инфраструктурой и логами - свой сервер и web proxy. Одно другому не мешает: многие команды используют оба подхода параллельно.

Проверка и типичные грабли

После запуска telEgo с флагом -l он печатает WEB-ссылку. Ее можно добавить в Telegram Desktop и проверить подключение вручную. Самый быстрый способ понять, что цепочка собралась. Если ссылка открывается, а соединения нет, смотрите логи Nginx и telEgo одновременно.

Грабля первая: сертификат. Просроченный или самоподписанный клиент не примет. Вторая: неверный base-path, запрос уходит не туда. Третья: забытый reload Nginx после правки конфига. Четвертая: внутренние порты случайно открыты наружу, и смысл приватного контура испаряется. Пятая: неверный тип подключения в клиенте, когда MTProto-секрет вставляют в SOCKS5.

Установка прокси не делает соединение автоматически анонимным. Это инструмент маршрутизации и контроля, не магия. Анонимность - отдельный разговор про архитектуру и гигиену, а не про одну кнопку в приложении.

Что делать дальше

Начните с малого: один сервер, один домен, один режим. Добейтесь стабильного соединения на одном устройстве. Потом добавляйте остальное: второго пользователя, вторую локацию, второй тип клиента. Так видно, где именно ломается.

Не экономьте на сертификате и нормальном VPS. Разница в цене между дешевым и нормальным сервером редко превышает стоимость часа вашей работы. Время на дебаг нестабильного соединения съедает куда больше.

Если нужен готовый пул адресов под задачи, где свой узел избыточен, посмотрите каталог прокси. Варианты под разные сценарии там есть, и это часто быстрее, чем собирать инфраструктуру ради одной задачи.

← Вернуться к блогу

Читать дальше