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

60 lines
5.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.