tg-ws-proxy README

The project's README from github.com/Flowseal/tg-ws-proxy. As one markdown file: README.md.

🇷🇺 Русский • 🇬🇧 English


tgwsproxy

[!TIP]

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

USDT (TRC20): TXPnKs2Ww1RD8JN6nChFUVmi5r2hqrWjuu
BTC: bc1qr8vd6jelkyyry3m4mq6z5txdx4pl856fu6ss0w
ETH: 0x1417878fdc5047E670a77748B34819b9A49C72F1

[!CAUTION]

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

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

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

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

TG WS Proxy

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

Навигация

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

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

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

Меню трея

Настройка Telegram Desktop

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

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

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

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

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

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

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

Telegram Desktop → MTProto Proxy (127.0.0.1:1443) → WebSocket → Telegram DC
  1. Приложение поднимает MTProto прокси на 127.0.0.1:1443
  2. Перехватывает подключения к IP-адресам Telegram
  3. Извлекает DC ID из MTProto obfuscation init-пакета
  4. Устанавливает WebSocket-соединение (TLS) к соответствующему DC через домены Telegram
  5. Если 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) для автоматической сборки.

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

Контрибьюторы

Спасибо всем, кто помогает развивать проект ❤️

Лицензия

MIT License

tg-ws-proxy (Flowseal/tg-ws-proxy)

Searching Database…

Что это такое?TG WS Proxy — это локальный прокси MTProto для Telegram Desktop, который ускоряет работу Telegram или частично обходит его блокировку, направляя трафик через соединения WebSocket (TLS), и не использует никаких сторонних серверов.
Это утилита для командной строки или настольное приложение с графическим интерфейсом?Это настольное приложение, которое работает в системном трее и имеет графический редактор настроек; после запуска оно сворачивается в трей, и из его меню можно сразу открыть Telegram или настроить его.
Как его запустить?Скачайте готовый файл для вашей ОС со страницы Releases (отдельные сборки для Windows 10+ x64/ARM64, Windows 7 x64/x32, macOS на Intel, macOS на Apple Silicon и Linux x86_64) или запустите его через Docker, затем щёлкните правой кнопкой мыши по значку в трее и выберите «Open in Telegram», чтобы автоматически настроить Telegram Desktop.
Нужны ли мне аккаунты, API-ключи или внешние серверы?Нет — прокси работает без сторонних серверов, достаточно установленного Telegram Desktop. В Linux для значка в системном трее нужна поддержка AppIndicator.
Всегда ли через прокси работает загрузка фото и видео?Не всегда. Если медиафайлы не загружаются, удалите все записи DC→IP в настройках прокси, кроме «4:149.154.167.220», или полностью очистите это поле; эта проблема чаще встречается у аккаунтов без Telegram Premium.
Какие версии Windows и macOS поддерживаются?Есть сборки для Windows 10+ x64/ARM64 и Windows 7 x64/x32, а также для macOS 10.15+ на Intel, macOS 11.0+ на Apple Silicon и Linux x86_64 (для значка в трее требуется AppIndicator).
Куда на самом деле уходит мой трафик Telegram?Трафик шифруется так же, как обычный трафик MTProto, сторонние серверы не используются: соединения идут через WebSocket/TLS напрямую к доменам собственных датацентров Telegram, с необязательным запасным вариантом на основе Cloudflare.
Как прокси технически обходит блокировку Telegram?Он извлекает ID датацентра из инициализирующего пакета обфускации MTProto, затем открывает соединение WebSocket (TLS) с собственным доменом Telegram для этого датацентра; если соединение WebSocket блокируется (перенаправление 302), прокси автоматически переключается на CfProxy или прямое TCP-соединение.
Что такое CfProxy?CfProxy — необязательный запасной путь на основе Cloudflare (с инструкциями по бесплатной альтернативе на Cloudflare Worker или по использованию собственного домена Cloudflare), который применяется, когда прямые соединения WebSocket с Telegram блокируются.
Почему антивирус помечает скачанный файл как вирус?Многие антивирусные движки ошибочно считают упакованный исполняемый файл вредоносным; в README предлагается попробовать сборку для Windows 7 или временно отключить антивирус и добавить файл в исключения, одновременно проверив его на VirusTotal.
Можно ли проверить прокси на тестовых датацентрах Telegram?Да, в README есть отдельное руководство по настройке тестового окружения Telegram с тестовыми датацентрами, которое полезно для разработки и устранения неполадок.
Creator
Flowseal
Size
2.4 MB
Stars
10.6K
Age
7mo
Commits · 90 Days