v1.10.13

TgWsProxy Android v1.10.13

versionName 1.10.13 · versionCode 51 · ABI arm64-v8a

Главное

• Стабилизирован MTProto WebSocket receive path: continuation/fragmented frames теперь собираются корректно, а размер отдельных и накопленных сообщений ограничен 16 MiB.
• Worker failover и session-pool поведение усилены тестами; miss больше не запускает дублирующий background refill при уже выполняющемся foreground dial.
• Синхронизированы релевантные изменения Flowseal с сохранением Android-специфичной маршрутизации, Fake TLS, watchdog и диагностики.
• Добавлен отдельный экран Обратная связь с GitHub Issue Forms без встроенного GitHub PAT.
• Добавлен отдельный экран Обновления: асинхронная проверка официальных GitHub Releases, SemVer stable/prerelease policy, release notes и переход только на официальный release URL.
• Экран обновлений не скачивает и не устанавливает APK автоматически и не запрашивает дополнительные install/background permissions.
• Публичная CI переведена на GitHub-hosted Windows; persistent self-hosted runner оставлен только для owner-controlled release/signing path.
• Добавлены Project Sync, release automation, release signing verification и SHA-256 artifact generation.
• Публичная структура и документация приведены к актуальным правилам проекта; private governance/AI/tool state исключены из Git.

Update delivery

В Настройки → Обновления отображается установленная версия и выполняется безопасная проверка Regstar2/tg-ws-proxy-android Releases.

При наличии более новой подходящей версии приложение показывает краткое описание релиза и предлагает открыть официальную страницу GitHub Release. Сетевые, timeout, API и malformed-metadata ошибки остаются локальным состоянием экрана и не должны останавливать или перенастраивать proxy runtime.

Feedback

В Настройки → Обратная связь доступны отдельные действия Сообщить об ошибке и Предложить функцию. Приложение автоматически не прикладывает runtime logs, proxy credentials, Telegram data, IP-адреса или secrets. Копирование app/device context выполняется только по явному действию пользователя.

Runtime

Основной сценарий остаётся MTProto Proxy → Cloudflare Proxy через локальный endpoint 127.0.0.1:1443.

Worker Pool остаётся необязательным и более медленным development/diagnostics path. direct_ws и tcp_fallback сохраняются как разрешаемые политикой альтернативы.

Безопасность релиза

• Release signing material не хранится в Git.
• scripts/release.ps1 -Version v1.10.13 требует локально настроенные signing variables/keystore, проверяет подпись APK и формирует APK + SHA-256 в dist/.
• GitHub Release должен публиковаться только после финального manual acceptance Issue #7.

Перед публикацией

Обязательная ручная проверка финальной сборки:

• MTProto proxy start/stop/reconnect;
• Telegram messages и media;
• Wi-Fi и mobile data;
• Wi-Fi ↔ mobile reconfigure;
• Feedback и Updates;
• RU/EN;
• diagnostic export на отсутствие чувствительных данных;
• signed release artifact и SHA-256.

v1.10.12

Release notes v1.10.12

Крупный Android-релиз после длинной локальной ветки. Основной сценарий теперь -
MTProto Proxy на 127.0.0.1:1443 с маршрутом через Cloudflare Proxy.

versionName 1.10.12 · versionCode 50

Главное

• MTProto Proxy стал frontend по умолчанию. SOCKS5/WebSocket оставлен как режим
  совместимости на том же локальном порту.
• MTProto -> cf_proxy_ws проверен вручную на мобильной сети и Wi-Fi.
• Добавлен Fake TLS secret: dd<secret> без masking domain и
  ee<secret><domain_hex> при указанном домене.
• Добавлен optional passthrough для probe-соединений на masking domain.
• Дефолты маршрутов изменены под телефон: на мобильной сети только
  cf_proxy_ws, на Wi-Fi сначала cf_proxy_ws, затем direct/TCP fallback.

Из Flowseal

• cooldown для Telegram IP в direct WebSocket;
• возрастная ротация WS pool;
• listener watchdog для локального listener;
• test DC support (dc >= 10000, /apiws_test, force_test_dc);
• quality gate для обновления CF-domain pool.

Android/UI

• Главный экран стал короче: без кнопки Worker Pool, без раскрытия подробностей
  и без строки Worker Pool в состоянии.
• MTProto больше не помечается как experimental.
• Уведомление и диагностика показывают frontend и фактический route backend.
• Runtime-сбор логов и persistent file logs выключены по умолчанию.
• README и скриншоты обновлены под текущий интерфейс.

Known issue

Worker Pool пока медленный. Код, UI и диагностика оставлены, но основной маршрут
для обычного использования - Cloudflare Proxy.

Проверено

• .\gradlew.bat testDebugUnitTest
• .\gradlew.bat assembleDebug
• cd native\tgwsproxy && go test ./...
• APK установлен на телефон; MTProto через CF Proxy проверен на мобильной сети и
  Wi-Fi.

TGWSProxyAndroid v1.8.0

TGWSProxyAndroid v1.8.0

Кратко

Релиз обслуживания и приведения репозитория в порядок после крупной работы по маршрутизации в ветках 1.6–1.7.

В этом выпуске зафиксированы структура репозитория, документация, release notes, скриншоты, пути сборки и чеклисты тестирования/релиза. Намеренных изменений runtime и маршрутизации по сравнению с уже внедрёнными исправлениями 1.7.9.x нет.

С v1.6.0 (уже в этой сборке)

• Отдельные политики маршрутов для Wi‑Fi и мобильной сети.
• Переключатели маршрутов: Direct WebSocket, Cloudflare Worker, Cloudflare Proxy, TCP fallback.
• Предпочитаемый маршрут и fallback для каждого типа сети.
• Автоматический reconfigure при переключении Wi‑Fi ↔ Mobile.
• Диагностика эффективной политики маршрутов.
• Отчёты проверки (route probe) по маршрутам.
• Метрики пулов Worker / CF.
• Постоянные runtime-логи и более безопасный экспорт.
• Исправлена обработка токенов политики маршрутов в нативном runtime.
• Исправлено отображение маршрута: route kind отделён от типа транспорта.
• Устаревшие события Direct/Worker больше не перезаписывают текущий маршрут в UI.
• Убран pclead.co.uk как домен Cloudflare proxy по умолчанию (укажите свой домен или используйте встроенный/кэшированный пул).

Что изменилось в v1.8.0

• Go runtime перенесён в native/tgwsproxy/.
• Документация разложена по каталогам:
  • docs/architecture/
  • docs/development/
  • docs/testing/
  • docs/releases/
  • docs/assets/screenshots/
• Обновлён README: структура, скриншоты, терминология маршрутов, команды сборки.
• Добавлены/обновлены release checklist и ручной чеклист тестирования.
• Усилен .gitignore (артефакты, runtime-логи, секреты, keystores).
• Подтверждены versionName 1.8.0, versionCode 36.

Поведение runtime

Для тега v1.8.0 намеренных изменений маршрутизации и runtime не вносилось.

В сборку входят важные исправления конца линейки 1.7.x:

• отключённые маршруты в политике не должны выбираться;
• routeKind отделён от транспорта WebSocket;
• устаревшие события маршрута не должны перекрывать активный маршрут для текущего поколения политики.

Как обновиться

Установите поверх предыдущей сборки.
Если Android отказывает из‑за несовпадения подписи — удалите старый APK и установите заново.

APK

К релизу прикреплён tgwsproxy-release.apk (подписанный release).
Локальная сборка: скопируйте release-signing.env.example → release-signing.env (в git не попадает), затем .\scripts\build-apk.ps1 -Configuration Release.

Проверка перед публикацией

• Go-тесты tgwsroute: пройдены (native/tgwsproxy).
• Android assembleDebug и lint: пройдены.
• Android testDebugUnitTest: на этом Windows-хосте не прошли (Gradle test worker, ClassNotFoundException — проблема среды, не падение тестов приложения). При необходимости перезапустите на Linux/CI или в Android Studio.
• Подписанный release APK собран с локальным tgwsproxy-release.jks через release-signing.env.

Известные ограничения

• Приложение не является VPN.
• Проксируется только трафик Telegram, настроенный на SOCKS5.
• Маршрут Worker требует настроенный Cloudflare Worker.
• Общие или ограниченные по rate limit домены Cloudflare proxy могут не работать в зависимости от сети.

TgWsProxy Android v1.6.0

TgWsProxy Android v1.6.0

v1.6.0 - первый релиз текущей Android-ветки, который собирает вместе не только новые маршруты, но и доводку приложения до более пригодного для ежедневного использования состояния.

Главное

• Cloudflare Worker как отдельный маршрут.
• Режимы подключения: Auto, Direct + fallback routes, Worker first, CF first, Worker only, CF only, Direct only.
• CF-domain pool с ручными, кэшированными upstream и встроенными доменами.
• Более устойчивое обновление CF-доменов: mirror URL, staged diagnostics, cache safety, retry/backoff.
• Adaptive Auto routing с историей маршрутов по сети, last-good route, cooldown и пресетами стратегии.
• Расширенная диагностика с объяснением выбора маршрута и markdown-отчетом для GitHub Issues.
• Действия из foreground notification, метрики скорости/задержки, onboarding, Help/About и релизная полировка интерфейса.

Маршрутизация и CF-домены

Cloudflare Worker теперь можно использовать как fallback, как приоритетный маршрут или как строгий режим Worker only. Режимы Worker only и CF only намеренно не допускают direct TCP passthrough для Telegram-like трафика.

Порядок выбора CF-доменов:

1. Ручной домен
2. Кэшированный upstream list
3. Встроенный list

Если ручной домен получает 429, 403, 5xx, timeout, TLS или WebSocket failure, он временно уходит в cooldown, а приложение пробует следующий доступный домен или маршрут, если это разрешает выбранный режим.

Обновление CF-доменов теперь best-effort, а не runtime-зависимость. При ошибке, пустом или битом ответе приложение сохраняет прежний cache и при необходимости откатывается к встроенному списку.

Adaptive Auto routing

Auto учитывает профиль сети, недавнее здоровье маршрутов, cooldown, last-good route, latency и накопленную статистику, чтобы выбирать более вероятный рабочий путь.

Доступны пресеты:

• Balanced
• Prefer Direct
• Prefer Worker
• Prefer CF proxy
• Fast failover

Ручные режимы остаются детерминированными и не переопределяются стратегией Auto.

Диагностика

В приложении есть точечные проверки Direct, Worker, CF proxy, TCP fallback, CF domains и всего набора маршрутов. Диагностика показывает выбранный маршрут, этап, latency, cooldown, состояние доменов и сводку adaptive routing.

Экспорт может включать markdown-отчет, пригодный для GitHub Issues; домены при необходимости маскируются.

UI и foreground notification

В v1.6.0 добавлены:

• onboarding при первом запуске;
• более аккуратная группировка настроек;
• обновленные Help/About со ссылками на репозиторий;
• runtime logs, скрытые по умолчанию за отдельным диалогом;
• действия Start, Stop, Reconnect, Open из уведомления;
• опциональные метрики скорости, задержки, маршрута и соединений в приложении и уведомлении;
• режимы уведомления Normal, Compact, Minimal.

Android требует видимое уведомление для foreground service. TgWsProxy может сделать его компактным или минимальным, но не может полностью убрать его во время работы прокси.

Что не вошло

• Fake TLS не реализован.
• External proxy mode не реализован.
• Quick Settings Tile не входит в v1.6.0.

Известные ограничения

• Для надежной работы через Worker нужен собственный Cloudflare Worker.
• Общие CF-домены могут возвращать 429 Too Many Requests.
• Direct route все еще может быть нестабилен на части мобильных сетей.
• Adaptive Auto становится полезнее после того, как накопит немного истории подключений.

Рекомендуемые настройки

• Для большинства пользователей: Auto + Balanced.
• Если Direct часто ломается: Worker first.
• Если есть свой Worker и нужен строгий режим: Worker only.
• Если есть надежный CF domain: CF first.
• Для тестов маршрута: Direct only.

Что еще вошло в релиз

В релиз также попала миграция launcher/notification assets на versioned v2 ресурсы и очистка старой иконографики, чтобы презентация приложения и уведомлений выглядела стабильнее на актуальных Android-сборках.

v1.2.5-ui

Тестовый релиз TgWsProxy Android v1.2.5-ui.

Что нового:

• упрощён главный экран;
• настройки вынесены на отдельный экран;
• добавлена поддержка системной, светлой и тёмной темы;
• добавлен выбор языка интерфейса;
• улучшен сценарий работы через Cloudflare Proxy;
• добавлены runtime-логи и экспорт логов для диагностики.

Что важно:

• текущий основной рабочий сценарий на мобильных сетях: CF first или CF only;
• домен Cloudflare по умолчанию общий и может работать нестабильно;
• возможны ошибки вида 429 Too Many Requests;

Если будут проблемы, приложите:

• тип сети: Wi-Fi или мобильная;
• краткое описание проблемы;
• по возможности runtime-лог.