Tip

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

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

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 невозможно (например, при получении HTTP-ответа 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