3SELLER Journal 3SELLER →

Как подключить web proxy в телеграмме: 6 шагов от ссылки в чате до своего узла на VPS за 30 минут

21.11.2026

Ссылка вида tg://webproxy прилетает в чат, ты жмёшь, Telegram открывает настройки и молчит. Или приложение пишет «прокси недоступен», хотя сервер живой и пинг идёт. За пару лет я собирал такие узлы не один десяток раз. Почти каждая проблема сводилась к трём вещам: не тот тип прокси в клиенте, кривой конфиг Nginx и потерянный secret. Ниже весь путь целиком - от трёх кликов в Telegram Desktop до своего web proxy на VPS с доменом и сертификатом.

каталог прокси для рабочих задач

Web proxy это не MTProto и не SOCKS5, и путаница тут дорого стоит

Три разных зверя, которые постоянно смешивают в одном разговоре. MTProto прокси работает по своему бинарному протоколу: свой handshake, обычно порт 443, секрет в виде 32 hex-символов. SOCKS5 - обычный TCP-туннель с логином и паролем, порт любой, и ему всё равно, что внутри: Telegram или что-то другое. Web proxy устроен иначе. Клиент ходит на твой домен по HTTPS или WSS, и для сети это выглядит как обычный обмен с сайтом, а не отдельный протокол на нестандартном порту.

Отсюда главное практическое следствие: для web proxy нужен домен и валидный TLS-сертификат. Без них клиент просто не установит соединение. Зато всё живёт на 443, рядом с обычным сайтом, и не приходится держать открытым зоопарк портов. Один публичный порт, один сертификат, понятная схема - удобно и для своего узла, и для корпоративного сегмента.

Подключение по ссылке: самый быстрый путь

Владелец узла прислал готовую ссылку tg://webproxy - задача сводится к одному действию. Открываешь её на том устройстве, где стоит Telegram, приложение само разбирает параметры и предлагает включить прокси. В Desktop это работает даже если мессенджер свёрнут: система передаёт ссылку приложению, дальше подтверждение и переключатель.

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

И сразу про осторожность. В ссылке лежит secret, фактически ключ доступа к узлу. Кидать её в открытые чаты и каналы не стоит: соберут за час, а потом будешь гадать, почему канал забит и скорость упала. Передавай лично или через закрытый канал.

Ручная настройка: куда нажимать в приложении

Telegram Desktop: Настройки, Продвинутые настройки, Тип подключения. Выбираешь пункт с прокси, жмёшь «Добавить прокси». В списке типов ищешь Web proxy - в разных сборках он подписан как Web, Web proxy или HTTPS, зависит от версии и языка интерфейса. Дальше три поля: сервер, порт, секрет. Сервер это домен, не IP. Порт 443. Секрет те 32 символа, которые дал владелец. Сохранил, включил «Использовать прокси», проверил значок активного соединения в шапке.

Android: Настройки, Данные и память, Прокси, Добавить прокси. iOS: Настройки, Данные и память, Прокси. Логика та же, отличается глубина меню. Названия пунктов гуляют от версии к версии. Если не находишь дословно «Web proxy», смотри на тип с HTTPS в названии и на поле для секрета, а не для пароля.

Встроенный прокси гоняет через посредника трафик Telegram, а не всего устройства. Для браузера, парсера или другого софта нужен отдельный инструмент. Многие ждут от настройки больше, чем она даёт, и потом пишут гневные посты.

Что стоит за ссылкой: архитектура узла на telEgo

Теперь со стороны сервера - половина проблем с подключением рождается именно там. Схема, которая у меня стабильно работает: публичный порт 443 принадлежит только telEgo. Программа распознаёт MTProxy handshake и обслуживает такое соединение сама, а обычный TLS передаёт в Nginx, не завершая TLS-сессию. Nginx слушает приватные порты 8443 и 8444 и проксирует запросы на приватный WEB listener telEgo на 8080.

Смысл конструкции: на одном порту живут MTProxy, web proxy и сайт-витрина, если он нужен. Клиент пришёл с MTProto handshake - ушёл в Telegram DC напрямую. Пришёл обычным HTTPS - попал в Nginx, оттуда в WEB-часть, оттуда в Telegram DC. На стороне пользователя никаких танцев с портами.

В конфиге telEgo за это отвечает отдельная секция web-proxy. Без неё WEB listener не поднимется, Nginx будет честно отдавать 502, а ты будешь искать проблему в клиенте, хотя её там нет. Проверял на своей шкуре: сорок минут смотрел в логи Telegram, пока не понял, что секцию просто забыл добавить. На Reddit в обсуждениях self-hosted узлов всплывает тот же нюанс - народ чинит клиент, а секции в конфиге нет.

Nginx: приватные порты, upstream и заголовки

Порядок действий, который я повторяю на каждом новом сервере. Ничего хитрого, но последовательность важна.

  1. Добавляешь в конфиг telEgo секцию web-proxy и включаешь WEB listener на приватном адресе, порт 8080.
  2. Настраиваешь Nginx на приватных портах 8443 и 8444, наружу они не смотрят.
  3. Прописываешь upstream на приватный WEB listener 8080, чтобы Nginx знал, куда отдавать запросы.
  4. Включаешь HTTP/2 на публичном TLS listener, если выбрал режим https-lanes. Без этого часть клиентов будет плеваться ошибками.
  5. Передаёшь заголовки Upgrade и Connection, если выбрал WebSocket. Забыл, и соединение рвётся сразу после рукопожатия.
  6. Проверяешь конфигурацию командой nginx -t, потом перезапускаешь telEgo и перезагружаешь Nginx.

Пункт про nginx -t не для галочки. Опечатка в одном символе имени апстрима - и Nginx не стартует, а ты смотришь на пустой ответ и думаешь, что провайдер шалит. Проверка занимает две секунды и экономит вечер.

Проверка и запуск: флаг -l и логи

telEgo запускается с флагом -l и при старте печатает готовые ссылки. В Docker смотреть так: docker compose logs telego | grep '_link='. В выводе будет и MTProto-ссылка, и WEB-ссылка, её и отдаёшь людям.

Формат WEB-ссылки: tg://webproxy с параметрами server и secret. Server это твой домен, secret - 32 hex-символа. Никаких паролей и логинов. Если в ссылке оказался IP вместо домена, клиент подключится не всегда: сертификат выписан на домен, проверка имени не пройдёт.

Отдельно проверь DNS. Домен должен резолвиться в тот самый сервер, и сразу, а не через минуту после запуска. У меня был случай, когда A-запись обновилась только на половине резолверов: половина людей подключалась, половина нет. Выглядит как магия, лечится ожиданием и проверкой с разных точек.

Как читать ссылку tg://webproxy и не перепутать поля

Разбор ссылки снимает половину вопросов при ручной настройке. server - домен, на который выписан сертификат. secret - ключ, который сгенерировал сервер. Всё. Порт по умолчанию 443, в ссылке он обычно не указан.

Самая частая ошибка новичков: тащат MTProto secret в поле пароля SOCKS5. Это разные вещи, они несовместимы, соединения не будет никогда. Второй по частоте косяк - копируют секрет с обрезанным последним символом, потому что он переносится на новую строку в мессенджере. Сверяй длину: 32 символа, ни больше ни меньше.

И ещё: тип прокси в клиенте должен совпадать с типом на сервере. SOCKS5 не заработает там, где ждут web proxy, даже если порт и хост введены верно. Клиент просто не поймёт, что ты от него хочешь.

websocket, websocket-lanes и https: что выбрать под нагрузку

Транспорт меняется без пересборки узла - удобно. Режим websocket открывает одно соединение wss:// на клиента. Просто, экономно, хорошо для обычного мессенджера с одним активным пользователем.

Режим websocket-lanes создаёт отдельное соединение на каждый поток. Больше накладных расходов, зато при потерях пакетов и нестабильном мобильном интернете ведёт себя заметно бодрее. Слышишь жалобы «на LTE всё отваливается, на Wi-Fi нормально» - почти всегда стоит попробовать lanes.

Режимы https работают через fetch и long polling. Служебного трафика больше, зато проще проходит в сетях, где WebSocket режут на уровне корпоративного шлюза. Выбрал https-lanes - включай HTTP/2 на публичном TLS listener, иначе смысл теряется. Задержка тут выше: для переписки нормально, для потоковой работы с большими объёмами уже чувствуется.

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

Свой узел на VPS это контроль и приватность, но обслуживание: сертификат продлить, конфиг обновить, логи посмотреть, домен не забыть. Если задача не про личный мессенджер, а про работу, выгоднее взять готовое. Для парсинга, сбора данных, проверки выдачи, работы с несколькими аккаунтами и мониторинга нужен обычный пул прокси с нормальной географией и стабильностью, а не один самодельный узел на дешёвом VPS.

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

Граница простая: личный Telegram через свой web proxy на VPS, рабочие процессы с большим объёмом запросов через каталог прокси. Смешивать не надо, задачи разные и требования к узлу разные.

Ошибки, на которых люди теряют вечер

Первая и самая обидная: клиент подключён к прокси, а сервер не видит запросов, потому что 8443 закрыт файрволом. Nginx слушает, наружу не пускает, снаружи тишина. Проверяй правила на приватных портах: из интернета они быть доступны не должны, а локально между telEgo и Nginx работать обязаны.

Вторая: сертификат есть, но выписан на другой домен или просрочен. Клиент отказывается на этапе TLS, а в логах Nginx почти ничего нет. Смотри срок и CN внимательно, это две минуты проверки.

Третья: перезапустили Nginx, но забыли перезапустить telEgo после правки секции web-proxy. Конфиг применился наполовину, WEB listener не поднялся, Nginx отдаёт 502. Правило простое: поменял конфиг telEgo - перезапусти оба.

Четвёртая: выбрали WebSocket и не передали Upgrade с Connection. Соединение устанавливается и мгновенно рвётся, в клиенте это выглядит как бесконечное «подключение». Пятая: забыли HTTP/2 при https-lanes и удивляетесь скорости на уровне диалапа.

Шестая, самая неочевидная: домен резолвится, сертификат в порядке, всё настроено, а человек вставил ссылку на телефоне со старой версией Telegram, которая про web proxy вообще не знает. Первым делом обнови приложение, потом лезь в конфиги.

Что нельзя передавать никому

Код входа в аккаунт и пароль двухэтапной аутентификации не нужны ни владельцу прокси, ни сервису, который этот прокси выдал. Для настройки достаточно домена, порта и секрета. Если кто-то просит код из SMS «для проверки соединения» - это не про прокси, это про попытку угона.

Root-пароль от своего сервера тоже не разбрасывай. Пользуешься ботом-установщиком - понимай, что отдаёшь доступ к машине, и делай это только на чистом VPS, где нет ничего, кроме узла. Секрет прокси и пароль от сервера это разные сущности: утечка первой не означает потерю второй.

С чего начать сегодня

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

Хочется свой узел - порядок такой: домен и сертификат, telEgo с секцией web-proxy, Nginx на приватных портах, nginx -t, перезапуск обоих, запуск с флагом -l, ссылка в клиент. Полчаса спокойной работы, если не спешить с конфигом.

А для рабочих задач с данными и объёмами не изобретай велосипед: возьми нормальный пул в каталоге прокси и займись тем, что реально приносит деньги. Инфраструктура должна быть скучной и предсказуемой, особенно когда под ней крутится что-то важное.

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

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