Независимый справочный сайт

TG WS Proxy
Более умный путь трафика для Telegram Desktop

TG WS Proxy — локальный SOCKS5-прокси. При обнаружении трафика Telegram DC он приоритетно использует WSS (`kws*.web.telegram.org`) и при сбоях автоматически откатывается на прямой TCP.

Скачать Releases Исходный код

Дисклеймер: сайт независимый и не аффилирован с Telegram или мейнтейнерами проекта.

Лицензия

MIT License

Сборка

GitHub Actions + PyInstaller

Последний релиз

v1.2.1 (2026-03-22)

Как это работает

Telegram Desktop подключается к локальному SOCKS5 на 127.0.0.1:1080.
Прокси определяет целевые IP Telegram и извлекает метаданные DC из MTProto obfuscation init-пакета.
Приоритетно устанавливается TLS WebSocket к `kws*.web.telegram.org` (binary protocol).
Пакеты MTProto пересылаются по кадрам, чтобы избежать проблем handshake при склейке пакетов.
Если WS дает 302/redirect-подобные ошибки, происходит автоматический fallback на прямой TCP.

Telegram Desktop
  -> SOCKS5 127.0.0.1:1080
  -> TG WS Proxy
  -> WSS kwsN.web.telegram.org (/apiws)
  -> Telegram DC

Удобно для Desktop

Доступны Windows tray GUI, macOS app package, Linux package и CLI-режим.

Стратегия маршрутизации

Определяются диапазоны IP Telegram с раздельными путями для DC и media/non-media трафика.

Гибкая настройка

Поддерживаются параметры --port и несколько --dc-ip для адаптации под сеть.

Стабильность

Пулы соединений, cooldown после ошибок и fallback-логика уменьшают reconnect jitter.

Быстрый старт

1. Скачайте

В Releases доступны `TgWsProxy_windows.exe`, `TgWsProxy_macos_universal.dmg` и `TgWsProxy_linux_amd64.deb`.

2. Запустите прокси

По умолчанию слушает 127.0.0.1:1080. Desktop-сборки дают доступ к трею и логам.

3. Настройте SOCKS5 в Telegram Desktop

Сервер 127.0.0.1, порт 1080, логин и пароль оставьте пустыми.

tg-ws-proxy --port 1080 \
  --dc-ip 2:149.154.167.220 \
  --dc-ip 4:149.154.167.220 -v

Последние изменения

Заметки релиза автоматически загружаются из GitHub Releases.
Если раздел выглядит устаревшим, проверьте страницу релизов исходного репозитория.

Файлы релиза (v1.2.1)

Партнерское предложение

NordVPN

Подходит пользователям, которым нужны дополнительные инструменты приватности и доступа к региональному контенту.

Смотреть предложение

Раскрытие: в этом блоке могут быть партнерские ссылки. Если вы совершаете покупку по ним, мы можем получить комиссию без доплаты с вашей стороны.

Практика сообщества

Текущий статус mobile

Основной фокус проекта — Telegram Desktop. Для Android есть community-эксперименты (Termux/порты), но стабильность зависит от устройства и сети.

Телефон через ваш ПК (LAN)

В обсуждениях мейнтейнер подтвердил рабочий путь: выставить host 0.0.0.0 на ПК и указать в Telegram на телефоне локальный IP компьютера и порт SOCKS.

Чаты работают, медиа нет

Частый кейс сообщества: текст проходит, а медиа нет. Один из распространенных шагов диагностики — проверить дополнительный DC mapping, например `203:149.154.167.220`.

Осторожно с удаленным доступом

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

FAQ

Почему ускорение может быть ограниченным?

Это частичная оптимизация. Результат зависит от маршрутов, региона, провайдера и состояния Telegram.

Нужен ли удаленный сторонний прокси-сервер?

Нет. Приложение работает локально и направляет трафик к доменам и нодам Telegram.

Что делать, если антивирус ругается на файл?

В README отмечены возможные ложные срабатывания. Скачивайте только из официальных Releases и проверяйте файлы.

Влияет ли это на безопасность аккаунта Telegram?

Нет, учетные данные и модель аутентификации Telegram не изменяются — это локальная прокси-маршрутизация.

Логируется ли содержимое сообщений?

Есть служебные логи соединений и отладки. Относитесь к ним как к чувствительным данным.

Поддерживается ли мобильный Telegram?

Проект в первую очередь ориентирован на Telegram Desktop.

TG WS ProxyБолее умный путь трафика для Telegram Desktop