TG WS Proxy

Native Android port of tg-ws-proxy — a local SOCKS5 proxy that speeds up Telegram by routing traffic through WebSocket connections. Data stays end-to-end encrypted (MTProto), no third-party servers involved.

How it works Telegram Android → SOCKS5 (127.0.0.1:1080) → TG WS Proxy → WSS → Telegram DC The app runs a local SOCKS5 proxy server on 127.0.0.1:1080 Intercepts connections to Telegram IP addresses Extracts the DC ID from the MTProto obfuscation init packet Establishes a WebSocket (TLS) connection to the corresponding DC via Telegram domains Falls back to direct TCP automatically if WebSocket is unavailable (302 redirect) Non-Telegram traffic is passed through directly.

Features Foreground service — keeps running reliably in the background with a persistent notification WebSocket connection pool — pre-established connections for faster handshakes MTProto message splitting — correctly handles coalesced/split TCP packets Auto DC detection — identifies target datacenter from the init packet, patches DC ID when needed Light & Dark themes — follows system theme by default, or choose manually Start on boot — optional autostart via boot receiver Wake lock — prevents the device from killing the proxy during sleep Copy proxy address / Open in Telegram — one-tap setup Quick start Install the APK from the Releases page Open the app and tap Start Tap Open in Telegram to automatically configure the proxy, or set it up manually: Telegram → Settings → Data and Storage → Proxy → Add Proxy Type: SOCKS5 Server: 127.0.0.1 Port: 1080 Username / Password: leave empty Settings Tap the ⚙️ gear icon in the top bar to access settings:

Setting Default Description Theme System Light, Dark, or follow System SOCKS5 Port 1080 Local proxy listening port DC IPs 2:149.154.167.220, 4:149.154.167.220 Target IP per datacenter (DC:IP format) Pool Size 4 Number of pre-established WebSocket connections per DC Buffer KB 256 Socket send/receive buffer size in KB Start on boot Off Automatically start the proxy service on device boot Settings are applied after tapping Save & Restart.