Files
tg-ws-proxy/README.md
T
2026-04-14 02:21:15 +03:00

60 lines
5.1 KiB
Markdown

# TG WS Proxy Android
Это мобильный форк популярного [TG WS прокси](https://github.com/Flowseal/tg-ws-proxy) от [Flowseal](https://github.com/Flowseal), переработанный для комфортного использования на современных смартфонах. - **Локальный MTProto-прокси** для Telegram на Android. Помогает частично обходить блокировки и ускоряет работу мессенджера, перенаправляя трафик через защищённые CloudFlare WebSocket-соединения или напрямую к датацентрам.
---
<img width="1000" height="665" alt="tg-ws-proxy" src="https://github.com/user-attachments/assets/34a5a0db-5328-4280-a4b3-3927b237dfee" />
---
## Возможности Android-версии
- **Современный UI:** Управление на базе Material 3 (Jetpack Compose). Настройка в пару тапов.
- **Интеграция с Telegram:** Кнопка «Применить» автоматически прописывает прокси в любом клиенте (AyuGram, Plus, NekoGram и др.) через `tg://proxy`.
- **Фоновый режим:** Использует `Foreground Service`, чтобы система не закрывала прокси при очистке памяти.
- **Лог-вьюер:** Просмотр событий в реальном времени для быстрой диагностики.
- **Темы и палитры:** Поддержка Dynamic Colors (Android 12+) и встроенные цветовые схемы (Индиго, Лес, Эспрессо) для более старых версий.
## Что нового (v1.0.7)
* **Оптимизация UI:** Повышена плавность интерфейса и скорость отклика.
* **Совместимость:** Поддержка Android от **7.0** до **16-й** версии (SDK 36). Нативная работа на `arm64-v8a` и `armeabi-v7a`.
* **Умные DC:** Автоматическая DC-адресация при включенном CloudFlare. В ручном режиме по умолчанию используется лондонский узел (149.154.167.220).
* **Прямая ссылка:** Добавлено копирование ссылки `tg://proxy?` для ручного добавления в моды.
* **FIX:** Исправлена критическая ошибка в секретном ключе (переход с `ee` на корректный `dd`), устраняющая проблемы с рукопожатием.
---
## Как это работает
```
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` со **[страницы релизов](https://github.com/amurcanov/tg-ws-proxy-android/releases)**.
2. Установите приложение на ваш Android-смартфон.
3. Откройте **TG WS Proxy**.
4. Ознакомьтесь со справкой.
5. Нажмите **«Запустить прокси»** — появится уведомление о работе в фоновом режиме.
6. Нажмите **«Применить в телеграмм»** — откроется клиент Telegram, останется только нажать «Подключить».
---
> [!CAUTION]
> ### Теперь работает на мобильных сетях. Приложение настроено из коробки.
> ### Режим без CloudFlare лучше использовать на Wi-Fi. Если скорости на DC4 не хватает, попробуйте прописать тот же IP в поле DC2. Можно так же использовать CloudFlare на Wi-Fi.
> ### На мобильных сетях блокировки значительно *агрессивнее*, поэтому стабильность работы может зависеть от оператора.
---
## Лицензия
Этот форк распространяется под лицензией **GPLv3**. Оригинальный код `tg-ws-proxy` от [Flowseal](https://github.com/Flowseal) доступен под MIT.