Локальный MTProto для Telegram (Android)

Локальный MTProto для работы с Telegram на Android. Приложение поднимает на телефоне локальный прокси и соединяет Telegram (в т.ч. официальный клиент для Android), Telegram Desktop или другие клиенты с поддержкой MTProto proxy с серверами Telegram через WebSocket. Трафик идёт к Telegram так же, как задумано протоколом.

Кому это нужно

• Нужен MTProto proxy с dd… secret и ссылкой tg://proxy.
• Удобно, когда клиент на том же устройстве ходит на 127.0.0.1:порт, а также с Desktop, эмулятором и для отладки.

Как установить

1. Откройте Releases этого репозитория (или ваш форк — вкладка Releases).
2. Скачайте APK с последнего релиза.
3. На Android разрешите установку из неизвестных источников для браузера/файлового менеджера, если система спросит.
4. Установите приложение и откройте его.

Сборка не из Google Play — только GitHub (или свой APK, если собираете сами).

Как пользоваться

1. При первом запуске приложение создаёт secret (32 символа hex). При желании задайте порт и адрес (обычно 127.0.0.1).
2. Строки DC → IP — соответствие номера дата-центра и IP (формат 2:149.154.x.x по одной паре на строку). Для типовых настроек можно оставить подсказку в поле.
3. Нажмите Сохранить, затем Запуск — появится уведомление: прокси работает, пока сервис запущен.
4. Ссылка tg://proxy на экране — нажмите её или «Копировать и открыть»; откроется приложение, зарегистрированное на схему tg: (часто Telegram). При необходимости прокси можно ввести вручную: Настройки → Данные и память → Прокси (MTProto, адрес 127.0.0.1, порт и secret из приложения).

На Android 13+ может понадобиться разрешение на уведомления — без него фоновый режим ограничен.

Важно знать

Telegram для Android умеет работать через MTProto proxy на 127.0.0.1 с тем же secret — для многих пользователей этого достаточно. Ссылка tg://proxy на разных версиях и прошивках может открываться по-разному (сразу добавить прокси или предложить выбор приложения); если ссылка не сработала, используйте ручной ввод в настройках прокси Telegram — это тот же тип прокси, что отдаёт это приложение.

Где взять обновления

Новые версии выходят в Releases; при появлении тега вида v1.x.x к релизу может прикладываться готовый APK из автоматической сборки.

---

Дополнительно (для разработчиков)

Исходники: каталог android/ (приложение + модуль core с логикой протокола). Сборка локально: JDK 17+, Android SDK, из папки android команда ./gradlew :app:assembleDebug. Эталонная реализация на Python: reference/python/proxy/. CI: .github/workflows/android.yml.

Лицензия

См. LICENSE.