# TG WS Proxy (Android)

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

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

> [!CAUTION]
> ### 🔴 ВАЖНО: VPN по умолчанию использовать для работы прокси больше не нужно!

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

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

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

## 🆕 Что нового (v1.0.4)

- 🕰 **[Старое]** Была возвращена логика ручного вписывания адресов. IP по умолчанию: `149.154.167.220`.

![MyCollages (2)](https://github.com/user-attachments/assets/631d88ad-77f6-4e57-b18b-2be3d30b0c1b)

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

```
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. Нажмите **«Запустить прокси»** — появится уведомление о работе в фоновом режиме.
6. Нажмите **«Применить в телеграмм»** — откроется клиент Telegram, останется только нажать «Подключить».

## Лицензия

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