TG WS Proxy

A Telegram MTProto WebSocket Bridge Proxy with advanced DPI bypass for Android devices.

What is this? tg-ws-proxy-android is an Android application that creates a local MTProto proxy server on your phone. It connects to Telegram's WebSocket (WS) endpoints using DPI-bypass techniques: DoH resolution, Cloudflare fallback, parallel connections, and fake TLS handshakes.

Why not just use the original Python proxy? The original tg-ws-proxy runs as a Python CLI on desktop. This project:

Ported to Android using Kotlin + Android SDK 34 Runs as a foreground service with persistent notification GUI settings instead of editing text files In-app log viewer with export/sharing Optimised for mobile network — less battery usage than Python + Termux Fixed critical stability issues discovered during real-world testing

Features Feature Description MTProto ↔ WebSocket Bridge Transparent bridge between Telegram app and Telegram DCs DoH (DNS-over-HTTPS) Bypass DNS spoofing with encrypted DNS resolution CF Proxy Fallback Automatic fallback via Cloudflare Workers if direct IPs are blocked Parallel Connect Race multiple IPs simultaneously for sub-second handshakes Auto Fake TLS Automatic TLS SNI camouflage for DPI bypass Media via CF Route media traffic through Cloudflare to save bandwidth Frame Padding + DoH Rotation Optional WS padding + cyclic DoH provider rotation Pre-warmed CF Pool Background health-check before first real connection (< 1s cold-start) Connection Pool Keep-alive pool with automatic refilling and age-based eviction Foreground Service Persistent notification, optional background restart In-app Logs Live log viewer with export to .txt (share or save to Downloads) Proxy Link Auto-generate tg://proxy link with dd/ee secret RU / EN Localization Auto-detect system language; manual switcher in Bypass Settings In-app Help Localized help screen with full feature docs Check for Updates Automatic GitHub Releases check on startup; manual button in toolbar