Tip

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

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

Caution

Важно: возможны ложные предупреждения антивирусов

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

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

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

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

TG WS Proxy

TG WS Proxy — локальный MTProto-прокси для Telegram Desktop, передающий трафик через WebSocket. Такой подход обеспечивает стабильную работу клиента, сохраняя стандартное 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 (x64);
• TgWsProxy_windows_7_32bit.exe — Windows 7 (x86).

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

Меню приложения

Контекстное меню предоставляет быстрый доступ ко всем основным возможностям TG WS Proxy.

Доступные действия:

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

---

Настройка Telegram Desktop

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

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

Для этого необходимо:

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

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

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

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

При необходимости параметры MTProto можно указать самостоятельно.

Откройте:

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

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

Параметр	Значение
Тип	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 перестал загружать медиа?

Если после активации TG WS Proxy перестали открываться изображения, видео или другие медиафайлы, сначала проверьте настройки списка 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

Это позволяет автоматически получать новые версии приложения после каждого изменения исходного кода.

---

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

На текущий момент проект поддерживает следующие операционные системы:

Платформа	Статус
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

Для корректного отображения значка TG WS Proxy в системном трее Linux требуется установленный пакет AppIndicator.

---

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

TG WS Proxy — проект с открытым исходным кодом, который развивается благодаря помощи сообщества.

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

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

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

---

Лицензия

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

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

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

• LICENSE