TG Proxy

TG Proxy by Dushnyj
Android-приложение с локальным MTProto-прокси для Telegram

TG Proxy запускает на телефоне локальный MTProto-прокси, обычно 127.0.0.1:1443. Telegram подключается к локальному адресу, а приложение выбирает рабочий upstream-маршрут для конкретной сети.

Навигация

• Как это работает
• Возможности
• Установка APK
• Маршруты
• VPS Relay
• Диагностика
• Документация
• Сборка
• Безопасность

Как это работает

Telegram Android
  -> MTProto Proxy (127.0.0.1:1443)
  -> TG Proxy route engine
  -> selected upstream:
     Direct WS:        WebSocket/TLS -> Telegram DC
     Cloudflare CDN:   WebSocket/TLS -> Cloudflare -> Telegram DC
     Cloudflare Worker: WebSocket/TLS -> Worker -> TCP Telegram DC:443
     VPS Relay:        WebSocket/TLS -> tgproxy-relay -> TCP Telegram DC:443

WebSocket здесь не отдельная настройка, а транспорт между Android-приложением и выбранным upstream. Direct WS идет напрямую к Telegram WebSocket endpoint, Cloudflare CDN проходит через проксируемые kws<dc> записи, Worker и VPS Relay принимают WebSocket от приложения и сами открывают TCP-соединение к Telegram DC.

Возможности

• локальный MTProto-прокси для Telegram на Android;
• автоссылка tg://proxy для добавления прокси в Telegram;
• автоматический пинг активного маршрута без наложения проверок;
• аптайм, трафик и состояние в приложении и foreground-уведомлении;
• сетевые профили для Wi-Fi, операторов, dual SIM и eSIM;
• ручной VPS Relay, импорт/экспорт, QR и автонастройка VPS;
• Cloudflare Worker и пользовательские Cloudflare-домены;
• диагностика с TXT/ZIP-отчетом, копированием и сбросом результата;
• обновления Android-приложения через GitHub Releases.

Установка APK

1. Откройте Releases.
2. Скачайте TG-Proxy-v<version>-android-universal-release.apk.
3. Установите APK на телефон.
4. Откройте TG Proxy и нажмите запуск.
5. В блоке информации нажмите ссылку Telegram или добавьте прокси вручную:

Тип: MTProto
Сервер: 127.0.0.1
Порт: 1443
Secret: значение из приложения

Если Android агрессивно закрывает фоновые сервисы, отключите оптимизацию батареи для TG Proxy.

Маршруты

• Direct WS - быстрый прямой WebSocket/TLS к Telegram DC, если сеть его пропускает.
• VPS Relay - личный контролируемый fallback через ваш VPS.
• Cloudflare Worker - пользовательский Worker endpoint, который прокидывает WebSocket в TCP до Telegram DC.
• Cloudflare CDN - собственный Cloudflare-домен с kws<dc> DNS-записями.
• Public Cloudflare - встроенный публичный fallback-пул, если он доступен.

Практический порядок настройки:

1. Сначала проверьте автоматический маршрут.
2. Если сеть режет Telegram, настройте Cloudflare Worker или свой Cloudflare-домен.
3. Если нужен личный стабильный маршрут, настройте VPS Relay.
4. Если медиа грузится хуже чатов, проверьте DC mapping.

VPS Relay

Серверная часть живет отдельно: Dushnyj/TG-Proxy-Relay. Android-приложение умеет сохранить Relay, импортировать/экспортировать подключение, поделиться QR и выполнить автонастройку VPS по SSH.

Автонастройка Android скачивает release asset из TG-Proxy-Relay, а не из Android-репозитория. Текущая совместимая версия Relay для TG Proxy 1.0.5: TG Proxy VPS Relay 1.0.2.

Диагностика

Диагностика показывает сеть, активный профиль, текущий маршрут, настройки, последние ошибки, логи приложения и route matrix. Отчет можно сохранить в TXT/ZIP, скопировать текст или сбросить результат и собрать заново.

Документация

• VPS Relay в приложении
• Cloudflare Worker
• Cloudflare-домен
• Диагностика
• Маршрутизация
• Надежность Android-сервиса
• Архитектура

Сборка

./gradlew testDebugUnitTest assembleDebug --no-daemon

Release APK собирается GitHub Actions при публикации тега v*:

TG-Proxy-v<version>-android-arm64-v8a-release.apk
TG-Proxy-v<version>-android-armeabi-v7a-release.apk
TG-Proxy-v<version>-android-universal-release.apk
TG-Proxy-v<version>-android-x86_64-release.apk
SHA256SUMS.txt

Безопасность

Диагностические отчеты не должны содержать SSH-пароль, приватные ключи, raw Relay token или полный MTProto secret. Правила сообщения об уязвимостях описаны в SECURITY.md.

Лицензия

MIT. См. LICENSE.