TG WS Proxy Android

Это мобильный форк популярного TG WS Proxy от Flowseal, переработанный для комфортного использования на современных смартфонах.

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

• Краши и проблемы с установкой: если у вас возникают сбои, вылеты или ошибки при установке, пожалуйста, сохраняйте отчёты и ссылки на них. Также ознакомьтесь с блоком CAUTION ниже и поднимайте полноценные issue с полезной технической информацией.

---

---

🎦 Видео гайд по установке и использованию

Смотреть на YouTube

Смотреть на Dzen

Смотреть на VK Video

Смотреть в Telegram

---

Возможности Android-версии

• Современный UI/UX: приложение полностью адаптировано под актуальный Android-интерфейс на базе Material 3 и Jetpack Compose. Основные действия доступны быстро и без перегруженных экранов.
• Интеграция с Telegram: кнопка «Применить в Telegram» автоматически передаёт прокси в совместимые клиенты через tg://proxy (AyuGram, Plus Messenger, NekoGram и другие).
• Фоновый режим: используется Foreground Service, уведомление о работе сервиса и дополнительная логика удержания соединения, чтобы Android не выгружал прокси слишком агрессивно.
• Лог-вьюер: встроенный просмотр событий в реальном времени помогает быстро понять, что происходит с подключением, маршрутом и пулом соединений.
• Темы и палитры: поддерживаются Dynamic Colors на Android 12+, а также встроенные палитры для более старых устройств.
• Авто-обновления внутри приложения: вручную проверять релизы больше не нужно — когда выйдет новая версия, приложение само покажет уведомление об обновлении.
• Раздел «Информация»: внутри приложения есть расширенная справка по настройкам, особенностям CloudFlare, пулу WS-соединений и ручной конфигурации датацентров.

Что нового в версии 1.1.3

• Новый редизайн: интерфейс приложения переработан в сторону более современного UI/UX. Обновлены навигация, карточки, визуальная иерархия и общее ощущение от работы с приложением.
• Багфиксы модальных окон: улучшена работа модальных окон и вспомогательных диалогов. Разделы справки, обновлений, донатов и ручной настройки теперь ощущаются аккуратнее и стабильнее.
• Основной акцент обновления — ядро прокси: большая часть работы проведена внутри нативного движка. Улучшена обработка сетевых сценариев, резервных маршрутов, WS-подключений и фонового удержания соединения.
• Повышение стабильности работы: была предпринята попытка добавить больше техник и алгоритмов для более долгой и живучей работы прокси на Android, особенно в нестабильных мобильных сетях.
• Без ложных обещаний: несмотря на улучшения, долгая непрерывная и абсолютно стабильная работа всё ещё не может гарантироваться на каждом устройстве, операторе и Android-прошивке.
• Обновлён раздел «Информация»: улучшена визуальная подача справки, добавлены дополнительные пояснения по функционалу приложения и более полезная информация для настройки.
• Нужен фидбек: этот релиз в первую очередь посвящён багфиксам и улучшению ядра прокси. Если заметите изменения в стабильности, скорости подключения, фоне или работе через CloudFlare, обратная связь будет особенно полезна.

---

Как это работает

Telegram Android → Локальный MTProto (по умолчанию 127.0.0.1:1443) → TG WS Proxy → WSS (через CloudFlare или напрямую) → Telegram DC

1. Приложение поднимает локальный MTProto-прокси средствами нативного движка на языке Go.
2. Перехватывает подключения Telegram через локальный порт и сгенерированный секретный ключ.
3. Извлекает DC ID из исходного пакета и устанавливает защищённое WebSocket (TLS) соединение с нужным датацентром, при необходимости проксируя трафик через CloudFlare.
4. Использует пул соединений, keepalive-механику и fallback-сценарии для более устойчивой работы в реальных сетевых условиях.

Быстрый старт

1. Скачайте актуальный APK со страницы релизов.
2. Установите приложение на ваш Android-смартфон.
3. Откройте TG WS Proxy Android.
4. Ознакомьтесь со справкой внутри приложения.
5. Нажмите «Запустить прокси» — появится уведомление о работе в фоновом режиме.
6. Нажмите «Применить в Telegram» — откроется Telegram-клиент, где останется только подтвердить подключение.

---

Caution

Важная информация по стабильности и отчётам

Приложение стало заметно лучше адаптировано под мобильные сети и уже настроено для работы «из коробки», однако проблемы с длительной фоновой стабильностью всё ещё могут проявляться на отдельных устройствах и прошивках. Это не всегда связано именно с UI или Android-частью приложения: часть ограничений приходит со стороны сети, энергосбережения системы, вендорских оптимизаций и маршрута до Telegram.

Если вы поднимаете вопрос о проблеме, пожалуйста, сразу указывайте:

• версию Android;
• модель устройства;
• версию Telegram-клиента;
• название мода Telegram, если используется;
• включён ли CloudFlare;
• что именно происходит: краш, бесконечное подключение, обрыв в фоне, невозможность установки и так далее.

---

Лицензия

Этот форк распространяется под лицензией GPLv3. Оригинальный код tg-ws-proxy от Flowseal доступен под лицензией MIT.