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, которые направляются к адресам серверов 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