SSD Nodes Learn Hosting plans →
Руководства Matt ConnorАвтор: Matt Connor

TG WS Proxy: настройка Telegram Desktop через WebSocket

Что делает TG WS Proxy от Flowseal, кто видит ваш трафик, как подключить его в Telegram Desktop и что делать, если не грузятся фото или прокси перестал работать.

Что такое TG WS Proxy и как он работает

TG WS Proxy представляет собой локальный MTProto-прокси для Telegram Desktop. Программа запускается на вашем же компьютере и слушает адрес 127.0.0.1:1443. Она передаёт трафик Telegram к его серверам через WebSocket-соединения поверх TLS. Отдельный сервер для этого не нужен, поэтому нет и чужого владельца прокси, который видел бы ваш IP-адрес. Это не VPN: программа работает для Telegram, включая мобильные клиенты по локальной сети, и ничего не меняет для браузера и других приложений.

Сначала несколько терминов. MTProto это собственный протокол Telegram, на нём клиент общается с серверами. DC (data center, дата-центр) это группа серверов Telegram. У каждого DC есть номер, и ваш аккаунт живёт в одном из них. WebSocket это способ держать постоянное соединение внутри обычного HTTPS. TLS (transport layer security) это шифрование, которое использует любой сайт с адресом https://.

Проект ведёт на GitHub пользователь Flowseal, код распространяется под лицензией MIT. В README нет списка мейнтейнеров, есть только график участников (по состоянию на 21 ноября 2026 года). Схема из README выглядит так:

Telegram Desktop → MTProto Proxy (127.0.0.1:1443) → WebSocket → Telegram DC

По шагам README описывает работу так:

  1. Приложение поднимает MTProto-прокси на 127.0.0.1:1443.
  2. Оно перехватывает подключения к IP-адресам Telegram.
  3. Из первого служебного пакета MTProto (obfuscation init) оно узнаёт номер DC, к которому идёт клиент.
  4. Оно открывает WebSocket-соединение по TLS к этому DC через домены Telegram.
  5. Если WebSocket недоступен и сервер отвечает перенаправлением 302, программа сама переключается на маршрут CfProxy через Cloudflare или на прямое TCP-соединение.

Данные внутри остаются в том же зашифрованном виде, в каком их отправил Telegram Desktop. Прокси меняет только транспорт. Вместо прямого соединения с адресами Telegram получается HTTPS-соединение с WebSocket внутри.

Кто что видит: почему TG WS Proxy не VPN

README говорит одно: данные передаются в том же зашифрованном виде, и сторонние серверы не нужны. Про анонимность, VPN и провайдера в README ничего нет. Всё, что ниже, это выводы из самой схемы работы, а не обещания автора.

  • Владелец прокси. Его нет. Прокси работает на вашем компьютере, так что ваш IP не попадает к постороннему администратору, как бывает с публичными MTProto-прокси из каналов.
  • Провайдер. Он видит TLS-соединения с вашего компьютера к серверам Telegram. Содержимое он прочитать не может. Но сам факт соединения с Telegram не скрыт, потому что адрес назначения остаётся адресом Telegram.
  • Telegram. Он видит ваш аккаунт как обычно: тот же номер, те же чаты. Прокси не делает вас анонимным для мессенджера.
  • Cloudflare. Если сработал запасной маршрут CfProxy или вы включили Cloudflare Worker, трафик идёт через сеть Cloudflare. Подробности ниже, в разделе про поломки.

Поэтому TG WS Proxy решает одну задачу: Telegram Desktop снова грузит чаты там, где прямые соединения с Telegram режутся. Для браузера, YouTube или рабочих сервисов он ничего не делает.

Какую версию ставить: v1.11.4

По состоянию на 21 ноября 2026 года последний релиз Flowseal на GitHub это v1.11.4. Он вышел 1 ноября и отмечен как Latest. В его заметках два пункта: исправление совместимости с другими ОС и различные улучшения и исправления. Это руководство написано под v1.11.4.

Если у вас стоит v1.11.3, обновитесь. В заметках к v1.11.3 автор сам пишет, что эта версия несовместима с некоторыми ОС, и советует пока использовать v1.11.2. Исправление он обещал в следующем обновлении, и оно вошло в v1.11.4. В той же v1.11.3 TLS-соединение перестало использовать X25519MLKEM768, потому что с ним первый пакет соединения (ClientHello) получался слишком большим.

Инструкции в папке docs/ (CfProxy.md, CfWorker.md, TrayConfig.md) лежат в основной ветке репозитория. Они могут отличаться от того, что было на момент тега v1.11.4. Если пункт настроек у вас называется иначе, смотрите README своей версии.

Где скачать TG WS Proxy и как проверить файл

Скачивайте только из двух мест: со страницы релиза v1.11.4 на GitHub или с зеркала на SourceForge. Зеркало автор сам указал в заметках к релизу для тех, у кого GitHub не открывается. Сборки из Telegram-каналов и с файлообменников не берите. Под названием популярной программы легко раздать что угодно.

В релизе v1.11.4 лежат такие файлы:

  • TgWsProxy_windows.exe для Windows 10 и новее, x64;
  • TgWsProxy_windows_arm64.exe для Windows 10 и новее на ARM64;
  • TgWsProxy_windows_7_64bit.exe и TgWsProxy_windows_7_32bit.exe для Windows 7;
  • TgWsProxy_macos_universal.dmg для macOS: Intel с версии 10.15, Apple Silicon с версии 11.0;
  • TgWsProxy_linux_amd64, а также пакеты .deb и .rpm для Linux x86_64.

На Linux для значка в системном трее нужен AppIndicator. Без него программа не покажет меню в трее. Для запуска в Docker в репозитории есть отдельная инструкция.

Файла SHA256SUMS в релизе нет. Зато GitHub показывает на странице релиза отпечаток sha256 рядом с каждым файлом. Ещё в релизе есть аттестация сборки (Release attestation). Посчитайте хэш скачанного файла и сравните его с тем, что показан на странице:

sha256sum TgWsProxy_linux_amd64
shasum -a 256 TgWsProxy_macos_universal.dmg
Get-FileHash .\TgWsProxy_windows.exe -Algorithm SHA256

Первая команда для Linux, вторая для macOS, третья для PowerShell в Windows. Каждая печатает строку из 64 шестнадцатеричных символов. Она должна совпасть с отпечатком на странице GitHub символ в символ. Если не совпала хотя бы одна буква, файл не тот: удалите его и скачайте заново с GitHub. Почему это работает и чем хэш отличается от подписи, разобрано в руководстве как проверять загрузки по контрольным суммам.

Почему антивирус считает TG WS Proxy вирусом

README прямо пишет: антивирусы часто ошибочно помечают приложение как вирус из-за упаковщика. Упаковщик собирает программу и всё, что ей нужно, в один исполняемый файл. README называет причиной именно этот способ сборки, а не то, что программа делает.

Отключать антивирус мы не советуем. Делайте так:

  1. Проверьте sha256 файла по странице релиза, как описано выше. Совпавший хэш значит, что у вас ровно тот файл, который выложен в релизе.
  2. Если антивирус всё равно удаляет файл, README предлагает скачать сборку для Windows 7. По функциям она не отличается.
  3. Если файл с совпавшим хэшем всё равно помечен, добавьте в исключения антивируса именно этот файл, а не всю папку загрузок.

Если хэш не совпал, никаких исключений не добавляйте. В этом случае антивирус, скорее всего, прав.

Как подключить TG WS Proxy в Telegram Desktop

Запустите TG WS Proxy. В системном трее появится значок с меню. В v1.11.4 в нём такие пункты: «Открыть в Telegram», «Скопировать ссылку», «Перезапустить прокси», «Настройки...», «Открыть логи» и «Выход».

Самый простой путь: нажмите «Открыть в Telegram». Telegram Desktop откроет окно добавления прокси, и вам останется подтвердить. Если этот пункт не сработал, нажмите «Скопировать ссылку», отправьте её себе в «Избранное» и нажмите на неё там.

Ручная настройка по README:

  1. Telegram → Настройки → Продвинутые настройки → Тип подключения → Прокси.
  2. Тип: MTProto.
  3. Сервер: 127.0.0.1.
  4. Порт: 1443.
  5. Secret: возьмите его из настроек программы или из логов.

Сервер и порт можно переопределить в настройках TG WS Proxy. Если вы их меняли, укажите свои значения. В какой именно строке логов лежит secret, README не уточняет. Поэтому ссылка из трея надёжнее: в ней уже есть все три значения. Если вы запустили программу в Docker по инструкции из репозитория, ссылку покажет такая команда:

docker logs tg-ws-proxy 2>&1 | grep 'tg://proxy'

Она печатает строку вида tg://proxy?server=...&port=1443&secret=.... Откройте эту ссылку в Telegram.

Теперь проверьте, что прокси действительно слушает порт. На Linux:

ss -ltn | grep 1443

Вы должны увидеть строку с LISTEN и 127.0.0.1:1443. На macOS команды ss нет, там то же покажет netstat -an | grep 1443. В Windows откройте командную строку и выполните netstat -an | findstr 1443, в выводе должна быть строка с LISTENING. Пустой вывод значит, что программа не запущена или не смогла занять порт. В этом случае откройте логи через пункт «Открыть логи».

Последняя проверка: откройте чат, где есть новые сообщения. Если они загрузились, прокси работает.

Есть ли TG WS Proxy для Android и iPhone

У Flowseal есть только сборки для Windows, macOS и Linux, плюс инструкция для Docker. Про Android и iOS в README нет ни слова, ссылок на мобильные версии тоже нет (по состоянию на 21 ноября 2026 года). Мобильные приложения ниже сделаны другими людьми.

При этом мобильный Telegram на Android и iPhone подключается к TG WS Proxy на компьютере по локальной сети. Запустите прокси с --host 0.0.0.0, а в настройках MTProto-прокси на телефоне укажите локальный IP компьютера, порт 1443 и secret программы. Телефон должен быть в той же локальной сети, а компьютер с прокси должен оставаться включённым. Отдельное приложение прокси на телефоне для этого не нужно.

  • tg-ws-proxy-rs от пользователя GitHub valnesfjord. Автор называет его «Rust vibecoded port» программы Flowseal, то есть порт на Rust, написанный в основном с помощью ИИ. Есть приложение для Android (от Android 8.0), лицензия MIT. Приложение есть в F-Droid под именем пакета io.github.valnesfjord.tgwsproxyrs, автором там указан Ivan Utenkov. На 21 ноября 2026 года на GitHub вышла v2.7.2 (20 ноября), а F-Droid показывает 2.7.0, то есть отстаёт. F-Droid ставит приложению пометку «Non-Free Network Services: Depends on Cloudflare and Telegram's network».
  • tg-ws-proxy-ANDROID от LemoLev. Владелец перевёл репозиторий в архив 21 марта 2026 года, и в нём написано: «РЕПОЗИТОРИЙ БОЛЬШЕ НЕ РАЗРАБАТЫВАЕТСЯ». Лицензия не указана. Как замену автор называет репозиторий LemoLev/tgwsp-android-rewrite, полностью переписанный на Java, кроме серверной части.

Это не полный список. Поиск на GitHub находит десятки других Android-проектов с таким названием. Для iOS у Flowseal сборки нет. На GitHub есть неофициальные исходники для iOS, например со сборкой через Xcode, но мы их не проверяли и не советуем. Любой из этих портов это чужой код, через который идёт весь ваш трафик Telegram. Ставьте только то, чему готовы доверять.

У tg-ws-proxy-rs есть ещё один вариант: роутер. Порт работает на OpenWrt и ImmortalWrt (пакет LuCI luci-app-tg-ws-proxy-rs, версия 25.12 и новее для APK или 24.10 для opkg). Он работает и на Keenetic и других роутерах с Entware: там используется тот же статический бинарник на musl. Такой прокси помогает устройствам в вашей домашней сети Wi-Fi, если в их Telegram указан прокси на роутере. Как только телефон уходит на мобильный интернет, он с роутером больше не связан, и прокси перестаёт работать.

Почему через TG WS Proxy не грузятся фото и видео

Это самый частый вопрос, и в README на него есть свой ответ. По README, проблема встречается на аккаунтах без Premium. Порядок действий такой:

  1. Откройте «Настройки...» в меню трея и найдите поле DC → IP.
  2. Удалите в нём всё, кроме 4:149.154.167.220.
  3. Если не помогло, очистите поле полностью.
  4. Если и это не помогло, настройте собственный домен по инструкции CfProxy.md из репозитория.

После каждого изменения нажмите «Перезапустить прокси» в трее и проверьте альбом или видео в чате. Значение для поля DC → IP взято из README на 21 ноября 2026 года. Автор может его поменять, поэтому перед правкой сверьтесь с README своей версии.

TG WS Proxy перестал работать: что проверить

Сначала простое. Посмотрите, какая у вас версия: v1.11.3 может не работать на части систем. Нажмите «Перезапустить прокси». Откройте логи: если там ошибки соединения, проблема в сети, а не в настройке Telegram.

Дальше важно понять запасной маршрут. Когда прямой WebSocket к Telegram недоступен и сервер отвечает 302, программа сама уходит на CfProxy или на прямое TCP. CfProxy идёт через Cloudflare. Инструкция CfProxy.md (основная ветка, на 21 ноября 2026 года) предупреждает о двух вещах:

  • подсеть Cloudflare может быть заблокирована, например в России;
  • у Cloudflare есть лимиты на число одновременных WebSocket-подключений, поэтому домен по умолчанию может перестать работать в любой момент.

В приложение встроен общий набор резервных доменов, который обновляется с GitHub. Против блокировки подсети Cloudflare инструкция советует добавить домен в программу обхода DPI (deep packet inspection, глубокий анализ трафика), например zapret. Кроме этого, у вас есть два собственных варианта.

Свой домен (CfProxy). Инструкция сама пишет, что домен по умолчанию можно и желательно заменить на свой. Нужен домен на Cloudflare, режим SSL/TLS «Flexible» и несколько A-записей вида kws1, kws2 и так далее, которые указывают на IP-адреса DC Telegram. Точный список записей берите из CfProxy.md в момент настройки. Трафик в этом случае идёт через Cloudflare.

Cloudflare Worker. Инструкция CfWorker.md описывает его как полностью бесплатный путь, для которого не нужно покупать домен. У тарифа Workers Free есть лимиты: на 22 ноября 2026 года это 100 000 запросов в день и 10 мс процессорного времени на вызов. Вы разворачиваете Worker на workers.dev. Он открывает соединение с адресом назначения и передаёт данные через путь /apiws. Cloudflare здесь тоже стоит в цепочке.

В обоих вариантах содержимое остаётся зашифрованным MTProto. Но Cloudflare стоит посередине и видит соединения с вашего адреса к вашему домену или Worker. Если и эти варианты не помогли, значит, режут и Cloudflare, и прямые адреса. Тогда локальный прокси не поможет, и пора переходить к последнему разделу.

Чем TG WS Proxy отличается от WEB-прокси в Telegram Desktop 7.1

В августе 2026 года в Telegram Desktop 7.1 появился новый тип прокси, WEB, а в 7.1.2 добавили предупреждение о возможных рисках при добавлении WEB-прокси. Это не TG WS Proxy и не его замена. WEB-прокси нужен сервер, на котором работает tproxy-server, и README этого проекта сам называет его серверной половиной прототипа (proof-of-concept) WEB-прокси для Telegram. Серверная схема там такая: Caddy, за ним tproxy-server, за ним официальный MTProxy. Нужны отдельное имя хоста, сервер Linux x86_64, публичный IPv4 и порты 80 и 443. TG WS Proxy не требует никакого сервера и работает на вашем компьютере. По состоянию на 21 ноября 2026 года стабильная версия Telegram Desktop на GitHub это 7.4.4 от 13 ноября.

Когда пора переходить на свой прокси или VPN

TG WS Proxy хорош, пока у вас компьютер и пока прямой WebSocket к Telegram проходит. Его границы видны сразу. На телефоне официальной версии нет, но мобильный Telegram подключается к программе на компьютере по локальной сети. На мобильном интернете роутерный вариант не помогает. Запасной маршрут зависит от Cloudflare.

Если Telegram нужен на телефоне в мобильной сети, следующий шаг это свой MTProto-прокси на VPS за границей. Его владелец вы сами, так что ваш IP видит только ваш сервер. Такой прокси не зависит от вашего компьютера или роутера, поэтому подходит и для телефона на мобильном интернете. Если блокируют не только Telegram, нужен VPN для всего устройства. Что ставить, когда сам VPN-протокол режут по сигнатуре, разобрано в руководстве что запускать, когда ваш VPN блокируют. А если вам важнее скрыть сам факт подключения, посмотрите, как работают мосты Tor и подключаемые транспорты.

FAQ

TG WS Proxy это VPN?

Нет. Это локальный MTProto-прокси на 127.0.0.1:1443, который работает для Telegram Desktop и мобильного Telegram по локальной сети. Браузер и другие программы ходят в сеть как раньше. Анонимности он не даёт: Telegram видит ваш аккаунт как обычно, а провайдер видит соединения с серверами Telegram, хотя и не может прочитать их содержимое.

Есть ли TG WS Proxy для Android и iPhone?

У автора, Flowseal, есть сборки только для Windows, macOS и Linux (по состоянию на 21 ноября 2026 года). Мобильный Telegram на Android и iPhone подключается к прокси на компьютере по локальной сети: запустите программу с --host 0.0.0.0, а на телефоне укажите IP компьютера, порт и secret. Для Android есть сторонние порты, например tg-ws-proxy-rs от valnesfjord в F-Droid. Старый Android-репозиторий LemoLev заархивирован. Для iOS официальной сборки нет, есть непроверенные сторонние проекты на GitHub. Для телефона на мобильном интернете надёжнее свой MTProto-прокси на VPS.

Почему через TG WS Proxy не грузятся фото и видео?

По README это бывает на аккаунтах без Premium. В настройках программы в поле DC → IP оставьте только 4:149.154.167.220, затем перезапустите прокси. Если не помогло, очистите поле полностью. Если и это не помогло, настройте собственный домен по инструкции CfProxy.md. Перед правкой сверьте значение с README своей версии.

Почему антивирус удаляет TgWsProxy_windows.exe?

README объясняет это упаковщиком: программа собрана в один исполняемый файл, и антивирусы часто ошибочно принимают его за вирус. Не отключайте антивирус. Сначала сравните sha256 файла с отпечатком на странице релиза GitHub. Если хэш совпал, попробуйте сборку для Windows 7, она по функциям такая же, или добавьте в исключения только этот файл.

TG WS Proxy работал, а теперь перестал. Что делать?

Если стоит v1.11.3, обновитесь до v1.11.4 и перезапустите прокси через меню трея. Когда прямой WebSocket недоступен, программа уходит на запасной маршрут через Cloudflare. Его подсеть может быть заблокирована, а общие резервные домены бывают перегружены и отвечают HTTP 429. Помогает свой домен или свой Cloudflare Worker. Если не помогает и это, нужен свой прокси на VPS или VPN.

Была ли эта статья полезной?

#telegram#mtproto#proxy#websocket#censorship#russia