# TG WS Proxy (Android)

**Локальный SOCKS5-прокси** для Telegram Android, который **ускоряет работу Telegram**, перенаправляя трафик через WebSocket-соединения.

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

> [!CAUTION]
> ### 🔴 ВАЖНО: Рекомендуемая настройка подключения
> 
> Для корректной работы и обхода блокировок провайдера настоятельно рекомендуется **сначала параллельно запустить VPN**.  
> Если этого не сделать, вместо скоростного соединения по **WebSocket** будет происходить фоллбек (fallback) на обычное **TCP-соединение**, что в общем не гарантирует никаких преемуществ и работы в целом.

## 🌟 Что нового в Android-версии

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

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

![MyCollages](https://github.com/user-attachments/assets/4477809b-c793-4b81-ae13-83907849a0ab)


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

```
Telegram Android → SOCKS5 (по умолчанию 127.0.0.1:1080) → TG WS Proxy → WSS → Telegram DC
```

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

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

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

## Лицензия

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