tg-ws-proxy/README.md

TG WS Proxy (Android)

Локальный MTProto-прокси для Telegram Android, который ускоряет работу Telegram, перенаправляя трафик через защищённые CloudFlare WebSocket-соединения или напрямую.

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

Caution

🔴 ВАЖНО:

Приложение работает "из коробки". Перед использованием нажмите кнопку "Пожалуйста, ознакомьтесь" внутри приложения.

🌟 Что реализовано в Android-версии

Функции управления вынесены в красивый и удобный Material 3 интерфейс (Jetpack Compose).

• Полноценный UI: Настройка порта, пула датацентров и режима CloudFlare делается в 2 клика.
• Интеграция с Telegram: Кнопка «Применить в телеграмм» автоматически настроит прокси через систему глубоких ссылок (tg://proxy) для любого установленного клиента (AyuGram, Plus Messenger, NekoGram и др.).
• Стабильная работа в фоне: Приложение использует «неубиваемый» Foreground Service и самоконтроль Wakelock'ов, чтобы Android не "душил" прокси в спящем режиме.
• Встроенный просмотрщик логов: В реальном времени сгруппировано отображаются логи работы для удобной диагностики без падения FPS.
• Динамические цвета и темы: Поддержка светлой и темной тем, а также Material You (в Android 12+).

🆕 Что нового (v1.0.6)

ОБНОВЛЕНИЕ ВЫПУЩЕНО ПО МОТИВАМ ВЕРСИИ 1.6.1 от FlowSeal

• Ядро проксирования было полностью переписано под протокол MTProto — техническая стабильность и общая скорость подключения теперь выше
• Интегрировано продвинутое проксирование через CloudFlare — внедрён автоматический режим получения DC от Telegram, лучше подходит для использования с проксированием через CloudFlare
• Сохранён классический режим ручной настройки датацентров — по умолчанию отказоустойчивый IP зафиксирован на лондонском узле 149.154.167.220 (DC4)
• Реализована полная кросс-архитектурная совместимость — теперь ядро и приложение нативно поддерживает как актуальные устройства arm64-v8a, так и более старые armeabi-v7a
• Проведён масштабный редизайн приложения — внедрена компоновка, переработаны модальные окна, добавлена удобная полуавтоматическая система проверки обновлений
• Багфикс — исправлена проблема со слетающей тёмной/светлой темой UI

🔴 ВНИМАНИЕ: КРИТИЧЕСКАЯ ИНФОРМАЦИЯ 🔴 Из-за смены релизной подписи приложения, поверх старой версии это обновление не встанет. Вам необходимо полностью удалить предыдущую версию перед установкой новой (приношу свои извинения!).

💡 СОВЕТ ДЛЯ ПОЛЬЗОВАТЕЛЕЙ: Приложение уже оптимально настроено и готово к работе "из коробки". Крайне рекомендуем нажать на кнопку «Пожалуйста, ознакомьтесь» перед стартом. Если вы точно знаете, что делаете — вы можете менять порты, отключать проксирование через CloudFlare и задавать ручные адреса. Но если не уверены в назначении тумблера — лучше оставьте его по умолчанию и следуйте инструкциям в "Пожалуйста ознакомьтесь" ниже "Применить в Telegram"!

Подключение через CloudFlare может занимать около 1-10 секунд, см лог событий. В случае проблем - пожалуйста поднимите вопрос.

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

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. Эффективно мультиплексирует трафик.

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

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

Лицензия

Этот форк распространяется под лицензией GPLv3. (Оригинальный код tg-ws-proxy доступен под MIT). Файл лицензии приложен к исходному коду. Автор оригинальной программы - Flowseal