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 (x64)
• TgWsProxy_windows_7_32bit.exe — Windows 7 (x86)

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

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

После запуска через значок в области уведомлений доступны следующие действия:

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

---

Настройка Telegram Desktop

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

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

Для этого:

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

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

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

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

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

Откройте:

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

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

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

Как работает TG WS Proxy

Telegram Desktop
        │
        ▼
Локальный MTProto Proxy
        │
        ▼
WebSocket (TLS)
        │
        ▼
Telegram Data Center

После запуска приложение выступает в роли промежуточного узла между Telegram Desktop и серверами Telegram, обеспечивая передачу трафика через WebSocket.

Во время работы выполняются следующие операции:

1. Инициализируется локальный MTProto-прокси с параметрами, указанными в конфигурации.
2. Принимаются входящие подключения от клиента Telegram Desktop.
3. Анализируется MTProto Obfuscation Init Packet, после чего определяется необходимый дата-центр Telegram (DC ID).
4. Для выбранного дата-центра создаётся защищённое WebSocket-соединение по TLS.
5. Если соединение через WebSocket установить невозможно (например, сервер возвращает ответ HTTP 302 Redirect), приложение автоматически использует резервный маршрут — Cloudflare Proxy либо прямое TCP-соединение.

---

Important

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 7 (x64)	Поддерживается
Windows 7 (x86)	Поддерживается
macOS Intel	10.15 и выше
macOS Apple Silicon	11.0 и выше
Linux x86_64	Требуется AppIndicator

Note

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

---

Контрибьюторы

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

Если вы хотите внести свой вклад в развитие проекта, можно:

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

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

---

Лицензия

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

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

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

• LICENSE