TG WS Proxy

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

---

🌟 Почему TG WS Proxy?

Проект создан для тех, кто хочет использовать Telegram Desktop через WebSocket без настройки сторонних прокси.

Основные преимущества

• ⚡ передача MTProto-трафика через WebSocket;
• 🖥️ полностью локальная работа приложения;
• 🔒 сохранение стандартного MTProto-шифрования;
• 🌐 автоматический выбор Telegram Data Center;
• 🔄 резервное подключение при недоступности WebSocket;
• 📌 работа через системный трей;
• 💻 поддержка Windows, macOS и Linux.

💨 Ожидаемый результат сопоставим с использованием hosts для Web Telegram: снижаются задержки при получении сообщений, ускоряется загрузка медиафайлов и скачивание вложений, благодаря чему Telegram Desktop работает заметно быстрее и стабильнее.

---

📥 Установка

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

После запуска приложение автоматически создаст локальный MTProto-прокси и продолжит работу в системном трее.

---

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

Способ №1 — автоматически

Самый простой вариант — открыть меню приложения и выбрать пункт «Открыть в Telegram».

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

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

---

Способ №2 — вручную

Откройте:

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

Добавьте новый MTProto-прокси.

Тип      : MTProto
Сервер   : 127.0.0.1
Порт     : 1443
Secret   : из настроек приложения

Если в конфигурации используются другие значения адреса или порта — укажите их вручную.

---

🖥 Управление приложением

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

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

• 🚀 открыть Telegram с уже подготовленной ссылкой;
• 📋 скопировать ссылку подключения;
• 🔄 выполнить перезапуск локального прокси;
• ⚙️ открыть настройки программы;
• 📄 просмотреть журнал работы;
• ❌ завершить работу приложения.

---

⚙️ Как устроена работа

Telegram Desktop
        │
        ▼
 Local MTProto Proxy
        │
        ▼
  WebSocket (TLS)
        │
        ▼
 Telegram Data Center

При запуске приложение выполняет несколько последовательных действий:

1. поднимает локальный MTProto-прокси;
2. принимает подключения Telegram Desktop;
3. определяет целевой Telegram Data Center;
4. устанавливает защищённое WebSocket-соединение;
5. при необходимости автоматически переключается на альтернативный способ подключения.

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

---

🛠 Решение возможных проблем

Important

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

Проверьте список IP-адресов в настройках прокси.

Для начала рекомендуется оставить только:

4:149.154.167.220

Если проблема не исчезла:

• полностью очистите список IP;
• переподключите прокси;
• при необходимости настройте собственный Cloudflare-домен.

На некоторых аккаунтах без Telegram Premium именно это позволяет восстановить корректную загрузку медиа.

---

📚 Полезные материалы

Руководства

• Windows
• macOS
• Linux
• Docker

Дополнительная документация

• Cloudflare Worker
• Cloudflare Proxy
• Fake TLS + Nginx
• Конфигурация приложения
• Сборка из исходников
• Руководство для контрибьюторов

---

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

Для публикации релизов проект использует:

• PyInstaller;
• GitHub Actions.

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

• Windows x64;
• Windows ARM64;
• Windows 7 x86/x64;
• Intel macOS;
• Apple Silicon;
• Linux x86_64.

---

Warning

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

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

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

• попробуйте сборку для Windows 7;
• временно отключите защиту;
• после загрузки добавьте файл в исключения;
• при необходимости самостоятельно проверьте его через VirusTotal.

---

[!TIP]

---

🤝 Участие в развитии

Будем рады любой помощи.

Вы можете:

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

Спасибо каждому, кто помогает развивать TG WS Proxy!

---

📄 Лицензия

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

Подробные условия использования доступны в файле LICENSE.