01 / интеграция
Прокси за штатным Telegram proxy API
Telegram-WSP запускает tgwsproxy-core локально и настраивает 127.0.0.1:1443 через обычный proxy API Telegram. Самому Telegram не нужно знать, как реализован внешний WebSocket transport.
← Все проекты
MVP · v12.10.1-wsp.1
MVP · v12.10.1-wsp.1
> android / форк telegram / прокси
Telegram-WSP
Telegram для Android со встроенным непосредственно в клиент TgWsProxy.
Проект сохраняет Telegram максимально близким к upstream: TgWsProxy работает за локальным прокси, tgnet не изменяется, а интеграция применяется как небольшой воспроизводимый overlay.
01 Telegram Android upstream
02 минимальный overlay Telegram-WSP
03 локальный MTProto proxy · 127.0.0.1:1443
04 tgwsproxy-core · WebSocket / Cloudflare routes
СтадияMVP
Telegram upstream12.10.1 · build 7038
Пакетorg.telegram.messenger.web
Релизv12.10.1-wsp.1
> подход
Минимальные изменения оригинального Telegram
Интеграция намеренно не заменяет сетевую подсистему Telegram. Текущий source-level overlay затрагивает только пять upstream-файлов и не изменяет TMessagesProj/jni/tgnet/.
02 / брендинг
НЕОФИЦИАЛЬНЫЙ ФОРКСобственные название, иконка, package и ключ подписи.
Опубликованные требования Telegram просят сторонние приложения не использовать стандартный логотип Telegram и не выдавать себя за официальный клиент. Поэтому Telegram-WSP использует собственный брендинг и явно обозначен как неофициальный.
Требования Telegram ↗> реализовано
Основные возможности
Текущий MVP сосредоточен на встроенном proxy path, воспроизводимом переносе новых версий Telegram, целостности релизов и низкой стоимости поддержки форка.
Встроенный TgWsProxy
Для обычного сценария Telegram-WSP отдельное приложение прокси не требуется.
Локальный MTProto listener
Runtime слушает 127.0.0.1:1443 и подключается через существующий proxy API Telegram.
Небольшой upstream diff
Overlay намеренно ограничен, чтобы уменьшить число конфликтов при выходе новых версий Telegram Android.
Автоматизированные подписанные релизы
GitHub Actions собирает полный APK, подписывает постоянным ключом проекта и публикует metadata и Corresponding Source.
Проверяемые обновления приложения
Клиент проверяет GitHub Releases и валидирует SHA-256, package ID и сертификат подписи перед передачей APK Android.
Синхронизация Telegram upstream
Плановый workflow ежедневно проверяет DrKLO/Telegram и выпускает новую WSP-сборку только после успешных overlay и CI gates.
$ архитектура
Граница интеграции
Telegram остаётся приложением и сетевым слоем. Собственный transport изолирован за локальным proxy endpoint.
01 / клиентTelegram-WSPTelegram Android + небольшой overlay
→
02 / localhost127.0.0.1:1443граница Telegram proxy API
→
03 / transporttgwsproxy-corecf_proxy_ws · direct_ws · cf_worker_ws · tcp_fallback
> автоматизация
Обновления Telegram автоматически превращаются в WSP-релизы
Pipeline разделяет обнаружение новой upstream-версии и пользовательский релиз: несовместимая версия Telegram не становится Telegram-WSP-релизом только потому, что появилась upstream.
UPSTREAM → WSP
Ежедневная проверка совместимости
DrKLO/Telegramежедневная проверка
config/upstream.jsonpinned commit
Воспроизведение overlayчистый upstream
CI gatesобязательны
GitHub Releaseтолько после успеха
WSP → УСТРОЙСТВО
ПРОВЕРЯЕМОЕ ОБНОВЛЕНИЕУстановленное приложение следует за релизами Telegram-WSP.
Updater читает latest.json, проверяет более высокий versionCode, скачивает APK и валидирует digest, package ID и сертификат подписи. Финальное подтверждение установки остаётся за пользователем и Android.
> происхождение
Происхождение proxy runtime
Встроенное ядро выделено из поддерживаемого Android-форка, который происходит от Android-обёртки amurcanov и первоначального TgWsProxy runtime Flowseal.
источникFlowseal/tg-ws-proxyпервоначальный WebSocket runtime
→
android-веткаamurcanov → Regstar2форки tg-ws-proxy-android
→
встроенное ядроRegstar2/tgwsproxy-coreпереиспользуемый Android/native runtime
$ текущий_релиз
Telegram-WSP v12.10.1-wsp.1
Android 5.0+ · неофициальный форк · сборка и распространение через GitHub Releases.