https://github.com/perfite/perfite-tg-proxy-android
https://github.com/perfite/perfite-tg-proxy-android
android-app telegram tg-ws-proxy
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/perfite/perfite-tg-proxy-android
- Owner: Perfite
- License: mit
- Created: 2026-06-01T17:11:40.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-06-01T20:30:40.000Z (about 1 month ago)
- Last Synced: 2026-06-01T21:11:01.091Z (about 1 month ago)
- Topics: android-app, telegram, tg-ws-proxy
- Language: Kotlin
- Size: 74.2 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Perfite TG Proxy
Небольшой Android-компаньон для официального приложения Telegram.
Поднимает локальный MTProto-прокси на телефоне и перенаправляет трафик
Telegram через WebSocket-маршруты.
Приложение не заменяет Telegram, не требует отдельного аккаунта и не
расшифровывает переписку.
## Что нового в 0.3.3
- Исправлено переподключение Telegram после генерации нового MTProto secret.
- Кнопка **Подключить Telegram** теперь сохраняет новый secret и перезапускает локальный прокси перед открытием Telegram.
- Обновлено описание проекта и подготовлен новый GitHub-релиз.
## Скачать APK
**[Скачать последнюю версию Perfite TG Proxy](https://github.com/Perfite/Perfite-TG-Proxy-Android/releases/latest/download/Perfite-TG-Proxy.apk)**
## Скриншоты
| Светлая тема | Тёмная тема |
| --- | --- |
| 
| 
|
## Поддержать проект
Perfite TG Proxy остаётся бесплатным. Добровольная поддержка помогает
развивать приложение и выпускать обновления:
**[Поддержать разработку через CloudTips](https://pay.cloudtips.ru/p/05c0f7da)**
## Возможности
- Подключение официального Telegram одной кнопкой.
- Работа в фоне через foreground service.
- Выбор локального порта, по умолчанию `1443`.
- Запуск после перезагрузки телефона.
- Запуск при открытии приложения.
- Резервное TCP-соединение.
- Необязательный личный Cloudflare Worker.
- Светлая, тёмная и системная темы.
- Локальный MTProto secret с ручной регенерацией.
## Требования
- Android 8.0 или новее.
- JDK 17.
- Android SDK 36.
## Сборка
На Windows:
```powershell
$env:JAVA_HOME = "C:\Program Files\Android\Android Studio\jbr"
.\gradlew.bat assembleDebug
```
На Linux или macOS:
```bash
./gradlew assembleDebug
```
Готовый APK появится в:
```text
app/build/outputs/apk/debug/app-debug.apk
```
## Установка
1. Установите APK на телефон.
2. Разрешите приложению показывать уведомления.
3. Нажмите **Запустить прокси**.
4. Нажмите **Подключить Telegram**.
5. Подтвердите подключение прокси в Telegram.
Постоянное уведомление необходимо Android для фоновой работы.
## Как это работает
```text
Telegram на телефоне -> 127.0.0.1:1443 -> Perfite TG Proxy -> WebSocket -> дата-центры Telegram
```
Приложение пробует маршруты в следующем порядке:
1. Прямой WebSocket-маршрут Telegram.
2. Личный Cloudflare Worker, если он указан.
3. Общие CfProxy-домены.
4. Прямое TCP-соединение, если включён резервный режим.
## Cloudflare Worker
Личный Worker необязателен, но может повысить стабильность соединения.
Инструкция находится в [docs/CfWorker.md](docs/CfWorker.md).
## MTProto secret
Один постоянный secret является нормальным режимом работы. Он генерируется
на телефоне и хранится локально. После ручной регенерации можно сразу
нажать **Подключить Telegram**: приложение сохранит новый secret и
перезапустит локальный прокси автоматически.
## Лицензия
Проект распространяется по лицензии [MIT](LICENSE).