Skip to content

About

Telegram-прокси для Android: локальный MTProto-прокси на телефоне, трафик к серверам Telegram идёт через WebSocket поверх TLS. Кнопка в шторке, проверка связи, обновления внутри приложения

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

TG WS Proxy для Android

By Harrisan

Локальный MTProto-прокси для Telegram на телефоне: Telegram подключается к 127.0.0.1, а приложение передаёт трафик к серверам Telegram через WebSocket поверх TLS. Помогает там, где прямое подключение заблокировано.

Discord Сайт Телеграм Автор

Скачать

Android

Версия Загрузок Все файлы

Поддержать и найти меня

Проект делается в свободное время. Если он вам пригодился:

Boosty
Boosty

разово или подпиской
DonationAlerts
DonationAlerts

разовый донат
без подписки
lvl.su
lvl.su

гайды и вики
Котамарин
Котамарин

канал про игры
и раздачи
ПароКот
ПароКот

приложение для Android:
релизы и цены на игры
Discord
Discord

вопросы и ошибки
AveHarrisan
AveHarrisan

телеграм
автора

Написано целиком на Kotlin, без нативных библиотек.

Возможности

  • Фоновая служба с уведомлением, работает при выключенном экране.
  • Кнопка «Подключить в Telegram» открывает ссылку tg://proxy и сразу добавляет прокси в Telegram.
  • Кнопка в шторке для быстрого включения и выключения. На Android 13 и новее добавляется одним нажатием прямо из приложения.
  • Обновления внутри приложения: плашка о новой версии со списком изменений, скачивание и установка поверх без браузера.
  • Автозапуск после перезагрузки (включается в настройках).
  • Проверка связи: какие способы подключения к Telegram работают в текущей сети.
  • Журнал работы с копированием и отправкой.
  • Настройки: порт, секрет, IP дата-центров, размер пула соединений, запасной путь через Cloudflare, свои домены и Workers, Fake TLS, доступ из локальной сети, запрет засыпания.
  • Светлая и тёмная тема.

Требуется Android 7.0 или новее.

Скриншоты

Новая версия — прямо в приложении
Новая версия — прямо в приложении
Обновлено, прокси работает
Обновлено, прокси работает
Журнал
Журнал
Настройки
Настройки
Cloudflare и дополнительно
Cloudflare и дополнительно
Поведение
Поведение
О программе
О программе
Проекты и справка
Проекты и справка
Экспериментальный режим
Экспериментальный режим
Уведомление о новой версии
Уведомление о новой версии

Установка

  1. Скачайте APK последней версии и установите его.
  2. Откройте приложение и нажмите «Запустить прокси».
  3. Нажмите «Подключить в Telegram» и подтвердите добавление прокси в Telegram.

Если Android завершает приложение в фоне, разрешите ему уведомления и отключите для него экономию батареи.

Подходит любой клиент: Telegram, Telegram X, Nekogram, AyuGram и другие.

Новые версии приложение находит само и предлагает обновиться. При первом обновлении Android попросит разрешить установку из этого источника. Что менялось по версиям — в CHANGELOG.md.

Свой домен для CF-прокси

Если Telegram подвисает, а в «Проверке связи» работает только CF-прокси, подключите свой домен: общими доменами пользуются все сразу, а свой — только ваш. Нужен любой домен (около 150 ₽ в год), Cloudflare бесплатный.

Пошагово — docs/CfProxy.md. Та же инструкция есть в приложении: «О программе» → «Справка» → «Свой домен CF-прокси» (там же кнопка, копирующая DNS-записи) — или значок «?» в поле «Свои домены CF-прокси». Кнопка «Проверить домен» под полем покажет, все ли записи настроены.

Свой Cloudflare Worker

Если Telegram подвисает, а в «Проверке связи» работает только CF-прокси, заведите свой бесплатный Worker на Cloudflare: общие домены делят все пользователи, а Worker — только ваш. Домен покупать не нужно.

Пошагово и с кодом — docs/CfWorker.md.

Warning

Проверено 28.09.2026: у части провайдеров соединения с адресами workers.dev обрываются после первых ~15 КБ — маленькие ответы проходят, крупные (например, при открытии канала) нет, хотя проверка зелёная. Worker пробуется первым, поэтому если после его добавления каналы не грузятся — очистите поле «Домены Cloudflare Worker» и используйте свой домен для CF-прокси.

Сборка

Нужны JDK 17 и Android SDK (platform 35).

./gradlew :core:test          # тесты ядра
./gradlew :app:assembleDebug  # app/build/outputs/apk/debug/app-debug.apk

Ядро можно запустить на компьютере без Android:

./gradlew :core:run --args="--port 1443 --secret <32 hex-символа>"
./gradlew :core:run --args="--probe"   # проверка связи

Для подписанной release-сборки положите в keystore/ файл хранилища и keystore.properties с полями storeFile, storePassword, keyAlias, keyPassword.

Другие проекты

  • KotaMusic — мод Яндекс Музыки для компьютера
  • USB-of_on — USB-устройства Windows: имена, скрытие, заряд
  • ПароКот — приложение для Android: релизы игр и слежение за ценами

Поддержать

Ссылки — в начале страницы: Boosty для разовой или регулярной поддержки и DonationAlerts для разового доната. Кнопка «Sponsor» в правой колонке репозитория ведёт туда же.

Лицензия

Все права защищены, см. LICENSE. Код открыт для просмотра, но копировать, изменять и распространять его без разрешения автора нельзя.

Note

Приложение создано в образовательных целях. Автор не несёт ответственности за действия пользователей и не призывает использовать данное приложение.

About

Telegram-прокси для Android: локальный MTProto-прокси на телефоне, трафик к серверам Telegram идёт через WebSocket поверх TLS. Кнопка в шторке, проверка связи, обновления внутри приложения

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages