Оглавление

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

---

1. Что такое Mirrly TG Proxy

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 и без перехвата трафика других программ устройства.

---

Статус и классификация возможностей

1. Готовый функционал (Стабильно)

• Два локальных протокола 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.

2. В разработке

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

---

2. Технический принцип работы

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

Пайплайн 1: MTProto Gateway (127.0.0.1:1443) — Прямое Anycast CDN туннелирование

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.

Пайплайн 2: SOCKS5 Gateway (127.0.0.1:10808) — Мульти-аплинк супервизор (RouteSupervisor)

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-аплинки находятся в разработке и в этот маршрут не входят.

Звонки Telegram

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

---

3. Режимы восходящего канала (Uplink Modes для SOCKS5)

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

Режим (UplinkMode)	Статус	Протокол и порт	Описание и назначение
WORKER	Стабильно	WebSocket TLS 1.3 (:443)	Трафик инкапсулируется в WebSocket к Cloudflare Worker, где через cloudflare:sockets открывается TCP-сокет к дата-центрам или VoIP-узлам Telegram. Защищен правилами Anti-Open-Relay.

---

4. Ключевые возможности и архитектурные модули

Стабилизация сети и устранение флэппинга (FSM & Anti-Flapping)

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

Изоляция поколений сети (Network Generation Guard)

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

Экспресс-анализ перед подключением (Smart Connect)

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

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

Разделение настроек (Simple vs Advanced Settings UX)

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

Безопасный диагностический отчёт (Zero Secret Leak)

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

Доменная классификация ошибок (Error Taxonomy)

• Пользовательский уровень (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 — полное отключение сетевых интерфейсов устройства.

Потоковый контроль медиа и видео (Bounded Flow Control)

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

Энергосбережение Deep Dormancy и Battery Guard

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

SOCKS5-аутентификация (RFC 1928 / RFC 1929)

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

---

5. Архитектура системы

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

---

6. Поддерживаемые клиенты Telegram

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

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

---

7. Интерфейс приложения

Пользовательский интерфейс разработан на 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): замер скорости туннеля (модуль в разработке).

---

8. Быстрый старт и установка

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» и подтвердите сохранение прокси в открывшемся окне мессенджера.

---

9. Конфигурация и параметры

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

Параметр	По умолчанию	Описание
proxyModeName	MTPROTO	Активный локальный режим: MTPROTO или SOCKS5
bindHost / bindPort	127.0.0.1:1443	Локальный IP-адрес и порт для MTProto
socks5Port	10808	Локальный TCP-порт для SOCKS5
socks5Username / socks5Password	""	Учетные данные SOCKS5-аутентификации (RFC 1929)
secretHex	генерируется при первом запуске	Секретный ключ MTProto (34 hex-символа с префиксом dd)
customCfDomain	""	Персональный домен Cloudflare Worker
speedPresetName	AUTO	Профиль скорости: AUTO, ECO, BALANCED, TURBO, ULTRA
tcpNoDelayModeName	AUTO	Режим алгоритма Нагла: AUTO, ON, OFF
bufferSizeBytes	262144 (256 КБ)	Размер буфера сокетов по умолчанию
useDefaultWorkerSocks5	true	Использование пула воркеров разработчика при отсутствии личного домена
isBatteryGuardEnabled	false	Автоматическое отключение при критическом разряде аккумулятора
batteryGuardThreshold	15	Порог срабатывания защиты аккумулятора (в процентах)
allowPublicRelayFallbackForPrivateVps	false	Запрет перенаправления приватного VPS на публичные релеи
autostartOnBoot	false	Автозапуск прокси-службы при загрузке системы Android
verboseLogs	true	Подробная запись сетевых событий в журнал

---

10. Создание и настройка Cloudflare Worker

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

Способ 1: Автоматическое развертывание через CLI (рекомендуется)

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

Вариант A: Windows (в 1 клик)

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

Вариант B: PowerShell (одной строкой)

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

Вариант C: Linux / macOS / WSL

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

Способ 2: Ручное создание через панель управления Cloudflare

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 перейдите в Менеджер воркеров → Добавить воркер и сохраните адрес.

---

11. Структура проекта и сборка из исходного кода

Дерево каталогов репозитория

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/.

---

12. График активности разработки

---

13. Динамика звезд репозитория

Star History

---

14. Хронология развития

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

Версия / Дата	Этап развития	Ключевые изменения
v1.0.0 (27.07.2026)	Генезис	Первый публичный релиз. Локальный MTProto-шлюз на порту 1443, WsPool, интеграция с клиентами Telegram.
v1.0.4–1.0.5	Лицензия и буферизация	Переход на лицензию GPLv3, скоростные буферы, управление TCP_NODELAY.
v1.0.6–1.0.8	Защита и интерфейс	Нативная проверка цифровой подписи по SHA-256 (SignatureVerifier), таймер сна, аппаратное размытие FLAG_BLUR_BEHIND.
v1.0.9	SOCKS5 и звонки	Асинхронный TCP-релей SOCKS5 на порту 10808 через API cloudflare:sockets. Поддержка голосовых и видеозвонков.
v1.1.0–1.1.1	Стабилизация	Устранение JNI-конфликтов, индикация статус-бара, переход на ABI Splits.
v1.1.2	Переход на Rust	Перепись ядра на Rust (mirrlyengine): Zero-Copy, Tokio runtime, неблокирующий ввод-вывод epoll, устранение пауз GC.
v1.1.3–1.1.3.1	Менеджер воркеров	Менеджер узлов Cloudflare, алгоритм Happy Eyeballs (RFC 8305), deep links mirrly://worker.
v1.1.4	Полный Rust стек	Удаление устаревших JVM-сокетов, мгновенный failover, Anti-Open-Relay фильтрация в скрипте воркера.
v1.1.5	Оркестратор протоколов	3-фазный менеджер переключения протоколов, гонка воркеров разработчика.
v1.1.6–1.1.6.1	WebSocket оптимизация	Сборка фрагментированных фреймов до 16 МБ, очередь записи, автодеплой deploy.bat.
v1.1.7	Anycast CDN и UI	Перевод MTProto на Anycast CDN Flowseal, гонка со сдвигом 25 мс, рендеринг без аллокаций памяти (120 FPS).
v1.1.8	DoH, аналитика, QoS	DoH Race Resolver, DC-Affinity, аналитика суточной квоты с графиком Безье, Battery & Thermal QoS, Multi-APK Architecture Engine.
v1.1.8.1	Редизайн таймера сна	Нормализация доменов воркеров, Pre-Flight проверка узлов, обновленный диалог таймера сна.
v1.1.8.2	ML Kit и изоляция	Аппаратный сканер QR-кодов Google ML Kit, генератор фирменных QR-кодов, изоляция секретного ключа MTProto, WebPKI сертификаты.
v1.1.8.3	Спидтест и расписание	Тест скорости туннеля, субнегоциация SOCKS5 RFC 1929, планировщик по дням недели, спящий режим Deep Dormancy при офлайне.
v2.0.0	FSM сети и UI	Дискретный FSM сети (NORMAL, DEGRADED, RECOVERING), Network Generation Guard, Bounded Flow Control 4 МБ, экспресс-анализ Smart Connect, двухуровневые настройки, Onboarding, безопасный диагностический отчёт и локализация. VPN-режим остаётся в разработке.
v2.0.0.2	Локализация и UI	Персидская локализация (Farsi / RTL), динамическое масштабирование шрифта индикатора качества в тесте скорости, изоляция экрана VPN в разработке.
v2.0.0.3	Редизайн и стабильность	Минималистичный AMOLED-редизайн экранов истории сессий и системных логов, прозрачный стиль элементов во вкладке «Поделиться», устранение зависания первого запуска и выбора языка на Samsung One UI и Huawei EMUI/HarmonyOS, удаление ложных DNS-логов Cloudflare и быстрое освобождение портов SOCKS5 (SO_REUSEPORT).

---

15. Безопасность и условия использования

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

---

16. Благодарности и Зал Славы

• 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.