Tip

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

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

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-приложения
• Сборка проекта из исходных кодов
• Рекомендации для участников разработки

---

Установка

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

---

Подключение Telegram Desktop

Автоматический способ

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

Порядок действий:

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

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

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