3SELLER Journal 3SELLER →

Tg ws proxy github как установить за вечер: 7 граблей и 3 поля

19.11.2026

Скачал релиз tg-ws-proxy, запустил, а Telegram так и висит на «Подключение». Первая установка заняла сорок минут, хотя по инструкции должно было уйти пять. Поле называлось Secret, и я вставил туда ссылку вместо ключа. Ниже рабочий маршрут: от страницы релизов на GitHub до зеленого значка в трее. Без магии, с командами и местами, где спотыкается почти каждый.

tg-ws-proxy - это локальный MTProto-прокси, который поднимается на вашей машине и перекладывает трафик Telegram в WebSocket. Он не заменяет VPN и не дает анонимности. Задача другая: сделать соединение ровнее в сетях, где обычный MTProto теряет пакеты или долго устанавливает сессию. Для бизнеса это способ стабилизировать доступ к рабочему мессенджеру, для аналитики - убрать часть задержек при парсинге открытых каналов.

Если вам нужен не один локальный узел, а пул адресов для команды, парсинга или корпоративного шлюза, посмотрите каталог прокси 3seller.com/proxy. Там я добираю недостающие узлы, когда локальной схемы уже мало. Сначала - база.

Каталог прокси для команд, парсинга и корпоративных задач

Что вы ставите на самом деле

tg-ws-proxy - не облачный сервис и не «прокси от разработчика». Оно слушает локальный адрес на вашем компьютере. Telegram подключается к нему как к обычному MTProto-прокси. Дальше приложение само открывает WebSocket-соединение до дата-центра Telegram. Получается прослойка между клиентом и сервером, которая меняет транспорт.

У проекта есть несколько форм: tray-приложение для Windows и macOS, CLI для Linux, Docker-образ для серверов. В трее видно статус, можно скопировать ссылку и открыть Telegram в одно нажатие. CLI удобнее для сервера, где нет графической сессии. Docker нужен, когда вы раскатываете схему на команду или ставите ее за reverse proxy.

Прокси не шифрует ваши сообщения дополнительным слоем. Шифрование MTProto остается на месте, WebSocket лишь упаковывает пакеты. Он также не скрывает ваш адрес от Telegram. Это транспортная оптимизация, а не средство анонимности. Это снимает половину странных ожиданий.

Как это работает под капотом

Схема простая: Telegram Desktop подключается к локальному MTProto-прокси, тот заворачивает поток в WebSocket и отправляет его до Telegram DC. На выходе получается обычный TLS-трафик, который реже режут сети с агрессивным шейпингом. Для клиента ничего не меняется, он по-прежнему думает, что общается с прокси.

Секрет в настройках - это общий ключ. Он подтверждает, что клиент имеет право пользоваться этим прокси. Если секрет не совпал, Telegram будет висеть на подключении, а в логах появится ошибка авторизации. Секрет можно посмотреть в настройках tray-приложения или в логах контейнера. Копировать его нужно целиком, без пробелов и переносов строк.

WebSocket держит долгоживущее соединение и умеет keepalive. В нестабильных сетях это снижает количество повторных рукопожатий. SOCKS5-режим, который есть в некоторых сборках, полезен для других приложений: браузера, парсера, клиента API. Для Telegram чаще берут MTProto, для скриптов удобнее SOCKS5.

Cloudflare Worker и fake TLS - дополнительные надстройки. Worker дает внешний upstream, но добавляет зависимость от внешнего сервиса и лишний хоп. Fake TLS меняет вид рукопожатия, но не ускоряет соединение. Я использую их только если без них схема не держит нагрузку. В обычном сценарии достаточно локального прокси и прямого WebSocket.

Подготовка до установки

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

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

Определитесь с режимом. Для домашнего компьютера берите tray-версию. Для сервера без графики - CLI. Для команды - Docker. Заранее решите, будет ли прокси работать постоянно или только на время сессии. От этого зависит, нужен ли автозапуск и systemd-юнит.

Windows: установка и первый запуск

Откройте страницу релизов проекта на GitHub и скачайте сборку для Windows. Обычно это установщик или портативный файл. Запустите от имени пользователя, не от администратора, если не требуется установка в системную папку. SmartScreen может показать предупреждение. Нажмите «Подробнее» и «Выполнить в любом случае», если скачали из официального источника.

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

Ручная настройка тоже работает. В Telegram откройте «Настройки», затем «Продвинутые настройки», «Тип подключения», «Прокси». Добавьте новый прокси. Тип: MTProto. Сервер: loopback-адрес, который показывает приложение. Порт: тот, что указан в конфиге. Secret: из настроек или логов. Сохраните и включите прокси.

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

macOS: dmg или сборка из исходников

Для macOS есть универсальный dmg. Скачайте его, откройте и перетащите приложение в «Программы». При первом запуске Gatekeeper может заблокировать приложение. Зайдите в «Системные настройки», «Конфиденциальность и безопасность» и разрешите запуск. После этого в строке меню появится значок прокси.

Сборка из исходников выглядит так: клонируйте репозиторий, создайте виртуальное окружение, установите пакет через pip и запустите tray-версию для macOS. Команды есть в README. Понадобятся Xcode Command Line Tools. Если не хотите возиться с зависимостями, берите dmg. Разница в функциональности минимальная.

Дальше настройка Telegram такая же, как на Windows. «Настройки», «Продвинутые настройки», «Тип подключения», «Прокси», добавить MTProto. Сервер, порт и секрет берите из приложения. После сохранения включите переключатель. На macOS я советую сразу добавить приложение в автозагрузку, иначе после перезагрузки прокси не поднимется.

Linux: deb, rpm и AUR

Для Debian и Ubuntu есть deb-пакет. Установка с зависимостями: sudo apt install ./TgWsProxy_linux_amd64.deb. Для Red Hat и Fedora: sudo rpm -i ./TgWsProxy_linux_amd64.rpm. Для Arch Linux удобнее AUR: yay -S tg-ws-proxy-bin. В AUR есть варианты -git и -cli, они отличаются способом сборки и набором компонентов.

На сервере без графики берите CLI-версию. После установки проверьте, что процесс запущен: systemctl status tg-ws-proxy или ps aux | grep tg-ws. Логи смотрите через journalctl -u tg-ws-proxy -f. Если сервис не стартует, проверьте конфиг и права на файл секрета.

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

Docker: серверный вариант для команды

Docker удобен, когда прокси нужен не вам одному. Соберите образ из официального репозитория: docker build -t tg-ws-proxy .. Запустите контейнер с переменной окружения для секрета и пробросом локального порта. Секрет храните в env-файле или в секретах оркестратора, не в истории команд. Иначе он останется в ~/.bash_history.

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

Не запускайте контейнер с --privileged без необходимости. Прокси не нужен доступ к хосту. Достаточно проброса одного порта и read-only монтирования конфига. Логи выведите в stdout, чтобы их собирал Docker. Для отладки используйте docker logs -f.

Настройка Telegram: три поля и одна кнопка

Откройте Telegram Desktop. «Настройки», «Продвинутые настройки», «Тип подключения», «Прокси». Нажмите «Добавить прокси». В типе выберите MTProto. В поле сервера укажите loopback-адрес, который показывает приложение. В поле порта вставьте значение из конфига. В поле секрета вставьте секрет из настроек или логов. Сохраните.

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

Для SOCKS5-режима тип будет другим. Его имеет смысл включать для браузера или парсера, но не для Telegram. Если вы перепутаете тип, клиент не подключится, даже если секрет верный. Это вторая по частоте ошибка после пробела в секрете.

Почему не подключается: шесть причин

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

Вторая причина: прокси не запущен. Tray-приложение могло закрыться, контейнер остановиться, сервис упасть. Проверьте статус в трее или через docker ps. Перезапустите и подождите пару секунд.

Третья причина: неверный тип. MTProto и SOCKS5 не взаимозаменяемы. Telegram ждет MTProto, а вы дали SOCKS5. Проверьте выпадающий список.

Четвертая причина: локальный firewall или антивирус. Они могут блокировать соединение между Telegram и прокси. Добавьте исключение для приложения и для локального адреса. На Linux проверьте ufw status и правила iptables.

Пятая причина: Cloudflare Worker или домен. Если вы используете upstream, проверьте, что Worker задеплоен, домен проксируется и TLS-сертификат валиден. Ошибка в маршруте дает те же симптомы, что и неверный секрет. Смотрите логи прокси, там будет конкретный код.

Шестая, редкая причина: кэш Telegram. Клиент мог запомнить старое подключение. Удалите прокси из списка, перезапустите Telegram и добавьте заново. На macOS помогает полный выход через меню, а не закрытие окна.

Официальный репозиторий и фейковые форки

Вокруг популярных прокси всегда появляются клоны. Я видел форк с именем, которое отличалось одной буквой от оригинала. Внутри был измененный бинарник и скрипт установки, который тянул лишнее. Скачивайте только со страницы официального репозитория. Проверяйте, что автор совпадает, а релиз имеет внятное описание. На GitHub в issues проекта чаще всего просят сравнить хеш релиза с опубликованным - это разумный минимум.

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

Не запускайте прокси от root. Ему достаточно прав обычного пользователя. Ограничьте доступ к конфигу с секретом: chmod 600. В Docker не передавайте секрет через аргументы командной строки, используйте env-файл. Эти мелочи закрывают большинство бытовых рисков.

Android-форк: что там с настройками

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

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

Когда локального прокси мало: VPS, корпоративный узел, парсинг

Локальный tg-ws-proxy хорош для одного человека и одной машины. Как только пользователей становится больше пяти, начинаются проблемы. У каждого свой секрет, свои логи, свой ноутбук, который закрывают в конце дня. Команда просит стабильный адрес, аналитики просят пул для парсинга, безопасники просят логи и ограничения. Локальная схема тут заканчивается.

Есть два пути. Первый: свой VPS. Вы поднимаете прокси на сервере, ставите TLS, ограничиваете доступ по адресам и настраиваете мониторинг. Второй: готовый каталог прокси, где можно выбрать узел под задачу. Для команды важны стабильность и поддержка, для парсинга - ротация и география, для корпоративного шлюза - протоколы и лимиты.

В каталоге 3seller.com/proxy я смотрю на три параметра. Протокол: для Telegram нужен MTProto или SOCKS5, для скриптов часто достаточно HTTP. География: для парсинга открытых данных важна страна выхода. Лимиты: сколько одновременных соединений держит узел и что будет при превышении. По этим трем пунктам можно отсеять половину предложений еще до покупки.

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

Если вы поднимаете свой VPS, начните с минимальной конфигурации: один процесс, systemd, логи в journald, обновление раз в месяц. Не ставьте все на прод без теста. Прогоните нагрузку на тестовом канале, проверьте, как ведет себя прокси при обрыве связи и перезагрузке. Только потом переводите команду.

Проверка после установки

Отправьте тестовое сообщение в «Избранное». Проверьте, что оно дошло и что медиа загружается. Откройте канал с большим количеством сообщений и пролистайте его. Если подгрузка идет без пауз, транспорт работает. Сравните поведение до и после: иногда разница не в скорости, а в стабильности.

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

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

Сделайте тестовый прогон на одном устройстве, прежде чем раскатывать на команду. Запишите последовательность действий, которая сработала именно у вас: версия, источник, набор полей. Через месяц вы скажете себе спасибо, когда придется повторять установку на новом ноутбуке. А если локальной схемы станет мало, вернитесь к каталогу 3seller.com/proxy и соберите пул под задачу.

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

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