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 совместно с 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.
• Скопировать ссылку — поместить ссылку для подключения в буфер обмена.
• Перезапустить прокси — перезапустить локальный MTProto-прокси без закрытия приложения.
• Настройки... — открыть окно конфигурации для изменения параметров программы и настройки автоматической проверки обновлений.
• Открыть журнал — перейти к логам приложения.
• Выход — остановить прокси и завершить работу программы.

---

Настройка 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 (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

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

Если после включения 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 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