tg-ws-proxy/README.md

50 lines
4.0 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)
**Локальный SOCKS5-прокси** для Telegram Android, который **ускоряет работу Telegram**, перенаправляя трафик через WebSocket-соединения.
Это мобильный форк популярного SOCKS5/WS прокси, кардинально переработанный для удобного использования на смартфонах.
> [!CAUTION]
> ### 🔴 ВАЖНО: VPN по умолчанию использовать для работы прокси больше не нужно!
> ### Я вкурсе про обновление оригинала и займусь этим позже.. Скоро выпущу просто пследнюю неделю был занят другим своим проектом vk-proxy-turn-andorid...
## 🌟 Что реализовано в 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). Файл лицензии приложен к исходному коду. Автор оригинальной программы - [Flowseal](https://github.com/Flowseal)