tg-ws-proxy

Introduction: Local SOCKS5 proxy server for partial bypassing of Telegram loading

Tags:

[!TIP]

🎉 Поддержать меня

USDT (TRC20): TXPnKs2Ww1RD8JN6nChFUVmi5r2hqrWjuu
BTC: bc1qr8vd6jelkyyry3m4mq6z5txdx4pl856fu6ss0w
ETH: 0x1417878fdc5047E670a77748B34819b9A49C72F1
Другие монеты: https://nowpayments.io/donation/flowseal

[!CAUTION]

Реакция антивирусов

Антивирусы часто ошибочно помечают приложение как вирус из-за упаковщика.
Если вы не можете скачать из-за блокировки антивирусом, то:

Попробуйте скачать версию для Windows 7 (по функциональности она не отличается)

Отключите антивирус на время скачивания, добавьте файл в исключения и включите обратно

Всегда проверяйте, что скачиваете из интернета, тем более из непроверенных источников. Всегда лучше смотреть на детекты широко известных антивирусов на VirusTotal

TG WS Proxy

Локальный MTProto-прокси для Telegram Desktop, который ускоряет работу Telegram, перенаправляя трафик через WebSocket-соединения. Данные передаются в том же зашифрованном виде, а для работы не нужны сторонние серверы.

🚀 Быстрый старт
- Windows
- macOS
- Linux
Настройка Cloudflare-домена (CF-прокси)
Fake TLS + upstream в Nginx
Файлы конфигурации Tray-приложения
Установка из исходников
Руководство для контрибьюторов

Windows: быстрый вход

Перейдите на страницу релизов и скачайте:

TgWsProxy_windows.exe (Windows 10+)
TgWsProxy_windows_7_64bit.exe (Windows 7 x64)
TgWsProxy_windows_7_32bit.exe (Windows 7 x32)

При первом запуске откроется окно с инструкцией по подключению Telegram Desktop. Приложение сворачивается в системный трей.

Меню трея

Открыть в Telegram — автоматически настроить прокси через ссылку tg://proxy
Скопировать ссылку — скопировать ссылку для подключения
Перезапустить прокси — перезапуск без выхода из приложения
Настройки... — GUI-редактор конфигурации (версия приложения, опциональная проверка обновлений с GitHub)
Открыть логи — открыть файл логов
Выход — остановить прокси и закрыть приложение

Настройка Telegram Desktop

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

Щелкните правой кнопкой мыши по значку в трее и выберите «Открыть в Telegram».

Если не сработало (Telegram не открылся с подключением), выполните шаги ниже:

Щелкните правой кнопкой мыши по значку в трее и выберите «Скопировать ссылку»
Отправьте ссылку в «Избранное» в Telegram и нажмите по ней левой кнопкой мыши
Подключитесь

Ручная настройка

Telegram → Настройки → Продвинутые настройки → Тип подключения → Прокси
Добавьте прокси:
- Тип: MTProto
- Сервер: 127.0.0.1 (или переопределенный вами)
- Порт: 1443 (или переопределенный вами)
- Secret: из настроек или логов

Как это работает

Telegram Desktop → MTProto Proxy (127.0.0.1:1443) → WebSocket → Telegram DC

Приложение поднимает MTProto прокси на 127.0.0.1:1443
Перехватывает подключения к IP-адресам Telegram
Извлекает DC ID из MTProto obfuscation init-пакета
Устанавливает WebSocket-соединение (TLS) к соответствующему DC через домены Telegram
Если WS недоступен (302 redirect) — автоматически переключается на CfProxy / прямое TCP-соединение

[!IMPORTANT]

Не грузит фото/видео?

Удалите в настройках прокси в DC → IP всё, кроме 4:149.154.167.220
Если это не помогло, полностью очистите это поле
Подобная проблема встречается на аккаунтах без Premium
Если это не помогло, настройте собственный домен по инструкции: CfProxy.md

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

Проект содержит спецификации PyInstaller (packaging/windows.spec, packaging/macos.spec, packaging/linux.spec) и GitHub Actions workflow (.github/workflows/build.yml) для автоматической сборки.

Минимально поддерживаемые версии ОС для текущих бинарных сборок: