Tip

🎉 Поддержать развитие проекта

Если TG WS Proxy оказался полезным для вас и вы хотите помочь проекту продолжать развиваться, вы можете поддержать автора финансово:

USDT (TRC20): TXPnKs2Ww1RD8JN6nChFUVmi5r2hqrWjuu BTC: bc1qr8vd6jelkyyry3m4mq6z5txdx4pl856fu6ss0w ETH: 0x1417878fdc5047E670a77748B34819b9A49C72F1 Другие способы поддержки: https://nowpayments.io/donation/flowseal

Caution

Срабатывания антивирусного ПО

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

Если антивирус блокирует загрузку или запуск приложения:

1. Попробуйте использовать сборку для Windows 7 — она предоставляет тот же набор возможностей
2. На время скачивания отключите защиту, добавьте файл программы в исключения и после завершения процесса повторно включите антивирус

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

TG WS Proxy

TG WS Proxy — локальный MTProto-прокси для Telegram Desktop, предназначенный для улучшения скорости и стабильности работы Telegram через передачу соединений с использованием WebSocket-соединений.

Весь трафик продолжает передаваться в исходном зашифрованном формате Telegram. Для работы приложения не требуется использование внешних серверов, сторонних прокси или дополнительных сетевых сервисов.

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

Откройте страницу релизов и скачайте подходящую сборку программы:

• TgWsProxy_windows.exe — Windows 10+ x64
• TgWsProxy_windows_arm64.exe — Windows 10+ ARM64
• TgWsProxy_windows_7_64bit.exe — Windows 7 x64
• TgWsProxy_windows_7_32bit.exe — Windows 7 x32

При первом запуске TG WS Proxy автоматически отобразит инструкцию по настройке подключения Telegram Desktop. После завершения конфигурации приложение продолжит работу в фоновом режиме через системный трей.

Меню управления в системном трее

Через меню TG WS Proxy можно выполнить следующие действия:

• Открыть в Telegram — автоматическое добавление прокси-подключения в Telegram при помощи ссылки tg://proxy
• Скопировать ссылку — копирование ссылки подключения для дальнейшего использования
• Перезапустить прокси — повторный запуск прокси-модуля без выхода из приложения
• Настройки... — редактирование параметров через GUI (версия приложения, проверка обновлений GitHub)
• Открыть логи — доступ к журналу событий и диагностической информации
• Выход — остановка работы прокси и полное закрытие программы

Подключение Telegram Desktop

Автоматическая настройка

Нажмите правой кнопкой мыши на значок TG WS Proxy в системном трее и выберите пункт «Открыть в Telegram».

Если автоматическое подключение не было выполнено:

1. Откройте меню приложения и выберите «Скопировать ссылку»
2. Отправьте полученную ссылку в чат «Избранное» Telegram
3. Откройте ссылку и подтвердите использование прокси Настройка вручную

В Telegram Desktop откройте раздел:

Настройки → Продвинутые настройки → Тип подключения → Прокси

Добавьте новое подключение, указав следующие параметры:

• Тип: MTProto
• Сервер: 127.0.0.1 (или другой адрес, заданный пользователем)
• Порт: 1443 (или изменённый вручную порт)
• Secret: значение из конфигурации приложения или лог-файлов

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

Схема маршрутизации соединения:

Telegram Desktop → MTProto Proxy (127.0.0.1:1443) → WebSocket → Telegram DC

Работа TG WS Proxy выполняется следующим образом:

1. Приложение запускает локальный MTProto-прокси на 127.0.0.1:1443
2. TG WS Proxy отслеживает подключения Telegram, направленные к IP-адресам серверов Telegram
3. Из начального MTProto obfuscation init-пакета извлекается информация об используемом DC
4. После определения нужного DC создаётся защищённое WebSocket-соединение (TLS) через домены Telegram
5. Если установить WebSocket-подключение невозможно (например, сервер отвечает кодом 302) — программа автоматически использует CfProxy или переключается на прямое TCP-соединение

Important

Не загружаются фото или видео?

Откройте настройки прокси, перейдите в раздел DC → IP и оставьте только 4:149.154.167.220, удалив все остальные значения.

Если проблема не исчезла — полностью очистите поле DC → IP.

Такая ситуация может встречаться у пользователей Telegram-аккаунтов без Premium.

Если это не решило проблему, настройте собственный домен согласно инструкции: CfProxy.md

Автоматическая сборка

Для подготовки сборок проекта используются конфигурации PyInstaller:

• packaging/windows.spec
• packaging/macos.spec
• packaging/linux.spec

Кроме этого, в репозитории настроен GitHub Actions workflow:

• /.github/workflows/build.yml

Он автоматически выполняет процесс сборки приложения для всех поддерживаемых систем.

Минимальные требования для готовых бинарных сборок:

• TgWsProxy_windows.exe — Windows 10+ x64
• TgWsProxy_windows_arm64.exe — Windows 10+ ARM64
• TgWsProxy_windows_7_64bit.exe — Windows 7 x64
• TgWsProxy_windows_7_32bit.exe — Windows 7 x32
• Intel macOS — версия 10.15 или выше
• Apple Silicon macOS — версия 11.0 или выше
• Linux x86_64 — требуется AppIndicator для корректного отображения значка приложения в системном трее

Контрибьюторы

Спасибо всем участникам, которые помогают развивать TG WS Proxy, предлагают новые идеи, исправления и улучшают проект ❤️

Лицензия

Проект распространяется на условиях лицензии:

MIT License