TG WS Proxy

TG WS Proxy — локальный MTProto-прокси для Telegram Desktop, использующий WebSocket как транспорт до дата-центров Telegram.

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

Основные возможности

• локальный MTProto-прокси для Telegram Desktop;
• передача соединений через WebSocket;
• автоматическое определение Telegram DC;
• резервное переключение на CfProxy или прямое TCP-соединение;
• работа через системный трей;
• ручная и автоматическая настройка Telegram;
• поддержка Windows, macOS и Linux;
• отдельные сборки для старых версий Windows.

Схема подключения

Telegram Desktop → TG WS Proxy → WebSocket → Telegram DC

После запуска TG WS Proxy открывает локальный MTProto-порт, принимает соединение от Telegram Desktop, извлекает идентификатор дата-центра из начального MTProto-пакета и создаёт соединение с соответствующим Telegram DC.

Если WebSocket-маршрут недоступен или сервер возвращает перенаправление, приложение может использовать CfProxy либо подключиться напрямую по TCP.

Установка в Windows

Скачайте подходящий файл со страницы релизов текущего репозитория:

• TgWsProxy_windows.exe — Windows 10 и новее;
• 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 и продолжит работать через значок в системном трее.

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

Через контекстное меню значка TG WS Proxy можно выполнить основные действия:

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

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

Через ссылку

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

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

1. Выберите «Скопировать ссылку».
2. Отправьте ссылку себе в «Избранное».
3. Откройте её внутри Telegram.
4. Подтвердите добавление прокси.

Вручную

Откройте:

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

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

• Тип: MTProto
• Сервер: 127.0.0.1
• Порт: 1443
• Secret: значение из настроек TG WS Proxy или файла логов

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

Если не загружаются фото или видео

Иногда медиа может не открываться при использовании нескольких записей DC.

Попробуйте выполнить следующие действия:

1. Откройте настройки TG WS Proxy.
2. Перейдите к полю DC → IP.
3. Удалите остальные записи и оставьте только:

4:149.154.167.220

Если это не решило проблему, полностью очистите список DC → IP и перезапустите прокси.

В качестве дополнительного варианта можно настроить собственный Cloudflare-домен по инструкции из файла CfProxy.md.

Антивирусные срабатывания

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

Перед запуском рекомендуется:

• загружать приложение только из релизов доверенного репозитория;
• проверить файл несколькими антивирусными движками;
• сравнить хеш или подпись файла, если они опубликованы;
• при необходимости использовать сборку для Windows 7 или собрать проект самостоятельно.

Не отключайте защиту системы без необходимости и не запускайте файлы, происхождение которых невозможно проверить.

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

Готовые бинарные версии рассчитаны на следующие системы:

• Windows 10+ x64;
• Windows 10+ ARM64;
• Windows 7 x64;
• Windows 7 x86;
• macOS 10.15+ на Intel;
• macOS 11.0+ на Apple Silicon;
• Linux x86_64.

Для отображения значка приложения в Linux требуется поддержка AppIndicator.

Сборка проекта

Для создания исполняемых файлов используются отдельные PyInstaller-спецификации:

• packaging/windows.spec
• packaging/macos.spec
• packaging/linux.spec

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

• .github/workflows/build.yml

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

• BuildFromSource.md

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

• README.windows.md — установка в Windows;
• README.macos.md — запуск в macOS;
• README.linux.md — варианты установки в Linux;
• README.docker.md — запуск через Docker;
• CfProxy.md — настройка Cloudflare Proxy;
• CfWorker.md — настройка Cloudflare Worker;
• FakeTlsNginx.md — Fake TLS и Nginx;
• TrayConfig.md — расположение и формат файлов конфигурации;
• BuildFromSource.md — запуск из исходного кода.

Лицензия

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

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