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

При первом запуске приложение автоматически покажет инструкцию по подключению 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

Работа приложения выполняется в несколько этапов:

1. TG WS Proxy запускает локальный 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

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

Для создания готовых версий приложения используются конфигурации 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