Skip to content

nexWay2040/tg-ws-proxy-android

Repository files navigation

TG Proxy 🚀

TG Proxy — это Android-приложение, которое создает локальный SOCKS5 прокси-сервер прямо на вашем устройстве. Оно позволяет обходить сетевые ограничения для мессенджера Telegram без необходимости использовать общесистемный VPN.

💡 Особенности

  • ⚠️ Работает только по Wi-Fi: На данный момент мобильные операторы (4G/LTE) используют жесткий DPI, который блокирует прямое подключение. Используйте приложение при подключении к домашнему или публичному Wi-Fi.
  • Локальный роутинг: Проксируется только трафик Telegram. Ваши банковские приложения, игры и браузер работают напрямую с родным пингом.
  • Фоновая работа (Foreground Service): Интегрирован нативный Android-сервис на Kotlin с несмахиваемым уведомлением. Приложение не убивается агрессивными системами энергосбережения (MIUI, ColorOS, HiOS, OneUI).
  • Встроенный Node.js: Под капотом работает полноценный движок Node.js (nodejs-mobile-react-native), который обрабатывает TCP-соединения.
  • Real-time статистика: Отображение активных соединений и переданного трафика в реальном времени.

🛠 Стек технологий

  • Frontend: React Native (TypeScript/JavaScript)
  • Backend (Local): Node.js
  • Native Android: Kotlin, Java, Gradle

📦 Установка (Для обычных пользователей)

Вам не нужно ничего программировать. Просто скачайте готовый файл:

  1. Перейдите в раздел Releases справа.
  2. Скачайте последний .apk файл.
  3. Установите на свой Android-смартфон, нажмите «Запустить» и затем «Открыть Telegram и подключить».

💻 Сборка из исходников (Для разработчиков)

Если вы хотите изучить код или собрать приложение самостоятельно, следуйте этой инструкции. Вам потребуется установленный Node.js, React Native CLI и Android Studio (или Android SDK).

1. Подготовка

Склонируйте репозиторий и установите JS-зависимости:

git clone https://github.com/nexWay2040/tg-proxy.git
cd tg-proxy
npm install

2. Запуск для разработки (Debug)
Чтобы запустить приложение на подключенном устройстве или эмуляторе с поддержкой горячей перезагрузки (Hot Reload):
npx react-native run-android

3. Сборка готового APK (Release)
Чтобы скомпилировать оптимизированный установочный .apk файл:
Для Windows:
cd android
gradlew assembleRelease

Для macOS / Linux:
cd android
./gradlew assembleRelease

4.Готовый файл появится по пути: android/app/build/outputs/apk/release/app-release.apk

🙏 Благодарности (Credits) За основу логики проксирования (Node.js) был взят отличный проект для ПК — tg-ws-proxy. Огромная благодарность автору @Flowseal за крутой концепт и открытый исходный код!

About

⚠️ Дисклеймер Проект создан исключительно в образовательных целях для изучения сетевых протоколов, межпроцессного взаимодействия (React Native Bridge) и работы фоновых служб Android. Автор не несет ответственности за использование данного ПО.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors