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 с 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

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

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

Для этого выполните следующие действия:

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

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

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

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

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

Откройте:

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

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

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

Внутренний принцип работы

Telegram Desktop
        │
        ▼
Локальный MTProto Proxy
        │
        ▼
Защищённое WebSocket-соединение
        │
        ▼
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

и оставьте только следующий 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

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

---

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

TG WS Proxy развивается благодаря участию сообщества.

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

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

Любое участие способствует развитию проекта и помогает сделать его ещё лучше.

---

Лицензия

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

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

Полный текст документа расположен в файле:

• LICENSE