Tip

🎉 Помочь развитию проекта

Если TG WS Proxy оказался для вас полезным, вы можете поддержать дальнейшее развитие проекта. Финансовая помощь позволяет быстрее выпускать обновления, исправлять найденные проблемы и реализовывать новые функции.

Caution

Антивирус может выдавать предупреждения

Некоторые средства антивирусной защиты способны ошибочно определять TG WS Proxy как потенциально опасную программу. Обычно причиной является способ упаковки исполняемого файла, а не наличие вредоносного содержимого.

Если приложение блокируется во время скачивания или запуска:

1. Используйте сборку для Windows 7 — по функциональности она идентична основной версии.
2. При необходимости временно отключите защиту, скачайте приложение, добавьте его в список исключений и затем повторно включите антивирус.

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

TG WS Proxy

TG WS Proxy — локальный MTProto-прокси для Telegram Desktop, использующий WebSocket как транспортный уровень передачи данных. Такой подход позволяет направлять трафик напрямую к серверам Telegram без сторонних MTProto-прокси, сохраняя стандартный механизм шифрования протокола.

Содержание

🚀 Руководства по установке

• Windows
• macOS
• Linux
• Docker

Дополнительные материалы

• Использование Cloudflare Worker (бесплатная альтернатива Cloudflare Proxy)
• Развёртывание собственного Cloudflare Proxy
• Настройка Fake TLS через Nginx
• Конфигурация Tray-приложения
• Инструкция по сборке из исходников
• Руководство для разработчиков

---

Установка

Перейдите в раздел Releases репозитория и скачайте сборку, подходящую для вашей операционной системы.

Доступны следующие версии:

• TgWsProxy_windows.exe — Windows 10 и новее (x64);
• TgWsProxy_windows_arm64.exe — Windows 10 и новее (ARM64);
• TgWsProxy_windows_7_64bit.exe — Windows 7 (64-bit);
• TgWsProxy_windows_7_32bit.exe — Windows 7 (32-bit).

Во время первого запуска приложение автоматически откроет инструкцию по подключению Telegram Desktop. После завершения настройки программа продолжит работу в фоновом режиме, а доступ к её функциям будет осуществляться через значок в области уведомлений.

Меню программы

Все основные действия доступны через контекстное меню TG WS Proxy.

Доступные пункты:

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

---

Настройка Telegram Desktop

Автоматическое подключение

Рекомендуемый способ — воспользоваться автоматической настройкой.

Для этого:

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

Если Telegram не обработал ссылку автоматически:

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

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

Если автоматический способ недоступен, параметры можно задать самостоятельно.

Откройте:

Telegram
→ Настройки
→ Продвинутые настройки
→ Тип подключения
→ Прокси

Создайте новое MTProto-подключение и заполните поля следующими значениями:

Параметр	Значение
Тип	MTProto
Сервер	127.0.0.1 (или адрес, указанный в настройках TG WS Proxy)
Порт	1443 (либо выбранный пользователем порт)
Secret	секретный ключ, отображаемый в настройках приложения или журнале логов

Принцип работы

Telegram Desktop
        │
        ▼
Локальный MTProto Proxy
        │
        ▼
WebSocket (TLS)
        │
        ▼
Telegram Data Center

После запуска TG WS Proxy начинает принимать подключения от Telegram Desktop, определяет необходимый дата-центр Telegram и перенаправляет трафик через защищённое WebSocket-соединение.

Основные этапы обработки подключения:

1. Запускается локальный MTProto-прокси с параметрами, указанными в конфигурации приложения.
2. Принимаются входящие подключения от Telegram Desktop.
3. Анализируется MTProto Obfuscation Init Packet, из которого определяется идентификатор требуемого дата-центра (DC ID).
4. Создаётся защищённое WebSocket-соединение с соответствующим сервером Telegram.
5. Если подключение через WebSocket установить не удаётся (например, сервер отвечает кодом HTTP 302 Redirect), TG WS Proxy автоматически переключается на резервный маршрут, используя Cloudflare Proxy или прямое TCP-соединение.

---

Important

После подключения перестали загружаться медиафайлы?

Если после включения TG WS Proxy Telegram перестал отображать изображения, видео или другие вложения, в первую очередь проверьте настройки IP-адресов дата-центров.

Откройте раздел:

DC → IP

и оставьте только следующую запись:

4:149.154.167.220

Если проблема остаётся, полностью очистите содержимое этого поля и повторите подключение.

Иногда подобная ситуация наблюдается у пользователей без активной подписки Telegram Premium.

Если проблема сохраняется, рекомендуется использовать собственный Cloudflare Proxy, выполнив настройку по инструкции:

CfProxy.md

---

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

Репозиторий уже содержит всё необходимое для автоматического формирования исполняемых файлов.

В качестве инструмента упаковки используется PyInstaller, а создание новых сборок полностью автоматизировано при помощи GitHub Actions.

Используемые спецификации находятся в следующих файлах:

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

Workflow сборки расположен по пути:

• .github/workflows/build.yml

Такая схема позволяет автоматически получать актуальные сборки после внесения изменений в репозиторий.

---

Поддерживаемые платформы

TG WS Proxy предоставляет готовые сборки для следующих операционных систем:

Платформа	Поддерживается
Windows 10 и новее (x64)	✅
Windows 10 и новее (ARM64)	✅
Windows 7 (x64)	✅
Windows 7 (x86)	✅
macOS Intel (10.15+)	✅
macOS Apple Silicon (11.0+)	✅
Linux x86_64	✅

Note

Для корректного отображения значка приложения в системном трее Linux необходимо установить пакет AppIndicator.

---

Участие в развитии проекта

TG WS Proxy распространяется с открытым исходным кодом, поэтому помощь сообщества всегда приветствуется.

Вы можете принять участие в развитии проекта следующими способами:

• сообщить о найденной ошибке;
• предложить улучшение или новую функцию;
• принять участие в разработке;
• помочь с обновлением документации;
• отправить Pull Request со своими изменениями.

Любой вклад помогает сделать проект стабильнее, функциональнее и удобнее для пользователей.

---

Лицензия

Проект распространяется в соответствии с лицензией MIT.

Лицензия предоставляет право свободно использовать, модифицировать и распространять исходный код при соблюдении её условий.

Подробный текст лицензии находится в файле:

• LICENSE