Skip to content

amurcanov/tg-ws-proxy-android

 
 

Repository files navigation

Telegram WS Proxy Android


Android SDK Rust Version Kotlin Stars

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

Warning

RUST & GOLANG

Ядро проекта переписано на Rust и GO больше не поддерживается. Старое ядро можно найти в сурсах


MyCollages (5)

Возможности 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-соединений и ручной конфигурации датацентров.

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

Telegram Android → Локальный MTProto (по умолчанию 127.0.0.1:1443) → TG WS Proxy → WSS (через CloudFlare или напрямую) → Telegram DC
  1. Приложение поднимает локальный MTProto-прокси средствами нативного движка на языке Rust.
  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-клиент, где останется только подтвердить подключение.

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


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

Note

Отчёты об ошибках

Приложение адаптировано под мобильные сети, однако проблемы с фоновой работой всё ещё возможны из-за системных ограничений или сети.

Если у вас возникла проблема, сбой или вопрос, пожалуйста, нажмите кнопку «Собрать отчёт» внутри приложения и приложите полученные данные к вашему issue. Мелкие ошибки в логах при нормально работающем прокси можно игнорировать.


Лицензия

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

About

Android-форк популярного приложения Flowseal - tg-ws-proxy - локальный прокси-сервер MTProto с проксированием CF или без для частичного обхода проблем загрузки Telegram

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages

  • Kotlin 56.4%
  • Rust 26.6%
  • Go 15.8%
  • Batchfile 1.2%