Tip

🎉 Поддержите развитие проекта

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

Caution

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

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

Если загрузка или запуск блокируются:

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

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

TG WS Proxy

TG WS Proxy — локальный прокси для Telegram Desktop, реализующий протокол MTProto поверх 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).

При первом запуске TG WS Proxy автоматически откроет инструкцию по подключению 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. Подтвердите применение настроек.

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

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

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

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), автоматически использует резервную схему подключения через 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

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

---

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

На текущий момент 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 развивается как open-source проект, поэтому любая помощь сообщества приветствуется.

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

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

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

---

Лицензия

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

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

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

• LICENSE