TGWS GitHub: как скачать и настроить TG WS Proxy для Telegram Desktop

Что такое TGWS и зачем он нужен

TGWS (TG WS Proxy) — это локальный прокси-сервер, который работает на вашем компьютере и перенаправляет трафик Telegram Desktop через защищённые WebSocket-соединения (WSS) к дата-центрам Telegram. В отличие от традиционных VPN-сервисов, TGWS не использует внешние серверы: весь трафик идёт напрямую от вашего устройства к серверам Telegram, но через специальный туннель, который помогает обойти сетевые ограничения.

Основная задача TGWS — обеспечить стабильное подключение Telegram Desktop в сетях, где провайдер или корпоративный файрвол блокирует прямые соединения с IP-адресами Telegram. Приложение перехватывает MTProto-пакеты, извлекает идентификатор дата-центра (DC) и устанавливает WSS-соединение через домены вида kws*.web.telegram.org. Если WebSocket недоступен, происходит автоматический откат на прямое TCP-соединение.

TGWS часто путают с утилитой Zapret, но это разные инструменты. Zapret работает на сетевом уровне и фрагментирует пакеты для обхода DPI, тогда как TGWS — это именно прокси, который настраивается внутри Telegram Desktop как SOCKS5. Поэтому для Telegram Desktop TGWS удобнее: достаточно указать адрес 127.0.0.1 и порт 1080 в настройках мессенджера.

Принцип работы TG WS Proxy

Архитектура TGWS выглядит следующим образом: Telegram Desktop → SOCKS5 (127.0.0.1:1080) → TG WS Proxy → WSS → Telegram DC. Прокси запускается локально и слушает порт 1080 (по умолчанию). Когда Telegram Desktop отправляет запрос на подключение, TGWS анализирует MTProto-пакет и определяет, к какому дата-центру (DC) идёт обращение. Затем он устанавливает WebSocket-соединение с соответствующим доменом Telegram, используя TLS-шифрование.

Ключевая особенность — приоритетное использование WSS. Это позволяет обходить блокировки, которые фильтруют трафик по IP-адресам или протоколам. Если WebSocket-соединение возвращает ошибку 302 или редирект, TGWS автоматически переключается на прямое TCP-соединение, что обеспечивает отказоустойчивость.

Важно понимать, что TGWS не шифрует содержимое сообщений дополнительно — шифрование уже встроено в протокол MTProto. Прокси лишь меняет транспортный уровень, что помогает обойти сетевые фильтры. Это делает TGWS безопасным для аккаунта: учётные данные и модель аутентификации Telegram не изменяются.

Где скачать TGWS: официальный репозиторий GitHub

Единственный официальный источник TGWS — репозиторий на GitHub: github.com/Flowseal/tg-ws-proxy. Скачивать файлы нужно только со страницы релизов (/releases), где доступны последние версии. Никогда не загружайте TGWS со сторонних сайтов, предлагающих «улучшенные версии», «фиксы» или APK — это риск получить вредоносное ПО.

На странице релизов выберите свежую версию с пометкой Latest. Для Windows обычно нужен файл TgWsProxy_windows.exe (для Windows 10 и новее) или TgWsProxy_windows_7_64bit.exe (для Windows 7). Также доступны сборки для macOS (TgWsProxy_macos_universal.dmg) и Linux (.deb или бинарный файл).

После скачивания обязательно распакуйте архив в папку без русских букв и пробелов, например C:\TGWS. Запускать TGWS прямо из архива нельзя — это может привести к ошибкам. Также не добавляйте файл в исключения антивируса, если вы не уверены в его подлинности: проверьте хеш-сумму на VirusTotal.

Пошаговая настройка TGWS в Telegram Desktop

Настройка TGWS занимает несколько минут. Сначала запустите tg-ws-proxy.exe из распакованной папки. Затем откройте Telegram Desktop и перейдите в Настройки → Продвинутые настройки → Тип соединения. Выберите «Использовать собственный прокси» и укажите:

• Тип: SOCKS5
• Сервер: 127.0.0.1
• Порт: 1080
• Логин и пароль: оставьте пустыми

После сохранения настроек статус подключения должен стать синим. Если этого не произошло, полностью закройте Telegram (через трей) и запустите заново.

Альтернативный способ — использовать deep link tg://socks?server=127.0.0.1&port=1080. Вставьте эту строку в адресную строку браузера или отправьте себе в чат — Telegram автоматически предложит добавить прокси с уже заполненными полями.

Для автоматического запуска TGWS при старте Windows создайте ярлык tg-ws-proxy.exe и поместите его в папку автозагрузки (Win+R → shell:startup).

Решение проблем: порт занят, ошибки phail_tg и phail_state

Одна из частых проблем — сообщение «Порт 10808 уже используется другим процессом». Это означает, что другой прокси-клиент (Hiddify, Nekoray, Clash и т.п.) уже занял порт. Чтобы проверить, кто слушает порт, выполните в командной строке netstat -ano | findstr :1080 (или :10808). В последнем столбце будет PID процесса — найдите его в Диспетчере задач.

Решение: закройте лишний прокси-клиент или измените порт TGWS через параметр --port. Например, tg-ws-proxy --port 1081, и затем укажите порт 1081 в настройках Telegram. Не меняйте порты наугад — сначала убедитесь, какой клиент реально работает.

Ошибки phail_tg и phail_state в логах TGWS указывают на неудачное подключение к серверам Telegram или сбой состояния прокси. Чаще всего это связано с:

• запуском TGWS не от имени администратора;
• размещением файла в папке с русскими символами;
• блокировкой файла антивирусом;
• использованием устаревшей версии.

Попробуйте запустить TGWS от имени администратора, переместите его в C:\TGWS и проверьте карантин Защитника Windows.

Почему TGWS не грузит медиа и как это исправить

Симптом: текстовые сообщения проходят, а фото, видео и файлы не загружаются. Это распространённая проблема, связанная с маршрутизацией медиа-трафика. В TGWS используется раздельная стратегия для дата-центров и медиа-серверов, и иногда требуется дополнительная настройка DC mapping.

Один из рекомендуемых шагов — добавить маппинг для дополнительного DC, например 203:149.154.167.220. Это можно сделать через параметр --dc-ip при запуске или в конфигурационном файле config.json.

Также проверьте, что у вас установлена последняя версия TGWS — старые релизы могут не поддерживать новые адреса медиа-серверов. Если проблема сохраняется, попробуйте очистить кеш Telegram (Настройки → Данные и память → Очистить кеш) и перезапустить прокси.

TGWS на других платформах: Linux, macOS и Android

TGWS — кроссплатформенное решение. Для Linux доступны установка через AUR (paru -S tg-ws-proxy-bin), .deb-пакет или бинарный файл. Для macOS — универсальный DMG, который работает на Intel и Apple Silicon. На Linux также можно запустить TGWS как systemd-сервис: sudo systemctl start tg-ws-proxy-cli@1080.

Что касается Android, официального приложения TGWS нет. Проект ориентирован на Telegram Desktop. В сообществе есть экспериментальные порты через Termux, но их стабильность зависит от устройства и сети. Если вам нужен прокси на телефоне, можно использовать TGWS на ПК и настроить доступ по локальной сети: запустите TGWS с параметром --host 0.0.0.0, затем в Telegram на телефоне укажите IP-адрес компьютера и порт 1080. Однако учтите, что для доступа извне потребуется белый IP и проброс портов — мейнтейнер не рекомендует использовать SOCKS для удалённого доступа.

Безопасность, конфиденциальность и ограничения TGWS

TGWS не изменяет модель безопасности Telegram: аутентификация и шифрование остаются на стороне мессенджера. Прокси лишь перенаправляет трафик, поэтому риск для аккаунта минимален. Однако TGWS ведёт служебные логи соединений и отладки — относитесь к ним как к чувствительным данным и не передавайте третьим лицам.

Важно понимать ограничения: TGWS не является полноценным VPN и не скрывает ваш IP-адрес от Telegram. Он лишь помогает обойти сетевые блокировки, но не обеспечивает анонимность. Также скорость работы может быть ниже, чем при прямом подключении, из-за дополнительного уровня WSS.

Антивирусы иногда помечают TGWS как ложное срабатывание (например, Wacatac). Это связано с тем, что прокси-утилиты часто используются вредоносным ПО. Скачивайте только из официальных релизов и проверяйте файлы на VirusTotal. Если Defender блокирует файл, добавьте папку TGWS в исключения, но только после проверки подлинности.

Частые вопросы о TGWS и альтернативы

Пользователи часто спрашивают, нужен ли TGWS, если есть MTProto-прокси или DNS-фильтры. MTProto-прокси — это встроенная функция Telegram, но публичные серверы часто перегружены. DNS-фильтры помогают только при проблемах с резолвингом доменов, но не решают проблему блокировки IP. TGWS сочетает преимущества локального прокси и WSS-туннеля, что делает его более надёжным.

Если TGWS не работает, можно попробовать альтернативы: Hiddify, Nekoray, v2rayN — но они требуют внешних серверов. Для Telegram Desktop TGWS остаётся самым простым решением с минимальной настройкой.

Также стоит помнить, что TGWS — это частичная оптимизация. Результат зависит от маршрутов, региона, провайдера и состояния серверов Telegram. В некоторых случаях может потребоваться комбинация с другими инструментами.

Вопросы и ответы