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