Update README.md

This commit is contained in:
amurcanov
2026-04-14 02:21:15 +03:00
committed by GitHub
parent 6a253bf9ad
commit d1ca465f83

View File

@@ -1,44 +1,29 @@
# TG WS Proxy (Android) (1.0.7 - будет проведен второй редизайн и оптимизация производительности интерфейса)
# TG WS Proxy Android
Это мобильный форк популярного [TG WS прокси](https://github.com/Flowseal/tg-ws-proxy) от [Flowseal](https://github.com/Flowseal), переработанный для комфортного использования на современных смартфонах. - **Локальный MTProto-прокси** для Telegram на Android. Помогает частично обходить блокировки и ускоряет работу мессенджера, перенаправляя трафик через защищённые CloudFlare WebSocket-соединения или напрямую к датацентрам.
**Локальный MTProto-прокси** для Telegram Android, который **ускоряет работу Telegram**, перенаправляя трафик через защищённые CloudFlare WebSocket-соединения или напрямую.
---
<img width="969" height="646" alt="MyCollages" src="https://github.com/user-attachments/assets/cd074a98-8e73-48a7-a5b9-089106a6cd5b" />
(не самый ровный интерфейс но я сделал апдейт на скорую руку считай)
<img width="1000" height="665" alt="tg-ws-proxy" src="https://github.com/user-attachments/assets/34a5a0db-5328-4280-a4b3-3927b237dfee" />
Это мобильный форк популярного WS прокси, кардинально переработанный для удобного использования на смартфонах.
---
> [!CAUTION]
> ### 🔴 ВАЖНО: Теперь работает на мобильных сетях.
> ### Приложение работает "из коробки". Перед использованием нажмите кнопку "Пожалуйста, ознакомьтесь" внутри приложения.
## Возможности Android-версии
## 🌟 Что реализовано в Android-версии
- **Современный UI:** Управление на базе Material 3 (Jetpack Compose). Настройка в пару тапов.
- **Интеграция с Telegram:** Кнопка «Применить» автоматически прописывает прокси в любом клиенте (AyuGram, Plus, NekoGram и др.) через `tg://proxy`.
- **Фоновый режим:** Использует `Foreground Service`, чтобы система не закрывала прокси при очистке памяти.
- **Лог-вьюер:** Просмотр событий в реальном времени для быстрой диагностики.
- **Темы и палитры:** Поддержка Dynamic Colors (Android 12+) и встроенные цветовые схемы (Индиго, Лес, Эспрессо) для более старых версий.
Функции управления вынесены в красивый и удобный **Material 3** интерфейс (Jetpack Compose).
- **Полноценный UI:** Настройка порта, пула датацентров и режима CloudFlare делается в 2 клика.
- **Интеграция с Telegram:** Кнопка «Применить в телеграмм» автоматически настроит прокси через систему глубоких ссылок (`tg://proxy`) для любого установленного клиента (AyuGram, Plus Messenger, NekoGram и др.).
- **Стабильная работа в фоне:** Приложение использует «неубиваемый» `Foreground Service` и самоконтроль Wakelock'ов, чтобы Android не "душил" прокси в спящем режиме.
- **Встроенный просмотрщик логов:** В реальном времени сгруппировано отображаются логи работы для удобной диагностики без падения FPS.
- **Динамические цвета и темы:** Поддержка светлой и темной тем, а также Material You (в Android 12+).
## 🆕 Что нового (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 секунд, см лог событий. В случае проблем подключения, попробуйте отключить CloudFlare и вернуться на ручные адреса DC, в противном случае - пожалуйста поднимите вопрос.**
## Что нового (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`), устраняющая проблемы с рукопожатием.
---
## Как это работает
@@ -51,15 +36,24 @@ Telegram Android → Локальный MTProto (по умолчанию 127.0.0
3. Извлекает DC ID из оригинального пакета и устанавливает защищенное WebSocket (TLS) соединение с нужным датацентром, при необходимости проксируя через сеть CloudFlare.
4. Эффективно мультиплексирует трафик.
## 🚀 Быстрый старт
## Быстрый старт
1. Перейдите на **[страницу релизов]** и скачайте актуальный `APK`-файл.
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` доступен под MIT). Файл лицензии приложен к исходному коду. Автор оригинальной программы - [Flowseal](https://github.com/Flowseal)
Этот форк распространяется под лицензией **GPLv3**. Оригинальный код `tg-ws-proxy` от [Flowseal](https://github.com/Flowseal) доступен под MIT.