Tip

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

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

Caution

Предупреждение о работе антивирусов

Некоторые антивирусные решения могут ошибочно классифицировать программу как потенциально опасную. Обычно причиной становится упаковщик исполняемого файла, а не содержимое приложения.

Если загрузка блокируется:

1. Попробуйте использовать сборку для Windows 7 — она полностью повторяет возможности основной версии.
2. Временно отключите антивирус, скачайте программу, добавьте её в список исключений и снова включите защиту.

Независимо от источника загрузки рекомендуется проверять исполняемые файлы через VirusTotal или аналогичные сервисы.

TG WS Proxy

TG WS Proxy — локальный MTProto-прокси для Telegram Desktop, использующий WebSocket в качестве транспорта между клиентом и серверами Telegram. Такой подход позволяет обеспечить стабильную работу приложения без изменения механизма шифрования и без использования удалённых прокси-серверов.

Навигация

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

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

Этапы работы приложения:

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

---

Important

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

Если после подключения через прокси Telegram перестал отображать фотографии, видеоролики или другой мультимедийный контент, прежде всего проверьте настройки списка IP-адресов дата-центров.

Откройте раздел DC → IP и оставьте единственную запись:

4:149.154.167.220

Если это не помогло, удалите все значения из данного поля и повторите попытку.

Подобная проблема иногда возникает у пользователей без подписки Telegram Premium.

Если после выполнения перечисленных действий ситуация не изменилась, рекомендуется использовать собственный Cloudflare-домен, выполнив настройку по инструкции:

• Настройка Cloudflare Proxy

---

Автоматическая сборка

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

Для подготовки исполняемых файлов используются спецификации 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