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

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

Алгоритм работы приложения состоит из следующих этапов:

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

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

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

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

Также проект включает GitHub Actions workflow:

• /.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