joycecurcirt539-dot/Mirrly-TG-Proxy

Mirrly TG Proxy для Android

Локальный шлюз маршрутизации для Telegram на нативном движке Rust (mirrlyengine) с поддержкой MTProto, SOCKS5, мульти-аплинк туннелирования (Anycast CDN Flowseal, Cloudflare Worker WSS) без системного VPN

🇷🇺 Русский  |  🇬🇧 English  |  🇮🇷 فارسی

Маршрутизация трафика Telegram через нативное ядро mirrlyengine (Rust/Tokio). Поддерживает протоколы MTProto и SOCKS5, дискретный конечный автомат стабильности сети FSM, потоковый контроль буферов 4 МБ и безопасную экспресс-диагностику. Работает локально на устройстве без root-прав и без создания системного VPN-соединения.

---

1. Что такое Mirrly TG Proxy
2. Технический принцип работы
3. Режимы восходящего канала (Uplink Modes)
4. Ключевые возможности и архитектурные модули
5. Архитектура системы
6. Поддерживаемые клиенты Telegram
7. Интерфейс приложения
8. Быстрый старт и установка
9. Конфигурация и параметры
10. Создание и настройка Cloudflare Worker
11. Структура проекта и сборка из исходного кода
12. График активности разработки
13. Динамика звезд репозитория
14. Хронология развития
15. Безопасность и условия использования
16. Благодарности и Зал Славы

Mirrly TG Proxy — бесплатное Android-приложение с открытым исходным кодом, выполняющее роль локального шлюза проксирования трафика Telegram. Приложение решает проблему нестабильной связи, блокировок протоколов, замедления медиафайлов и фильтрации DPI со стороны интернет-провайдеров и мобильных операторов.

Приложение не использует системный интерфейс VpnService для проксирования Telegram и не перехватывает трафик сторонних программ устройства. Соединение Telegram направляется через локальный сетевой сокет (127.0.0.1:1443 для MTProto или 127.0.0.1:10808 для SOCKS5) на нативное ядро mirrlyengine (Rust/Tokio) и передаётся в дата-центры Telegram через Anycast CDN или Cloudflare Worker.

VPN-режим отключен и находится в активной разработке. VLESS, WARP, MASQUE, AWG, Proton и каскадные VPN-маршруты не работают в текущей версии приложения. Приложение предназначено исключительно для локального проксирования трафика Telegram через протоколы MTProto (127.0.0.1:1443) и SOCKS5 (127.0.0.1:10808) без создания системного VPN и без перехвата трафика других программ устройства.

• Два локальных протокола Telegram:
  • MTProto (порт 1443): FakeTLS маскировка ee / dd, пул постоянных соединений WsPool и прямое взаимодействие с Anycast CDN.
  • SOCKS5 (порт 10808): прозрачный TCP-релей с субнегоциацией логина и пароля (RFC 1928 / RFC 1929), поддержкой доменных имен, IPv4/IPv6, передачи голосовых и видеозвонков.
• Стабильный режим восходящего канала (Uplink):
  • WORKER: туннелирование через Cloudflare Worker по протоколу WebSocket TLS 1.3 на порт 443 с фильтрацией Anti-Open-Relay.
• Сетевой стек и стабильность:
  • DC-Affinity Engine: привязка сессий Telegram к дата-центрам DC1–DC5 для исключения повторных рукопожатий.
  • Политика доверия (Trust Policy): изоляция персональных VPS-конфигураций от утечки на публичные релеи (allowPublicRelayFallbackForPrivateVps).
  • Дискретный FSM: автомат состояний (NORMAL, DEGRADED, RECOVERING) с защитой от флэппинга (окно фиксации 5–10 сек, охлаждение 30–60 сек).
  • Network Generation Guard: изоляция сетевых поколений для исключения гонок сокетов при переключении Wi-Fi / LTE.
  • Bounded Flow Control: буфер записи 4 МБ в воркере и Rust-ядре с контрольными водяными знаками (устранение ошибки WebSocket 1009 при отправке тяжелых медиафайлов).
  • Smart Connect: экспресс-анализ сетевого стека за 2–3 секунды перед установлением соединения.
• Интерфейс и локализация:
  • Двухуровневые настройки: Простой режим (Simple) для быстрого старта и Продвинутый режим (Advanced) для тонкого тюнинга сокетов (TCP_NODELAY, буферы).
  • Полная трехъязычность: поддержка русского, английского и персидского языков (RU, EN, FA) с корректным направлением письма RTL, а также выбор языка приложения в Android 13+ (locales_config).
  • Экран первого запуска (Onboarding): стартовое руководство для новых пользователей.
  • Официальный Telegram-канал: экран взаимодействия с сообществом проекта (@WhyOkyHb).
  • Безопасный диагностический отчёт: генерация моноширинного отчёта с автоматическим маскированием паролей, ключей и персональных доменов (Zero Secret Leak).
  • Доменная классификация ошибок (Error Taxonomy): понятные тексты для пользователей и машиночитаемые коды для логов.
  • Проверка подлинности обновлений: нативная C++ NDK верификация цифровой подписи APK (SignatureVerifier) и парсинг контрольных сумм SHA-256 в UpdateChecker.

• Системный VPN и VPN-аплинки: VLESS, WARP, MASQUE, AWG и каскадные маршруты находятся в разработке и не готовы к использованию.
• Встроенный замер скорости (SpeedTest): модуль измерения пропускной способности соединения внутри приложения.

Приложение запускает на устройстве два независимых локальных шлюза на базе нативного движка mirrlyengine (Rust/Tokio):

1. Клиент Telegram подключается к локальному адресу 127.0.0.1:1443 по протоколу MTProto FakeTLS (с секретным ключом ee / dd).
2. Нативное ядро mirrlyengine выполняет разбор FakeTLS, извлекает целевой дата-центр Telegram (DC1–DC5) и тип трафика (сообщения или медиа).
3. Модуль пула соединений WsPool берёт готовое или открывает новое постоянное WebSocket-соединение с официальными шлюзами Telegram Web (kws1..kws5.web.telegram.org:443/apiws) через Anycast CDN.
4. Выбор пограничного сервера Cloudflare CDN осуществляется через DoH-резолвер (dns.rs), алгоритм Happy Eyeballs (RFC 8305) и балансировщик задержек (balancer.rs).
5. Расход квоты воркеров равен нулю: MTProto взаимодействует напрямую с Anycast CDN Telegram Web и не расходует суточные лимиты Cloudflare Workers.

1. Клиент Telegram подключается к локальному адресу 127.0.0.1:10808 по протоколу SOCKS5 с обязательной аутентификацией RFC 1929 (логин и пароль).
2. Обрабатываются команды:
   • CONNECT (0x01): проксирование TCP-потоков чатов, каналов, ботов и загрузки медиафайлов;
   • UDP ASSOCIATE (0x03): туннелирование UDP-дейтаграмм для голосовых и видеозвонков Telegram VoIP.
3. Диспетчер направляет поток через Cloudflare Worker по WebSocket TLS 1.3; VPN-аплинки находятся в разработке и в этот маршрут не входят.

Звонки поддерживаются только через SOCKS5. На каждом устройстве участников звонка должен быть настроен и активен прокси с TCP-соединением; в настройках Telegram обязательно включите опцию «Использовать прокси для звонков». Работа звонков зависит от сетей и ограничений операторов, поэтому не гарантирована для всех собеседников. MTProto-режим звонки не поддерживает.

В режиме SOCKS5 маршрутизатор RouteSupervisor ядра mirrlyengine поддерживает следующие транспорты (в режиме MTProto используется специализированный Anycast CDN пул WsPool):

• Дискретный конечный автомат (FSM):
  • NORMAL: задержки в норме, потери отсутствуют, активен стандартный режим сокетов;
  • DEGRADED: подтвержденная деградация радиоканала (рост RTT > 500 мс, джиттер > 60 мс или серия потерь);
  • RECOVERING: фаза плавной стабилизации после смены сетевого интерфейса.
• Окно гистерезиса (Hysteresis Window): переключение профилей происходит только при фиксации деградации в течение 5–10 секунд непрерывного наблюдения.
• Период охлаждения (Cool-down Period): после любого изменения параметров соединения накладывается блокировка повторных переключений на 30–60 секунд для исключения паразитного циклического резонанса.

Каждому сетевому состоянию присваивается уникальный номер поколения (network_generation). При смене сети (Wi-Fi ↔ LTE) сокеты и DNS-ответы предыдущего поколения инвалидируются, что предотвращает зависание соединений.

При включении служба выполняет быструю проверку готовности сетевого стека за 2–3 секунды:

1. Экспресс-валидация доступности DNS-резолверов (DoH и системный DNS);
2. Проверка пула адресов для активного режима подключения;
3. Выбор наименее загруженного узла с минимальным пингом;
4. Отображение статуса в интерфейсе («Оптимизация маршрута...»).

• Простой режим (Simple Mode — по умолчанию): лаконичный интерфейс без инженерной терминологии. Содержит только выбор режима прокси (MTProto / SOCKS5), выбор аплинка, таймер сна, расписание работы, автозапуск при загрузке устройства, выбор языка и темы.
• Продвинутый режим (Advanced Mode): активируется переключателем внизу экрана настроек и открывает настройки сокетов (TCP_NODELAY), буферов, WebSocket-пула и Happy Eyeballs.

• Формирование структурированного отчёта о состоянии устройства и сетевого стека в моноширинном формате на экране DiagnosticReportScreen.
• Строгая анонимизация: автоматическое маскирование паролей SOCKS5, токенов учетных записей, закрытых ключей WireGuard ([REDACTED]), персональных IP-адресов и приватных доменов воркеров (***.workers.dev).
• Экспорт в один клик: копирование в буфер обмена и отправка через системное меню ShareSheet для оформления GitHub Issues.

• Пользовательский уровень (UI и уведомления): понятный текст на выбранном языке («Превышен суточный лимит воркера», «Нет связи с DNS-сервером», «Мобильный интернет отключён»).
• Инженерный уровень (отчёт и логи): машиночитаемые коды:
  • WORKER_QUOTA_EXCEEDED — исчерпание суточного лимита бесплатного тарифа Cloudflare (HTTP 429, 1015, 1027);
  • DNS_RESOLUTION_UNAVAILABLE — сбой резолвинга доменных имен;
  • SOCKS5_AUTH_REJECTED — ошибка аутентификации пользователя SOCKS5 (RFC 1929);
  • CLOUDFLARE_EDGE_BLOCKED — сброс соединения на уровне DPI провайдера;
  • NETWORK_INTERFACE_DOWN — полное отключение сетевых интерфейсов устройства.

• Лимит буфера записи в JS-воркере и Rust-ядре увеличен до 4 МБ (MAX_PENDING_WRITE_BYTES = 4 * 1024 * 1024).
• Последовательная FIFO-очередь с асинхронным чтением Blob и ArrayBuffer.
• Защита от обрыва сессий WebSocket (код 1009) при параллельной отправке нескольких медиафайлов клиентом Telegram.

• Спящий режим при отсутствии сети (Deep Dormancy): при отключении интернета (авиарежим, потеря сигнала) служба закрывает сетевые сокеты и приостанавливает циклы DoH-запросов и пинга. При восстановлении сети соединение возобновляется моментально без холостого расхода батареи.
• Защита аккумулятора (Battery Guard): настраиваемое автоматическое отключение прокси при снижении заряда батареи ниже заданного порога (5%, 10%, 15%, 20%, 25%) или переходе Android в режим энергосбережения при работе не от зарядного устройства.

• Нативная поддержка Username/Password Subnegotiation в ядре mirrlyengine.
• Диалог обязательной настройки учетных данных перед первым запуском SOCKS5 для исключения работы открытого прокси в локальной сети устройства.
• Автоматическая передача логина и пароля в ссылках быстрого подключения: tg://socks?server=127.0.0.1&port=10808&user=...&pass=....

flowchart TD
    subgraph ClientLayer ["1. Клиенты Telegram на устройстве (Android)"]
        TG_MTProto["Клиент Telegram (MTProto)<br/>Порт 1443 (FakeTLS ee/dd)"]
        TG_SOCKS5["Клиент Telegram (SOCKS5)<br/>Порт 10808 (TCP / UDP VoIP)"]
    end

    subgraph NativeCore ["2. Нативное ядро mirrlyengine (Rust / Tokio Runtime)"]
        subgraph GatewayMTProto ["Шлюз MTProto (Порт 1443)"]
            FakeTLS["FakeTLS Demux<br/>Определение DC1-DC5"]
            WsPool["WsPool (Пул постоянных WebSocket)<br/>Zero-Copy стриминг"]
            FakeTLS --> WsPool
        end

        subgraph GatewaySocks ["Шлюз SOCKS5 (Порт 10808)"]
            SocksAuth["SOCKS5 Server (RFC 1928 / RFC 1929 Auth)<br/>TCP CONNECT / UDP ASSOCIATE"]
            Supervisor["RouteSupervisor (Диспетчер аплинков)<br/>Trust Policy & Node Independence"]
            SocksAuth --> Supervisor
        end

        subgraph SharedSubsystems ["Общие сетевые подсистемы ядра"]
            FSM["Дискретный FSM сети (NORMAL / DEGRADED / RECOVERING)"]
            GenGuard["Network Generation Guard (Изоляция эпох сети)"]
            DoH["DoH Race Resolver (1.1.1.1 / 8.8.8.8 / 9.9.9.9)"]
            FlowCtrl["Bounded Flow Control (Буфер записи 4 MB)"]
        end

        WsPool -.-> SharedSubsystems
        Supervisor -.-> SharedSubsystems
    end

    subgraph Uplinks ["3. Восходящие каналы (Uplinks)"]
        Uplink_Anycast_Direct["Anycast CDN Flowseal<br/>(kws1..kws5.web.telegram.org:443)<br/>Без расхода квоты Cloudflare Workers"]
        Uplink_Worker["Cloudflare Worker WSS<br/>(Личный воркер / пул разработчика)<br/>API cloudflare:sockets"]

        WsPool ===>|Прямое MTProto WSS| Uplink_Anycast_Direct
        Supervisor -->|Режим WORKER| Uplink_Worker
    end

    subgraph Infrastructure ["4. Внешняя сетевая инфраструктура"]
        CF_CDN["Cloudflare Anycast CDN Edge<br/>(300+ локаций по миру)"]
        CF_Worker_Runtime["Cloudflare Worker Edge Runtime<br/>(TCP Sockets via cloudflare:sockets)"]

        Uplink_Anycast_Direct --> CF_CDN
        Uplink_Worker --> CF_Worker_Runtime
    end

    subgraph TelegramCloud ["5. Инфраструктура серверов Telegram"]
        TG_DC["Telegram Data Centers (DC1 - DC5)<br/>Текстовые чаты, каналы, медиа"]
        TG_VoIP["Telegram VoIP Reflectors<br/>Голосовые и видеозвонки"]

        CF_CDN -->|Прямой Web TCP Socket| TG_DC
        CF_Worker_Runtime -->|Защищенный TCP Socket| TG_DC
        CF_Worker_Runtime -->|VoIP TCP/UDP Relay| TG_VoIP
    end

Приложение автоматически определяет установленные клиенты Telegram и позволяет активировать прокси в один клик:

• Официальные клиенты: Telegram, Telegram X
• Расширенные клиенты: AyuGram, NekoGram, Nagram, ExteraGram, Plus Messenger
• Сторонние клиенты: Cherrygram, Nicegram, iMe Messenger, Telegraph, MDGram, Dahl, Litegram, Nullgram, ForkClient, BifToGram

Пользовательский интерфейс разработан на Jetpack Compose с адаптацией под размеры экранов (AdaptiveLayoutHelper) и поддержкой трех языков (Русский, English, فارسی) с корректным направлением письма RTL:

• Главный экран (HomeScreen): центральная кнопка управления прокси, статус подключения, кольцо качества сети, переключатель режимов MTProto / SOCKS5, кнопка быстрого перехода «В Telegram» и лаконичная карточка активного маршрута (Cloudflare WSS · Защищено).
• Экран настроек (SettingsScreen):
  • Простой режим: выбор режима прокси, аплинка, таймер сна, расписание работы, автозапуск при включении устройства, выбор языка и темы.
  • Продвинутый режим: параметры сокетов TCP_NODELAY, буферы сокетов и емкость WebSocket-пула.
• Экран первого запуска (OnboardingScreen): пошаговый мастер быстрой начальной настройки с мгновенным выбором языка (RU, EN, FA) и надежной работой без зависаний на смартфонах Samsung и Huawei.
• Официальный Telegram-канал (TelegramChannelScreen): информация о сообществе проекта и прямая ссылка на канал @WhyOkyHb.
• Менеджер воркеров (WorkerManagerScreen): список добавленных воркеров Cloudflare с замером пинга, сканированием QR-кодов CameraX + Google ML Kit и прозрачными элементами вкладки «Поделиться» для быстрого обмена конфигурациями.
• Аналитика воркера (WorkerAnalyticsScreen): детальный график Безье суточного использования квоты Cloudflare с тач-скраббером и таймером до сброса квоты (00:00 UTC).
• Сетевая диагностика (NetworkDiagnosticScreen): отображение метрик SQI (0–100%), задержки RTT, джиттера, надежности доставки, расчет рейтинга ITU-T G.107 MOS и кнопка перехода к формированию диагностического отчёта.
• Диагностический отчёт (DiagnosticReportScreen): безопасный просмотр отчёта о конфигурации с маскированием конфиденциальных данных и кнопками экспорта для GitHub Issues.
• История сессий (HistoryScreen): компактный двухстрочный журнал сессий прокси с информацией о времени подключения, протоколе (MTProto / SOCKS5), статусе соединения и переданном трафике (RX/TX).
• Журнал событий (LogsScreen): минималистичный просмотр системных логов в темном AMOLED-стиле с фильтрацией, дедупликацией и поиском.
• Экран обновлений (UpdateScreen): проверка обновлений через GitHub API, отображение списка изменений, валидация отпечатков SHA-256 и нативная верификация подписи APK (SignatureVerifier).
• Экран системного VPN (VpnModeScreen): кинетический интерфейс (функция находится в разработке, системный туннель неактивен).
• Тестирование скорости (TunnelSpeedTestScreen): замер скорости туннеля (модуль в разработке).

1. Скачайте установочный пакет со страницы Релизы GitHub.
2. Выберите подходящий файл APK для вашего устройства:
   • app-universal-release.apk: универсальная сборка со всеми нативными библиотеками (ARM64, ARMv7, x86, x86_64). Подходит для любого Android-устройства. Основной файл для автообновлений.
   • app-arm64-v8a-release.apk: оптимизированная сборка для большинства современных смартфонов и планшетов (64-битные процессоры ARM). Обладает наименьшим размером файла.
   • app-armeabi-v7a-release.apk: для старых 32-битных ARM-устройств.
   • app-x86_64-release.apk: для 64-битных эмуляторов Android (Android Studio, LDPlayer, BlueStacks) и устройств на базе процессоров Intel/AMD.
   • app-x86-release.apk: для 32-битных эмуляторов Android x86.
3. Установите APK на устройство под управлением Android 8.0 (API 26) или новее.
4. Откройте Mirrly TG Proxy и нажмите центральную кнопку включения. Приложение выполнит экспресс-проверку (Smart Connect) и запустит службу.
5. Нажмите кнопку «В Telegram» и подтвердите сохранение прокси в открывшемся окне мессенджера.

Основные параметры конфигурации прокси (ProxyConfig), сохраняемые в локальном защищенном хранилище:

Развертывание персонального Cloudflare Worker занимает 1–2 минуты и не требует платных подписок. Персональный воркер предоставляет индивидуальную суточную квоту в 100 000 запросов и исключает конкуренцию за полосу пропускания.

Инструменты автодеплоя расположены в каталоге tools/deploy-worker/:

1. Перейдите в каталог tools/deploy-worker/.
2. Запустите файл deploy.bat двойным щелчком.
3. Скрипт проверит наличие Node.js (при необходимости предложит установку), установит Wrangler CLI, откроет авторизацию в браузере и выполнит развертывание.
4. В консоли отобразится готовый QR-код для моментального сканирования камерой смартфона.

irm https://raw.githubusercontent.com/joycecurcirt539-dot/Mirrly-TG-Proxy/main/tools/deploy-worker/deploy.ps1 | iex

chmod +x tools/deploy-worker/deploy.sh
./tools/deploy-worker/deploy.sh

1. Войдите в панель dash.cloudflare.com.
2. Перейдите в раздел Workers & Pages → Create application → Create Worker.
3. Задайте имя воркера и нажмите Deploy.
4. Нажмите Edit code, удалите шаблонный код и вставьте содержимое файла tools/deploy-worker/worker.js (или docs/cloudflare_worker.js).
5. Нажмите Deploy для сохранения.
6. Скопируйте полученный адрес (например: my-proxy.username.workers.dev).
7. В приложении Mirrly TG Proxy перейдите в Менеджер воркеров → Добавить воркер и сохраните адрес.

Mirrly TG Proxy/
├── app/                  # Android-клиент (Jetpack Compose UI, Foreground Service, NDK C++ native_sec.cpp)
│   ├── src/main/cpp/     # Нативный C++ модуль верификации подписи APK (native_sec.cpp, CMakeLists.txt)
│   ├── src/main/java/    # UI экраны, онбординг, каналы, сервисы фоновой работы, локализация
│   └── src/main/res/     # Ресурсы, разметка, векторные иконки, strings.xml (RU / EN)
├── core/                 # Модуль бизнес-логики и сетевых алгоритмов Kotlin
│   └── src/main/kotlin/  # LocalProxyServer, FFI NativeProxy, DoH, FSM, GenerationGuard, UpdateChecker
├── mirrlyengine/         # Высокопроизводительное нативное ядро на языке Rust (Tokio runtime)
│   ├── src/awg.rs        # Протокол AmneziaWG (обфускация WireGuard, QUIC I1, мусорные пакеты Jc)
│   ├── src/balancer.rs   # Happy Eyeballs v2 (RFC 8305) и балансировщик Anycast
│   ├── src/bridge.rs     # FFI-мост между Kotlin и нативным рантаймом Tokio
│   ├── src/budget.rs     # Управление бюджетом соединений (Dial Budget)
│   ├── src/cfproxy.rs    # Туннелирование через Cloudflare WSS с защитой от 429 ошибок
│   ├── src/dns.rs        # DoH-резолвер и гонка DNS-ответов
│   ├── src/faketls.rs    # MTProto FakeTLS (домены, ee/dd префиксы)
│   ├── src/generation_guard.rs # Защита от гонок сетевых поколений
│   ├── src/masque.rs     # WARP MASQUE HTTP/3 CONNECT-UDP
│   ├── src/network_profile.rs  # Дискретный FSM стабильности сети (NORMAL, DEGRADED, RECOVERING)
│   ├── src/node_independence.rs # Политики изоляции приватных и публичных узлов
│   ├── src/proxy.rs      # MTProto-сервер, FakeTLS ee/dd, WsPool
│   ├── src/recovery.rs   # Механизмы восстановления соединений и дренажа потоков
│   ├── src/socks5.rs     # SOCKS5-сервер, RFC 1929 субнегоциация, TCP relay
│   ├── src/supervisor.rs # Оркестратор мульти-аплинков (RouteSupervisor) и Trust Policy
│   ├── src/timeline.rs   # Профилирование фаз запуска туннелей
│   ├── src/tls_observability.rs # Наблюдаемость параметров TLS-хэндшейков
│   ├── src/vless.rs      # VLESS over WebSocket & Reality
│   ├── src/ws.rs         # Потоковый контроль буферов WebSocket (4 MB)
│   └── Cargo.toml        # Конфигурация крейта и зависимости Rust
├── tools/                # Вспомогательные утилиты разработки и сборки
│   ├── build/            # Скрипты компиляции нативного Rust-ядра под 4 ABI (build_native.ps1, build_native.sh, clean_all.ps1)
│   └── deploy-worker/    # Автодеплой воркеров (deploy.bat, deploy.ps1, deploy.sh, worker.js)
├── docs/                 # Документация, релиз-ноутсы и скрипт cloudflare_worker.js
└── gradle/               # Конфигурация Gradle Wrapper

• Android SDK (API Level 35, Build-Tools 35.0.0)
• Android NDK (рекомендуется NDK 27+)
• Rust Toolchain (cargo), установленные таргеты:

  rustup target add aarch64-linux-android armv7-linux-androideabi x86_64-linux-android i686-linux-android

• Java Development Kit (JDK 17+)

# 1. Клонирование репозитория
git clone https://github.com/joycecurcirt539-dot/Mirrly-TG-Proxy.git
cd Mirrly-TG-Proxy

# 2. Компиляция нативного Rust-ядра под все 4 архитектуры ABI
# Windows PowerShell:
.\tools\build\build_native.ps1
# Linux / macOS Bash:
chmod +x tools/build/build_native.sh
./tools/build/build_native.sh

# 3. Сборка релизных пакетов APK
./gradlew assembleRelease

Скомпилированные установочные пакеты формируются в директории app/build/outputs/apk/release/.

Проект начат 27 июля 2026 года с публикации версии v1.0.0. Эволюция ключевых этапов развития системы:

• Отсутствие аналитики и слежки: приложение не содержит рекламных трекеров, сторонних аналитических SDK и не ведет сбор персональных данных пользователей.
• Принцип нулевой утечки секретов (Zero Secret Leak): диагностический отчёт и журналы событий подвергаются обязательной санитарной очистке с маскированием паролей, ключей шифрования и личных доменов.
• Проверка подлинности сборок: встроенный модуль UpdateChecker выполняет двухэтапную проверку контрольных отпечатков SHA-256 и нативную валидацию цифровой подписи (C++ NDK SignatureVerifier). При обнаружении несовпадений установка блокируется (Fail-Closed).
• История изменений: подробный список изменений задокументирован в файле CHANGELOG.md.
• Лицензия: исходный код распространяется на условиях свободной лицензии GNU General Public License v3 (GPLv3).
• Пользовательское соглашение: юридические условия использования сервиса изложены в TERMS_OF_USE.md.

• amurcanov — разработчик tg-ws-proxy-android. Архитектурный базис проекта послужил отправной точкой для создания Mirrly TG Proxy.
• Flowseal — автор tg-ws-proxy, создатель оригинальной концепции туннелирования трафика Telegram через WebSocket-сессии Cloudflare.

• Grovymon — комплексный аудит безопасности ядра, исследование обхода блокировок на мобильных сетях, выявление специфических багов Window Insets и инициатива внедрения авторизации SOCKS5 RFC 1929 (Issues #3, #4, #5, #7, #8, #15, #16, #18, #19, #20).
• zzzxxx888207-design — диагностика стабильности ключей в оперативной памяти устройства и отладка работы скриптов Cloudflare Workers (Issues #1, #9, #10, #13).
• BbIBux — диагностика загрузки медиафайлов MTProto на операторах Т2 и Ростелеком, улучшение прозрачности диалогов (Issues #11, #12, #17).
• ustiprog — инициатива внедрения постоянного таймера сна (Auto-Stop on Start) и предоставление детальной телеметрии разряда аккумулятора при отсутствии интернета, послужившей основой режима Deep Dormancy (Issue #21).
• 40OIL — выявление дефекта перекрытия кнопок модальных окон системной трехкнопочной навигацией Android на Samsung Galaxy A55, инициировавшее аудит отступов (Issue #22).
• CrazyGhostRider — воспроизводимый отчёт о зависании первого запуска при выборе языка на Samsung S21 Ultra с Android 14, позволивший исправить обработку касаний и смены локали в онбординге (Issue #29).
• VikKalm — телеметрия и локализация блокировок воркеров на Android 13 arm64-v8a (Issue #6).
• liveonloan — обнаружение визуального бага перекрытия элементов управления на Realme GT7 (Issue #14).
• Dimaakaj — обнаружение синтаксической ошибки TypeScript ts(2554) в вызове serverWs.accept() в скрипте Cloudflare Worker, восстановившее деплой через веб-интерфейс Cloudflare.
• creeepeeer — подробный диагностический отчёт в мобильной сети LTE/5G на HONOR PTP-N29 (Android 16), способствовавший калибровке метрик качества связи (SQI) и механизмов отказоустойчивости (Issue #30).

• MSLight — инициатива внедрения полной английской локализации интерфейса приложения (Issue #23).
• Aseptronn — инициатива персидской локализации (Farsi) и распространение проекта в международном сообществе (Issue #23).
• Shon4k — тестирование предварительных сборок и стабильности сетевых соединений.
• Linar S — тестирование сетевых сценариев и совместимости на различных аппаратных платформах.
• Astimir Meikulov — активный участник официального Telegram-канала @WhyOkyHb.
• Илье Вайцману — автор канала @airfield1972„Запасной аэродром.“, за внимание к проекту и публикацию о Mirrly TG Proxy.