TG WS Proxy is a local MTProto proxy server that improves Telegram Desktop connectivity by bridging your client’s traffic through secure WebSocket (TLS) connections directly to Telegram’s data centers. No third-party servers are involved — all data remains end-to-end encrypted by Telegram’s own MTProto protocol.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/Flowseal/tg-ws-proxy/llms.txt
Use this file to discover all available pages before exploring further.
Quick Start
Get your proxy running in under two minutes on any platform.
How It Works
Understand the WebSocket bridge and fallback architecture.
Installation
Download pre-built binaries for Windows, macOS, Linux, or Docker.
Configuration
Explore all CLI flags, tray settings, and advanced options.
Why TG WS Proxy?
When Telegram’s standard TCP connections are restricted or slow, TG WS Proxy transparently reroutes traffic through WebSocket connections — which are harder to block and often benefit from CDN routing. If WebSocket fails, it automatically falls back to Cloudflare-proxied connections or direct TCP.Zero External Servers
All traffic stays encrypted by MTProto. No relay servers see your messages.
Automatic Fallback
WS → Cloudflare Worker → CF Proxy → direct TCP — falls back silently.
Cross-Platform GUI
Native tray apps for Windows, macOS menubar, and Linux AppIndicator.
Get Started
Download or install
Grab the pre-built binary for your OS from the GitHub releases page, or install from source with
pip install -e ..Launch the application
Run the executable. A system tray icon appears (Windows/Linux) or a menubar item (macOS). On first launch, a setup window shows your connection details.