Tip

🎉 Поддержите проект

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

Другие способы поддержки: https://nowpayments.io/donation/flowseal

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-приложения
• Сборка проекта из исходного кода
• Руководство для контрибьюторов

---

Установка в Windows

Откройте раздел 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. После завершения настройки программа свернётся в трей и продолжит работу в фоновом режиме.

Возможности меню

После запуска через значок приложения становятся доступны следующие действия:

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

---

Подключение Telegram Desktop

Автоматический способ

Для автоматической настройки достаточно:

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

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

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

Настройка вручную

Если автоматическая настройка недоступна, создайте новое MTProto-подключение вручную.

Перейдите:

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

Заполните поля следующим образом:

Поле	Значение
Тип подключения	MTProto
Сервер	127.0.0.1 или адрес из конфигурации
Порт	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), приложение автоматически переключается на резервный способ передачи данных — Cloudflare Proxy или прямое TCP-подключение.

---

Important

Не загружаются фотографии, видео или другие медиа?

Если после включения прокси 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 с собственными изменениями.

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

---

Лицензия

TG WS Proxy распространяется в соответствии с лицензией MIT.

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

Полный текст лицензии доступен в файле:

• LICENSE