mirror of
https://github.com/Flowseal/tg-ws-proxy.git
synced 2026-05-22 23:41:44 +03:00
Merge branch 'main' of https://github.com/amurcanov/tg-ws-proxy-android
This commit is contained in:
49
README.md
49
README.md
@@ -1,37 +1,56 @@
|
||||
# TG WS Proxy (Android)
|
||||
|
||||
**Локальный SOCKS5-прокси** для Telegram Android, который **ускоряет работу Telegram**, перенаправляя трафик через WebSocket-соединения.
|
||||
**Локальный MTProto-прокси** для Telegram Android, который **ускоряет работу Telegram**, перенаправляя трафик через защищённые CloudFlare WebSocket-соединения или напрямую.
|
||||
|
||||
Это мобильный форк популярного SOCKS5/WS прокси, кардинально переработанный для удобного использования на смартфонах.
|
||||
<img width="969" height="646" alt="MyCollages" src="https://github.com/user-attachments/assets/cd074a98-8e73-48a7-a5b9-089106a6cd5b" />
|
||||
|
||||
Это мобильный форк популярного WS прокси, кардинально переработанный для удобного использования на смартфонах.
|
||||
|
||||
> [!CAUTION]
|
||||
> ### 🔴 ВАЖНО: VPN по умолчанию использовать для работы прокси больше не нужно!
|
||||
> ### 🔴 ВАЖНО:
|
||||
> ### Приложение работает "из коробки". Перед использованием нажмите кнопку "Пожалуйста, ознакомьтесь" внутри приложения.
|
||||
|
||||
## 🌟 Что реализовано в Android-версии
|
||||
|
||||
Функции управления вынесены в красивый и удобный **Material 3** интерфейс (Jetpack Compose).
|
||||
|
||||
- **Полноценный UI:** Настройка порта, пула датацентров и количества WebSocket соединений делается в 2 клика.
|
||||
- **Интеграция с Telegram:** Кнопка «Применить в телеграмм» автоматически настроит прокси через систему глубоких ссылок (`tg://socks`) для любого установленного клиента (AyuGram, Plus Messenger, NekoGram и др.).
|
||||
- **Полноценный UI:** Настройка порта, пула датацентров и режима CloudFlare делается в 2 клика.
|
||||
- **Интеграция с Telegram:** Кнопка «Применить в телеграмм» автоматически настроит прокси через систему глубоких ссылок (`tg://proxy`) для любого установленного клиента (AyuGram, Plus Messenger, NekoGram и др.).
|
||||
- **Стабильная работа в фоне:** Приложение использует «неубиваемый» `Foreground Service` и самоконтроль Wakelock'ов, чтобы Android не "душил" прокси в спящем режиме.
|
||||
- **Встроенный просмотрщик логов:** В реальном времени отображаются логии работы для диагностики.
|
||||
- **Встроенный просмотрщик логов:** В реальном времени сгруппировано отображаются логи работы для удобной диагностики без падения FPS.
|
||||
- **Динамические цвета и темы:** Поддержка светлой и темной тем, а также Material You (в Android 12+).
|
||||
|
||||
## 🆕 Что нового (v1.0.4)
|
||||
## 🆕 Что нового (v1.0.6)
|
||||
|
||||
**ОБНОВЛЕНИЕ ВЫПУЩЕНО ПО МОТИВАМ ВЕРСИИ 1.6.1 от FlowSeal**
|
||||
|
||||
* **Ядро проксирования было полностью переписано под протокол MTProto — техническая стабильность и общая скорость подключения теперь выше**
|
||||
* **Интегрировано продвинутое проксирование через CloudFlare — внедрён автоматический режим получения DC от Telegram, лучше подходит для использования с проксированием через CloudFlare**
|
||||
* **Сохранён классический режим ручной настройки датацентров — по умолчанию отказоустойчивый IP зафиксирован на лондонском узле `149.154.167.220` (DC4)**
|
||||
* **Реализована полная кросс-архитектурная совместимость — теперь ядро и приложение нативно поддерживает как актуальные устройства `arm64-v8a`, так и более старые `armeabi-v7a`**
|
||||
* **Проведён масштабный редизайн приложения — внедрена компоновка, переработаны модальные окна, добавлена удобная полуавтоматическая система проверки обновлений**
|
||||
* **Багфикс — исправлена проблема со слетающей тёмной/светлой темой UI**
|
||||
|
||||
🔴 **ВНИМАНИЕ: КРИТИЧЕСКАЯ ИНФОРМАЦИЯ** 🔴
|
||||
Из-за смены релизной подписи приложения, поверх старой версии это обновление не встанет. **Вам необходимо полностью удалить предыдущую версию перед установкой новой** (приношу свои извинения!).
|
||||
|
||||
💡 **СОВЕТ ДЛЯ ПОЛЬЗОВАТЕЛЕЙ:**
|
||||
Приложение уже оптимально настроено и готово к работе "из коробки". **Крайне рекомендуем нажать на кнопку «Пожалуйста, ознакомьтесь» перед стартом.**
|
||||
Если вы точно знаете, что делаете — вы можете менять порты, отключать проксирование через CloudFlare и задавать ручные адреса. Но если не уверены в назначении тумблера — лучше оставьте его по умолчанию и следуйте инструкциям в "Пожалуйста ознакомьтесь" ниже "Применить в Telegram"!
|
||||
|
||||
**Подключение через CloudFlare может занимать около 1-10 секунд, см лог событий. В случае проблем - пожалуйста поднимите вопрос.**
|
||||
|
||||
- 🕰 **[Старое]** Была возвращена логика ручного вписывания адресов. IP по умолчанию: `149.154.167.220`.
|
||||
|
||||

|
||||
|
||||
## Как это работает
|
||||
|
||||
```
|
||||
Telegram Android → SOCKS5 (по умолчанию 127.0.0.1:1080) → TG WS Proxy → WSS → Telegram DC
|
||||
Telegram Android → Локальный MTProto (по умолчанию 127.0.0.1:1443) → TG WS Proxy → WSS (через CloudFlare или напрямую) → Telegram DC
|
||||
```
|
||||
|
||||
1. Приложение поднимает локальный SOCKS5-прокси средствами нативного движка на языке **Go**.
|
||||
2. Перехватывает подключения к IP-адресам Telegram.
|
||||
3. Извлекает DC ID из MTProto-пакета и устанавливает защищенное WebSocket (TLS) соединение.
|
||||
1. Приложение поднимает локальный MTProto-прокси средствами нативного движка на языке **Go**.
|
||||
2. Перехватывает подключения Telegram с помощью локального порта и сгенерированного секретного ключа.
|
||||
3. Извлекает DC ID из оригинального пакета и устанавливает защищенное WebSocket (TLS) соединение с нужным датацентром, при необходимости проксируя через сеть CloudFlare.
|
||||
4. Эффективно мультиплексирует трафик.
|
||||
|
||||
## 🚀 Быстрый старт
|
||||
@@ -39,10 +58,10 @@ Telegram Android → SOCKS5 (по умолчанию 127.0.0.1:1080) → TG WS P
|
||||
1. Перейдите на **[страницу релизов]** и скачайте актуальный `APK`-файл.
|
||||
2. Установите приложение на ваш Android-смартфон.
|
||||
3. Откройте **TG WS Proxy**.
|
||||
4. Выберите требуемый пул IP-адресов.
|
||||
4. Ознакомьтесь со справкой.
|
||||
5. Нажмите **«Запустить прокси»** — появится уведомление о работе в фоновом режиме.
|
||||
6. Нажмите **«Применить в телеграмм»** — откроется клиент Telegram, останется только нажать «Подключить».
|
||||
|
||||
## Лицензия
|
||||
|
||||
Этот форк распространяется под лицензией **GPLv3**. (Оригинальный код `tg-ws-proxy` доступен под MIT). Файл лицензии приложен к исходному коду.
|
||||
Этот форк распространяется под лицензией **GPLv3**. (Оригинальный код `tg-ws-proxy` доступен под MIT). Файл лицензии приложен к исходному коду. Автор оригинальной программы - [Flowseal](https://github.com/Flowseal)
|
||||
|
||||
Reference in New Issue
Block a user