Mirrly TG Proxy

A native, high-performance MTProto & Cloudflare WebSocket proxy server designed for local traffic filtering and Telegram connection optimization.

Network route optimization, lower connection latency, and MTProto traffic tunneling through intermediate WebSocket CDN nodes. Runs on a native C/Rust engine equipped with a warm socket pool (WsPool).

1. About the Project & How It Works

Mirrly TG Proxy sets up an isolated local proxy server at 127.0.0.1:1443 directly on your Android device. It receives MTProto traffic from your Telegram clients and transparently tunnels it over encrypted WebSocket connections to Cloudflare CDN nodes.

🛡️ What problem does it solve?

- Stabilizes Connection to DC1–DC5: Optimizes traffic routing to Telegram data centers through distributed Cloudflare CDN nodes, reducing packet loss. - Traffic Encryption & Encapsulation: Encapsulates MTProto packets into standardized, secure HTTPS WebSocket sessions (WSS) to prevent network interference and instability. - No VPN Required: Operates strictly locally on 127.0.0.1:1443. It does not require VpnService permissions, does not intercept traffic from other apps, and conserves battery life.

2. Key Features

- Native C/Rust Engine + JNA: Delivers high packet routing speeds without the overhead of a Java Virtual Machine. - Pre-warmed WsPool Sockets: Maintains active WebSocket connections to Telegram data centers (DC1–DC5), eliminating initial handshake delays. - Custom Cloudflare Worker Domains: Allows you to link your personal Worker domain (e.g., my-proxy.subdomain.workers.dev). - Battery Lifecycle Guard: Automatically pauses sensors and UI rendering when minimized, resulting in 0% battery draw in the background. - Android Quick Settings Tile: Toggle the proxy on or off with a single tap from your Android notification shade. - Live Telemetry & Visual Graph: Real-time activity monitoring for WsPool sockets (120 FPS Liquid Wave Engine) alongside technical log translations.

3. Supported Telegram Clients (17+ Clients)

The app automatically scans installed clients and lets you connect the proxy in one click:

- Official: Telegram Official, Telegram X - Popular Forks: AyuGram, NekoGram, Nagram, ExteraGram, Plus Messenger - Modifications: Cherrygram, Nicegram, iMe Messenger, Telegraph, MDGram, Dahl, Litegram, Nullgram, ForkClient, BifToGram

4. Quick Start & Installation

1. Download the latest APK. 2. Install the APK and launch Mirrly TG Proxy. 3. Tap the main center button to enable it. 4. Tap "To Telegram" and select your preferred client for instant setup.

5. Security, Disclaimer, and License

- 100% Open Source: The app does not collect personal data, messages, or browsing history. It runs exclusively locally on 127.0.0.1:1443.

⚠️ Legal Disclaimer

This project was developed strictly for educational and research purposes to study MTProto traffic tunneling over WebSockets and to analyze network connectivity parameters.

- No Warranties: The software is provided "AS IS", without warranty of any kind, express or implied. - Limitation of Liability: The authors and copyright holders are not liable for any direct or indirect consequences resulting from the use of this software by third parties, nor for any potential damage or violation of local laws. - Compliance: Users are solely responsible for ensuring compliance with the laws of their country or jurisdiction when using this tool. - Intended Use: This project does not offer commercial services, is not a censorship circumvention service, and does not encourage the violation of applicable laws. - License: Distributed under the GNU General Public License v3 (GPLv3).