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

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

Контекстное меню значка TG WS Proxy предоставляет быстрый доступ к основным функциям:

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

---

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

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

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

Порядок действий:

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

Если автоматическая настройка не выполнилась:

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, на основании которого определяется необходимый дата-центр Telegram (DC ID).
4. Выполняется установка защищённого WebSocket-соединения с выбранным сервером Telegram.
5. Если соединение через WebSocket недоступно (например, сервер отвечает HTTP 302 Redirect), приложение автоматически переключается на альтернативный маршрут — 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

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

---

Поддерживаемые операционные системы

Проект предоставляет готовые исполняемые файлы для следующих платформ:

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

Note

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

---

Участники проекта

Разработка TG WS Proxy ведётся при активной поддержке сообщества.

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

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

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

---

Лицензия

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

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

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

• LICENSE