3SELLER Journal 3SELLER →

Как подключить TG WS Proxy: 7 шагов, 3 грабли и логи, которые экономят вечер

16.11.2026

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

Дальше подключение по шагам: без экзотики, с реальными граблями, которые я собирал сам. И с объяснением, что происходит внутри, чтобы вы не тыкали наугад.

Каталог прокси 3seller

Если свой узел поднимать не хочется, а контролируемый доступ нужен сегодня, посмотрите каталог прокси. Там есть готовые решения под разные задачи, от MTProto до SOCKS5.

Что такое TG WS Proxy и где он реально пригодится

TG WS Proxy это локальный сервер, который принимает MTProto-трафик от Telegram и передаёт его дальше через WebSocket. Грубо говоря, вы ставите на компьютер или телефон маленький шлюз. Telegram думает, что общается с прокси, а прокси уже сам договаривается с дата-центром.

В рабочей инфраструктуре у него четыре сценария. Первый: публичный Wi-Fi в кафе, аэропорту, коворкинге. Сеть вам не принадлежит, а трафик идёт через ваш узел, а не растворяется в чужом оборудовании. Второй: корпоративный сегмент, где нужен единый контролируемый выход для команды. Третий: несколько устройств на одном узле и логи в одном месте. Четвёртый: нестабильный канал, где прямое соединение рвётся на длинных сессиях.

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

Архитектура: что происходит между Telegram и вашим узлом

Схема простая: Telegram Desktop → MTProto-прокси на локальном адресе → WebSocket → дата-центр Telegram. Клиент отправляет пакеты на петлевой интерфейс, сервер принимает их и оборачивает в WebSocket-соединение. Дальше трафик идёт по сети до инфраструктуры Telegram.

MTProto-прокси не расшифровывает переписку. Шифрование остаётся на стороне клиента и серверов Telegram. Прокси видит только маршрут и служебные параметры. От наивного представления, будто прокси читает ваши сообщения, это отличается радикально. Не читает.

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

В конфиге есть режим FakeTLS. Он меняет обёртку трафика, чтобы соединение выглядело как обычный защищённый обмен. С точки зрения архитектуры это ещё один слой маскировки для сетей с глубокой инспекцией пакетов. Настройка не обязательная, но в некоторых окружениях без неё соединение поднимается нестабильно.

SOCKS5 работает на уровне TCP и не знает особенностей Telegram. MTProto-прокси понимает структуру пакетов мессенджера, поэтому лучше держит сессии и не рвёт длинные соединения. Для парсинга и корпоративных задач иногда нужен именно SOCKS5, для Telegram обычно выигрывает MTProto.

Чем локальный узел отличается от VPN и обычного SOCKS5

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

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

VPN полезен, когда нужен общий защищённый канал для всего устройства. Локальный прокси полезен, когда нужен точечный маршрут для Telegram и прозрачная диагностика. Смешивать задачи не стоит: получите сложную схему, которую потом сам не разберёшь.

Подготовка: сборка, разрешения и антивирус

Скачиваем сборку со страницы релизов проекта. На Windows это обычный установщик или архив, на Android APK. Первый запуск может сопроводиться предупреждением SmartScreen. Нормально для небольших утилит без платной подписи. Проверяйте источник и контрольные суммы, если они опубликованы.

На Android приложение попросит разрешение на работу в фоне. Соглашаемся. Без этого система прибьёт процесс через несколько минут, и вы будете ловить обрывы, списывая их на плохой прокси. Ещё одно разрешение: уведомления. Они нужны, чтобы видеть статус и быстро вернуться в приложение.

На Windows антивирус может ругнуться на сетевой сервис. Добавляем в исключения папку с программой и порт, который слушает узел. Если корпоративный антивирус управляется политикой, проще сразу согласовать запуск с админом. Иначе он тихо заблокирует входящие соединения, а вы будете искать проблему в Telegram.

Настройка Telegram Desktop: автоматический путь

Самый быстрый способ: правой кнопкой по значку в трее, пункт «Открыть в Telegram». Программа сама сформирует ссылку и передаст её клиенту. Откроется окно с предложением подключить прокси. Жмём «Подключить» и проверяем соединение.

Если Telegram не открылся с подключением, не паникуем. В том же меню трея есть «Скопировать ссылку». Отправляем её в «Избранное» в Telegram и кликаем по ней левой кнопкой мыши. После этого клиент предложит подключиться. Такой путь работает, когда протокол tg:// не назначен или система потеряла ассоциацию.

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

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

Идём в Telegram → Настройки → Продвинутые настройки → Тип подключения → Прокси. Нажимаем «Добавить прокси». Дальше заполняем поля.

  1. Тип: MTProto.
  2. Сервер: 127.0.0.1, если прокси запущен на этом же компьютере.
  3. Порт: 1443 или тот, что указан в конфиге.
  4. Secret: из настроек или логов. Логин и пароль оставляем пустыми.

Сохраняем и проверяем соединение. Если Telegram пишет, что прокси недоступен, сначала смотрим, запущен ли сервер. Потом проверяем порт. Потом логи. В девяноста процентах случаев проблема в одном из этих трёх пунктов.

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

Меняли порт в конфиге - вписывайте своё значение. Типовая настройка на 1443 это лишь значение по умолчанию. Никакой магии в нём нет.

Как подключить телефон или второй компьютер к тому же узлу

Здесь начинается классическая ошибка. На телефоне в поле сервера вписывают 127.0.0.1 и удивляются, что ничего не работает. Локальный адрес петли на телефоне указывает на сам телефон, а не на компьютер с прокси. Нужен IP компьютера в локальной сети. В обсуждениях на Reddit про локальные MTProto-прокси всплывает ровно этот же промах, чаще всех остальных.

Второй момент: сервер должен слушать не только localhost. При запуске добавьте параметр --host 0.0.0.0. Без него узел принимает соединения только с той же машины. С этим параметром он открывается для устройств в сети, но не для всего интернета, если у вас нет проброса портов. Для домашней или офисной сети этого достаточно.

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

На телефоне в настройках прокси указываем IP компьютера и тот же порт. Тип MTProto. Логин и пароль пустые. Секрет должен совпадать с тем, что в конфиге. После сохранения проверяем соединение.

Телефон не подключается, а компьютер подключается - смотрим логи на компьютере. Видно ли попытку соединения с адреса телефона. Если нет, проблема в сети или фаерволе. Если да, но соединение рвётся, смотрим секрет и версию клиента.

Что делать, если tg:// ссылка не открывается

Telegram Desktop не назначен обработчиком протокола tg://. В Windows это лечится в параметрах системы: приложения по умолчанию, выбор приложений по протоколу, tg. Если пункта нет, переустановите Telegram Desktop. При установке он обычно сам забирает ассоциацию.

Второй путь: скопировать ссылку через трей и отправить её в «Избранное». Клик по ссылке внутри Telegram открывает то же окно подключения. Работает даже когда система не понимает протокол.

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

Меню трея: скрытые функции, которые экономят время

В трее есть несколько пунктов, о которых вспоминают не сразу. «Открыть в Telegram» запускает автоматическую настройку. «Скопировать ссылку» даёт тот самый tg:// адрес для ручного клика. «Перезапустить прокси» перезапускает сервер без выхода из приложения. «Настройки» открывает графический редактор конфига. «Открыть логи» показывает файл с диагностикой. «Выход» останавливает прокси и закрывает приложение.

После правки конфига обязательно перезапускаем сервер. Многие забывают и потом ищут, почему новые параметры не применились. Я сам так попадался: поменял порт, нажал сохранить, а процесс остался на старом. Перезапуск решает.

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

Android: нюансы, о которых не пишут в инструкциях

На Android первый запуск просит разрешение на фоновую работу и уведомления. Выдаём оба. Дальше жмём «Запустить Proxy», затем «Применить в Telegram». Откроется Telegram с предложением подключить прокси. Жмём «Подключить».

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

Ещё одна деталь: оптимизация расхода заряда. Если система агрессивно убивает фоновые процессы, прокси будет жить до первого сворачивания приложения. Отключите оптимизацию для TG WS Proxy в настройках батареи. На разных прошивках путь отличается, но смысл один: дайте приложению работать в фоне.

Логи на Android открываются из приложения. Вкладка «Логи», кнопка копирования в правом верхнем углу. Если готовите баг-репорт, копируйте весь лог, а не последнюю строку. По одной строке причину не найти.

Логи и диагностика: как читать, а не гадать

Лог это не страшный текст для избранных. Смотрим последовательность. Сначала сервер стартует и занимает порт. Потом появляется попытка подключения от клиента. Потом устанавливается соединение с дата-центром. Если на каком-то шаге тишина, там и проблема.

Занятый порт даёт в логе ошибку привязки. Значит, другой процесс уже слушает это значение. Меняем порт или закрываем старый процесс. Невидимая ошибка, которая съедает время.

Попытки подключения от телефона в логе нет - смотрим сеть и фаервол. Клиент просто не достучался до узла. Если попытка есть, но соединение рвётся, проверяем секрет и режим FakeTLS.

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

Типичные ошибки и как их не допустить

Первая и самая частая: на телефоне указан локальный адрес петли вместо IP компьютера. Вторая: сервер запущен без параметра --host 0.0.0.0, поэтому другие устройства его не видят. Третья: фаервол блокирует входящие. Четвёртая: порт занят другим приложением. Пятая: в клиенте выбран SOCKS5 вместо MTProto. Шестая: секрет не совпадает с конфигом. Седьмая: после правки конфига не было перезапуска.

Отдельно про версии. Старый клиент и новая сборка могут не понять друг друга. Если обновили сервер, обновите и клиент. Если обновили клиент, проверьте, не поменялись ли параметры по умолчанию.

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

Производительность: где узкое место

Узкое место обычно не в самом прокси, а в канале и в количестве одновременных сессий. Один локальный узел спокойно держит несколько устройств в домашней сети. Для команды из десятков человек нужен нормальный сервер, а не ноутбук под столом.

WebSocket снижает накладные расходы, но не отменяет физику. Задержка зависит от расстояния до дата-центра и качества сети. Если провайдер даёт нестабильный канал, никакая настройка это не исправит. Прокси может сгладить рывки, но не создаст пропускную способность из воздуха.

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

Безопасность: что реально защищает, а что нет

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

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

Секрет прокси тоже не стоит светить. Это не пароль от аккаунта, но лишняя публикация параметров узла ни к чему. Для корпоративного сегмента лучше выдавать доступ по сети и не разбрасываться конфигом.

Автозапуск и стабильность

Если узел нужен постоянно, добавьте его в автозагрузку. На Windows это ярлык в папке автозагрузки или задача в планировщике. На Android приложение само просит разрешение на фоновую работу. На Linux удобнее systemd-юнит, но это уже для тех, кто дружит с терминалом.

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

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

Обновления и совместимость

Обновляйте сборку осознанно. Новые версии могут менять параметры по умолчанию, порты или формат конфига. Перед обновлением на всей команде проверьте одну машину. Если всё работает, катите дальше.

Клиент и сервер должны понимать друг друга. Старый Telegram Desktop может не поддержать новый режим, новая сборка может изменить поведение FakeTLS. Читайте changelog, если он есть. Если нет, тестируйте на одном устройстве.

Фиксация версии помогает, когда узел работает в корпоративной среде. Обновление по кнопке в разгар рабочего дня редко заканчивается хорошо.

Короткие ответы на частые сомнения

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

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

VPN вместе с прокси обычно не нужен. Если вы используете VPN для всей сети, локальный прокси может конфликтовать с маршрутами. Проверяйте схему на одном устройстве, прежде чем раскатывать.

Провайдер режет WebSocket - попробуйте другой порт или режим. Но не рассчитывайте, что одна настройка решит все проблемы. Сеть может вести себя по-разному в разное время.

Когда локальный прокси не нужен, а когда без него больно

Если вы один пользователь, сеть стабильна, а устройства два, локальный узел даёт немного. Проще подключиться напрямую. Если же у вас публичный Wi-Fi, удалённая команда, несколько устройств и желание видеть логи, смысл появляется быстро.

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

Для парсинга и бизнес-задач иногда нужен SOCKS5, а не MTProto. Тогда логично держать оба типа узлов и переключать клиентов по задаче. Каталог прокси в этом смысле удобен: можно подобрать тип под конкретный сценарий, не собирая инфраструктуру с нуля.

Если времени нет, а узел нужен сегодня, посмотрите каталог прокси 3seller. Там есть готовые варианты с разными протоколами. Свой сервер даёт максимум контроля, готовый узел экономит часы. Выбор зависит от задачи, не от моды.

Практический шаг, который стоит сделать сегодня

Поднимите один узел. Не десять, не кластер, один. Подключите одно устройство. Посмотрите логи. Убедитесь, что соединение держится хотя бы полчаса. Потом добавьте второе устройство и проверьте сетевой сценарий с --host 0.0.0.0. Так вы поймёте, где именно у вас узкое место, и не будете чинить всё сразу.

И держите под рукой каталог прокси на случай, когда свой узел недоступен или нужен другой протокол. 3seller.com/proxy это не волшебная кнопка, но нормальный набор вариантов, когда нужно быстро проверить гипотезу или закрыть задачу без сборки инфраструктуры.

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

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