Сначала поймите, что именно вы запускаете
Главная ошибка новичка: он ищет WS-прокси как очередной сервер в интернете, куда вписывают адрес и порт. Схема другая. TG WS Proxy - это приложение на вашем же устройстве. Оно поднимает локальный MTProto-прокси и заворачивает трафик Telegram в WebSocket. Дальше пакеты уходят к дата-центрам через WSS, по тому же типу канала, что и обычный защищённый веб-трафик.
Цепочка на практике: клиент Telegram стучится на локальный адрес, приложение принимает соединение, переупаковывает его в WebSocket-кадры и отправляет на сервер. Клиент видит обычный MTProto-прокси и не догадывается, что внутри WebSocket. В конфиге по умолчанию loopback-адрес и порт из настроек приложения. Логин с паролем пустые, авторизация здесь не нужна.
Прослойка нужна из-за нестабильности прямого канала. В сетях, где MTProto-соединение до дата-центров режется по типу трафика, WebSocket поверх TLS проходит ровнее. Не из-за волшебного шифрования, а потому что для сетевого оборудования это обычный HTTPS. Тему telegram ws proxy как пользоваться разбирают один раз. Дальше приложение живёт в трее или в фоне, и вы про него забываете.

Android: от APK до рабочего чата за пять минут
Берите свежий APK со страницы релизов проекта, а не с левых зеркал и не из случайных каналов. Разница в сборках важна: старые версии отваливаются на рукопожатии. Вы потом полчаса ищете проблему в настройках, хотя она в двухмесячной сборке.
- Скачиваете актуальный APK и ставите на телефон. Android спросит разрешение на установку из неизвестного источника, это нормально.
- Открываете приложение TG WS Proxy.
- Читаете справку внутри. Там правда написано всё, что нужно, включая разбор типовых ошибок.
- Жмёте «Запустить прокси». Появляется уведомление о работе в фоне.
- Жмёте «Применить в Telegram». Открывается клиент, остаётся подтвердить подключение.
- Проверяете: отправляете себе сообщение и смотрите, уходит ли оно без задержки.
Деталь, которой нет в справке. На Android 12 и выше система убивает фоновое приложение при экономии заряда. Зайдите в настройки батареи и снимите ограничение для TG WS Proxy. Иначе прокси тихо умрёт через двадцать минут после блокировки экрана. Telegram будет висеть на «Обновление соединения», и вы решите, что прокси сломался, хотя его выгрузили из памяти.
Кнопка «Применить в Telegram» работает через tg:// ссылку. Параметры улетают в совместимые клиенты: обычный Telegram, Plus Messenger, NekoGram, AyuGram. Если жмёте и ничего не происходит, ссылку перехватило другое приложение или клиент не зарегистрировал обработчик. Тогда идём в ручную настройку, она ниже.
ПК: трей, автозапуск и засада с tg://
На десктопе логика та же, интерфейс другой. Скачиваете сборку под свою платформу со страницы релизов и кладёте в папку, из которой не удалите случайно. Банально, но из-за переноса файла отваливается автозагрузка: ярлык ссылается на старый путь, приложение не стартует, прокси молчит.
Запускаете исполняемый файл. В трее появляется иконка с буквой Т на синем фоне. Клик открывает Telegram и предлагает подключиться к локальному прокси, остаётся подтвердить. Если окно не выскочило, жмёте правой кнопкой по иконке и выбираете «Открыть в Telegram». Это самый надёжный путь.
Автозапуск настраивается там же: правой кнопкой по иконке, «Настройки», пролистываете в самый низ, ставите галочку «Запускать при включении компьютера», сохраняете. Делайте сразу, а не через неделю, когда утром мессенджер не работает и надо искать exe по папкам.
Отдельная засада, на которой спотыкаются почти все. Ссылка tg:// не открывается, потому что в системе за этот протокол не назначено приложение. Лечится установкой Telegram Desktop и назначением его обработчиком протокола в настройках ОС. Пока этого не сделано, кнопка «Открыть в Telegram» молча ничего не делает, и вы решите, что проблема в прокси.
Ручная настройка MTProto: когда кнопка не сработала
Иногда автоматика не проходит: нестандартный клиент, обрезанные права, корпоративная сборка Telegram. Тогда параметры вбиваются руками, и это занимает минуту.
- В Telegram: Настройки, затем Продвинутые, затем Тип подключения, затем Прокси.
- Добавить прокси.
- Тип: MTProto.
- Сервер: локальный loopback-адрес, тот же, что указан в приложении-прокси.
- Порт: значение из конфига приложения.
- Логин и пароль оставляете пустыми.
- Сохраняете и включаете прокси.
Самая частая ошибка: выбрать SOCKS5 вместо MTProto. Внешне поля те же, соединение устанавливается, но сообщения не ходят. Тип должен совпадать с тем, что реально слушает приложение. Вторая по частоте: вписать внешний адрес вместо локального при работе на одном устройстве. Локальный прокси слушает сам себя, адрес из интернета ему не нужен.
Поменяли порт в приложении - поменяйте и в клиенте. Рассинхрон на этом уровне даёт вечное «Соединение» без внятной ошибки. Диагностировать глазами невозможно, только сверкой двух экранов.
Один прокси на всю квартиру или офис
Локальный прокси не обязан жить в пределах одного устройства. Компьютер с запущенным приложением принимает подключения из локальной сети, и телефон, планшет, ноутбук ходят через один узел. Удобно, когда надо поднять рабочее место без установки софта на каждую машину.
Для этого приложение запускают с параметром, разрешающим слушать внешние подключения, а не только локальный интерфейс. В конфигурации это bind на все интерфейсы. В клиенте на другом устройстве указываете адрес компьютера в вашей сети и тот же порт. Тип подключения остаётся MTProto, логин с паролем пустые.
Три вещи до первого подключения. Убедиться, что устройства в одной подсети, а не в гостевом Wi-Fi с изоляцией клиентов, иначе они физически не увидят друг друга. Разрешить входящие соединения в файрволе для этого порта. И понимать, что при выключении компьютера связь пропадёт у всех сразу.
В офисах с сегментированной сетью такой узел ставят на машину, которая включена круглосуточно. Звучит как костыль, но работает годами. Главное - не трогать системные обновления в момент, когда всем срочно надо отправить файл.
Фото и видео не грузятся, а текст летает
Сообщения уходят мгновенно, картинки висят на нуле процентов. Причина в архитектуре: разные типы данных лежат на разных дата-центрах, и маршрут до конкретного узла может быть хуже остальных. Прокси при этом рабочий, просто один из каналов до медиа-серверов тормозит.
Что делать по шагам. Открываете настройки приложения-прокси и смотрите, включено ли проксирование через CloudFlare. Этот маршрут часто спасает медиа, потому что идёт через инфраструктуру CDN с нормальными пирами. Не помогло - переключаетесь на прямую схему без промежуточного слоя и проверяете снова. Иногда результат обратный, всё зависит от провайдера и времени суток.
Второй приём: почистить кэш медиа в самом Telegram. Клиент хранит битые недокачанные фрагменты и упорно тянет их снова по тому же плохому маршруту. После очистки загрузка часто идёт с первого раза.
Третий момент, про который мало кто знает. В настройках десктопной версии есть список адресов дата-центров. Если там накопился мусор от предыдущих экспериментов, медиа ломается выборочно. Оставляете только актуальные записи, сохраняете, перезапускаете прокси. В половине случаев именно это и решает проблему.
Шифрование, задержки и зачем вообще WebSocket
Пакеты внутри MTProto уже зашифрованы, WebSocket меняет только транспорт. Дополнительный слой TLS даёт то, что снаружи соединение неотличимо от обычного HTTPS к популярному сайту. Для корпоративных сетей с инспекцией трафика это принципиально: чем меньше соединение выделяется на общем фоне, тем стабильнее живёт.
По задержке честно: локальный прокси добавляет один хоп внутри устройства, это доли миллисекунды. Основная задержка появляется на маршруте до дата-центра и зависит от узла. Поэтому «прокси тормозит» чаще всего означает «плохой маршрут до конкретного дата-центра», а не «приложение медленное».
Про FakeTLS отдельно. Часть сборок маскирует рукопожатие под обычный TLS-обмен с популярным доменом. На стабильность связи в домашней сети это почти не влияет, зато помогает там, где трафик анализируют по сигнатурам. Включать или нет - решайте по ситуации. Иногда опция добавляет лишний шаг и замедляет старт.
Где локальная схема честно проигрывает
TG WS Proxy решает задачу «один человек, одно устройство, стабильный чат». Как только задач становится больше, начинаются ограничения.
Прокси живёт на вашем устройстве. Выключили телефон или ноутбук - связи нет. Для рабочего мессенджера нормально, для круглосуточного сценария уже нет.
Один узел на один аккаунт. Мультиаккаунт в арбитраже, несколько рабочих профилей, разные гео для проектов: локальный прокси тут не помощник, он не умеет ротацию и не даёт разных адресов.
Нет географии. Все запросы уходят из вашей сети. Если нужен IP другой страны для проверки выдачи, парсинга или работы с региональными сервисами, локальная схема бесполезна.
Нет управления пулом. Парсинг каналов, массовые проверки, сбор статистики по десяткам сессий требуют списка узлов с понятным состоянием: жив, мёртв, какая нагрузка, какая страна. Локальное приложение такое не показывает и не должно.
Именно на этом этапе народ идёт в каталог прокси 3seller. Там не «одна кнопка», а список узлов с фильтрами по стране, типу и назначению. Это закрывает сценарии, где локальный WS-прокси упирается в потолок. Для чата на телефоне каталог не нужен, для работы с десятью аккаунтами и парсером без него никак.
Практика простая: держите локальный WS-прокси как быстрый инструмент под рукой, а под задачи с объёмом берите пул из каталога. Смешивать эти роли в одном инструменте и удивляться, почему ничего не масштабируется, не стоит.
Пять симптомов и что они означают
«Обновление соединения» бесконечно. В девяти случаях из десяти приложение-прокси не запущено или его убила система. Проверяйте уведомление в шторке, а не настройки Telegram.
Прокси зелёный, сообщения не уходят. Несовпадение типа: в клиенте выбран SOCKS5, приложение слушает MTProto. Или порт в клиенте отличается от порта в конфиге.
Подключилось, но медиа не идёт. Проблема в маршруте до медиа-серверов. Переключите схему проксирования, почистите кэш, проверьте список дата-центров в десктопном клиенте.
После перезагрузки всё сломалось. Не настроен автозапуск или переместили папку с программой. Проверьте путь к исполняемому файлу.
Работает на телефоне, не работает на ноутбуке. Для сетевого режима либо файрвол режет порт, либо устройства в разных подсетях, либо приложение запущено без разрешения внешних подключений.
Что сделать прямо сейчас
Поставьте актуальную сборку, запустите прокси, примените в Telegram через кнопку или вручную через MTProto. Снимите ограничение батареи на Android, настройте автозапуск на ПК, назначьте Telegram Desktop обработчиком tg://. Эти четыре действия закрывают почти все проблемы, с которыми люди приходят в чаты поддержки.
Дальше живите спокойно, пока задача не вырастет. Как только понадобятся разные гео, ротация и десяток сессий одновременно, локальное приложение честно скажет «дальше сам». Под такие сценарии берите пул узлов в каталоге 3seller и не пытайтесь выжать из одного локального прокси то, чего в нём нет по конструкции.