Tip

🎉 Поддержать развитие TG WS Proxy

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

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

Caution

Антивирусные предупреждения

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

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

1. Используйте альтернативную сборку для Windows 7 — она сохраняет весь основной функционал
2. При необходимости временно отключите защиту, добавьте файл TG WS Proxy в список исключений и после завершения установки включите антивирус обратно

Перед запуском любых программ, полученных из интернета, рекомендуется убедиться в надёжности источника и дополнительно проверить файл через 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. После завершения настройки приложение будет работать в фоновом режиме и оставаться доступным через системный трей.

Управление из меню трея

Через меню значка приложения доступны следующие действия:

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

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

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

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

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

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

Ручная настройка

В Telegram Desktop откройте:

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

Создайте новое подключение со следующими параметрами:

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

Принцип работы 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. Выполняется анализ соединений Telegram, направленных к IP-адресам серверов Telegram
3. Из начального MTProto obfuscation init-пакета извлекается информация о дата-центре (DC), к которому выполняется подключение
4. После определения нужного DC создаётся защищённый канал через WebSocket-соединение (TLS) с соответствующим Telegram DC при помощи Telegram-доменов
5. Если установить WebSocket-соединение невозможно (например, сервер отвечает кодом 302), программа автоматически использует резервные варианты: CfProxy или прямое TCP-подключение

Important

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

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

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

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

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

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

Для подготовки готовых версий TG WS Proxy используются файлы конфигурации PyInstaller:

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

В проект также добавлен workflow для GitHub Actions:

• /.github/workflows/build.yml

Этот workflow автоматизирует процесс создания сборок приложения для всех поддерживаемых платформ.

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

• 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