Telegram начинает отваливаться по картинкам и видео, голосовые грузятся по полминуты - первое желание поставить VPN. У VPN есть побочный эффект: он заворачивает весь трафик машины, режет скорость и ломает другие приложения. TG WS Proxy решает узкую задачу - гоняет только трафик Telegram через WebSocket-туннель, остальное не трогает.
Штука живёт на GitHub, обросла форками под Android и Linux, и народ регулярно спрашивает, как этим пользоваться без чтения исходников. Ниже - по шагам: что делать на телефоне, что на компьютере и где обычно сыпется.
Что такое TG WS Proxy и зачем он вообще нужен
Локальный прокси-сервер на MTProto. Звучит страшно, на деле это маленькая программка: поднимается на устройстве, слушает порт 1443, наружу ходит по WSS (WebSocket Secure). Telegram-клиент думает, что общается с обычным MTProto-прокси, а трафик упаковывается в WebSocket и уходит либо напрямую к дата-центрам Telegram, либо через CloudFlare.
Схема: Telegram Android или Desktop - локальный MTProto на 127.0.0.1:1443 - TG WS Proxy - WSS-соединение - дата-центр Telegram. Клиент видит только локальный адрес, всю возню с транспортом берёт на себя прокси.
Практическая выгода - стабильная загрузка медиа и меньше обрывов на нестабильных сетях. Особенно заметно на мобильном интернете в поездках или в офисах, где админ зажал порты. Весь остальной трафик идёт мимо, VPN не нужен.
Android: установка APK и запуск в три тапа
Самый простой путь - Android-форк от amurcanov, он же tg-ws-proxy-android. Свежий APK лежит на странице релизов соответствующего репозитория на GitHub. Скачиваешь, ставишь, система попросит разрешить установку из неизвестного источника - это нормально для APK не из Play Store.
Дальше всё максимально просто, и это плюс. Открываешь приложение, читаешь короткую справку на первом экране (там реально полезные вещи про порт и поведение в фоне), жмёшь «Запустить прокси». В шторке появится уведомление, что сервис работает - значит, слушает 127.0.0.1:1443 и ждёт подключения.
Теперь кнопка «Применить в Telegram». Она формирует tg://proxy-ссылку и передаёт клиенту. Telegram откроется сам, останется подтвердить. Работает не только со стоковым клиентом, но и с AyuGram, Plus Messenger, NekoGram - они тоже понимают tg://proxy. Если Telegram не открылся автоматически, проверь, что дефолтным обработчиком протокола назначен именно он.
Есть нюанс с батареей. Android любит душить фоновые сервисы. Прокси перестаёт работать через час в фоне - зайди в настройки батареи и сними ограничения с TG WS Proxy. Приложение на Material 3 и Compose, интерфейс не перегружен, но системные оптимизации его всё равно могут прибить.
ПК: Windows, macOS, Linux
На десктопе логика та же, только ставится не APK, а бинарник или пакет под конкретную ОС. Скачиваешь сборку со страницы релизов, кладёшь в папку, откуда не удалишь случайно - если файл исчезнет, ярлык в трее сломается. Запускаешь.
В трее появится иконка в виде буквы Т на синем фоне. Правый клик открывает меню. Там есть «Открыть в Telegram»: прокси сам формирует tg://proxy и передаёт клиенту, тот предлагает подключиться к локальному прокси. Жмёшь «Подключить» - готово.
Автоподключение не сработало или tg://-ссылка не открывается - значит, Telegram Desktop не назначен обработчиком протокола tg://. Лечится установкой Telegram Desktop (да, даже если ты им не пользуешься) или ручной настройкой в клиенте: Настройки - Продвинутые - Тип подключения - Прокси - Добавить. Тип MTProto, сервер 127.0.0.1, порт 1443, логин и пароль пустые.
Для Linux есть готовые .deb и .rpm, ставится через apt или rpm как обычный пакет. На Arch - AUR-пакет tg-ws-proxy-bin (или -git, -cli, если хочется собрать самому). На macOS - универсальный .dmg. Хочешь из исходников - pip install -e . и tg-ws-proxy-tray-macos.
Docker-вариант для тех, кто держит всё в контейнерах. Собирается из исходников, конфиг монтируется volume'ом. Удобно, когда прокси нужен на домашнем сервере или NAS и к нему подключаются несколько устройств.
Работа через локальную сеть: один прокси на весь дом
Вот это интереснее, и об этом мало кто пишет. TG WS Proxy можно поднять на одном устройстве, а подключаться к нему со всех остальных в локальной сети. Компьютер, телефон, планшет, приставка - все ходят через один узел.
Условие одно: прокси должен слушать не только localhost, а все интерфейсы. Запускается с флагом --host 0.0.0.0. Дальше в клиенте указываешь не 127.0.0.1, а локальный IP машины с прокси, например 192.168.1.50, порт тот же 1443. Тип MTProto, логин-пароль пустые.
Сценарий из жизни: на даче роутер с Armbian на Amlogic S912, на нём висит TG WS Proxy. Все телефоны в семье подключаются к нему как к обычному MTProto-прокси. Никаких VPN-приложений на каждом устройстве. Приставка на ARM Linux - собирай из исходников через Python, готовые x86-бинарники не заведутся.
iOS-приложения для TG WS Proxy не существует. Нативным клиентам на iPhone всё равно нужен один узел в сети. Поднимаешь прокси на ПК или роутере, с айфона подключаешься к локальному IP. Не цепляется - почти всегда прокси не слушает 0.0.0.0, либо файрвол на хосте рубит входящие на 1443.
Если не грузятся фото и видео
Самая частая жалоба - текст летает, а медиа висит. Классика при работе через конкретные дата-центры Telegram. В настройках прокси (правый клик по трею - Настройки) есть блок с DC IP. Он позволяет исключить часть дата-центров из маршрута.
В видео-гайдах рекомендуют оставить только IP, начинающиеся с четвёрки, остальное убрать, нажать «Сохранить» и перезапустить прокси. Логика: медиа-трафик Telegram распределяется по конкретным DC, и через WSS-туннель часть из них идёт медленно. Отсечение лишних маршрутов заметно ускоряет загрузку вложений.
Второй момент - CloudFlare. Прокси умеет ходить через CF или напрямую. Через CF медиа тормозят - попробуй отключить проксирование через CF в конфиге, напрямую - наоборот, включить. На разных провайдерах работает по-разному, тут только эмпирика.
Автозапуск и стабильность в фоне
Прокси, который не стартует после перезагрузки, - это прокси, который ты запускаешь вручную каждый раз. На ПК в настройках покрути в самый низ, поставь галочку «Автозапуск при включении компьютера», сохрани. Прокси будет подниматься при логине и сразу готов к подключению.
На Android автозапуск работает через foreground-сервис с уведомлением. Жить после ребута - разреши автозапуск в настройках батареи. Некоторые прошивки (Xiaomi, Huawei) дополнительно требуют «Автозапуск» в системных настройках приложений, без этого сервис умрёт после перезагрузки.
Отдельно про роутеры и серверы: ставишь прокси на постоянно включённое устройство - настрой systemd-юнит или автозагрузку через rc.local. Проще один раз, чем вспоминать, почему у всех в доме «Телеграм отвалился» после отключения электричества.
Что делать, если прокси не работает
Первое - проверь, что сервис вообще запущен. На ПК иконка в трее, на Android - уведомление в шторке. Нет уведомления - нет прокси, всё остальное бессмысленно.
Второе - порт. В конфиге стоит не 1443, а что-то другое - в клиенте надо указывать его же. Ошибка на этом шаге встречается постоянно, особенно когда люди ставят несколько прокси-серверов.
Третье - клиент. Telegram Desktop не любит, когда tg://-протокол захвачен другим приложением. Проверь настройки протоколов в системе. На Linux это xdg-open, на Windows - «Приложения по умолчанию».
Четвёртое - сеть. Прокси ходит через WSS, а WSS - это 443 порт. Провайдер или корпоративный файрвол рубит WebSocket-соединения или делает MITM-фильтрацию - туннель просто не встанет. В таких случаях помогает маршрут через CloudFlare, если он включён в конфиге.
Когда одного прокси недостаточно
TG WS Proxy - решение для своих устройств, не более. Он поднимается локально у тебя, работает под твоей ответственностью. Раздаёшь его через 0.0.0.0 - фактически открываешь точку входа в локальную сеть. Продумай файрвол, ограничь доступ по IP, не оставляй 1443 торчать наружу без надобности.
Задачам, где нужна нормальная инфраструктура - несколько точек входа, смена IP, геораспределение, стабильные пулы - локальный прокси не подходит. Там уже нужны серверные прокси из каталога с понятными тарифами и протоколами. Для парсинга, обкатки рекламных кабинетов, работы с API из разных регионов - это отдельная история, и её решают другим инструментом. Посмотреть, что доступно по протоколам и гео, можно в каталоге прокси 3seller - там и SOCKS5, и HTTP, и MTProto-варианты под разные задачи.
Разница простая: TG WS Proxy - про твой телефон и твой ноут, чтобы Telegram работал стабильно. Серверный прокси - про рабочие процессы, где нужна предсказуемость и смена адресов. Смешивать их в голове не стоит, это разные инструменты под разные задачи.
Что в сухом остатке
TG WS Proxy - одна из немногих утилит, которые делают ровно то, что обещают, и не лезут дальше. Android-форк ставится за минуту, десктопная версия - за две. Локальная сеть настраивается через --host 0.0.0.0, iOS подключается через тот же локальный узел. Основные грабли - батарея на Android, порт в клиенте, протокол tg:// на десктопе и медиа-трафик через конкретные DC.
Начни с простого: поставь на телефон, запусти, примени в Telegram, проверь загрузку фото и видео. Всё ок - двигайся дальше, поднимай один узел на весь дом. Медиа висят - копай в сторону DC IP и маршрута через CloudFlare. Нужен масштаб - смотри в сторону нормальных прокси-пулов, а не пытайся вырастить инфраструктуру из утилиты для одного устройства.