Tip

🎉 Поддержка проекта

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

Caution

Возможны ошибочные предупреждения антивирусов

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

Если программа не скачивается либо блокируется при запуске:

1. Используйте сборку для Windows 7 — она обладает тем же набором функций, что и версия для современных выпусков Windows.
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-приложения
• Сборка проекта из исходного кода
• Информация для разработчиков

---

Установка приложения

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

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

---

Поддерживаемые платформы

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

Платформа	Статус
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

Для корректного отображения значка TG WS Proxy в области уведомлений Linux требуется установленный пакет AppIndicator.

---

Вклад в развитие проекта

TG WS Proxy является проектом с открытым исходным кодом и развивается благодаря помощи сообщества.

Вы можете принять участие в его развитии несколькими способами:

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

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

---

Лицензия

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

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

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

• LICENSE