tg-ws-proxy is a local MTProto proxy server for Telegram Desktop that accelerates Telegram by redirecting traffic through WebSocket connections.
The tool addresses network performance issues when accessing Telegram in restricted environments. It works by intercepting Telegram Desktop traffic and routing it through WebSocket connections while preserving the original encryption, eliminating the need for external proxy servers. The proxy runs locally on the user's machine and integrates directly with Telegram Desktop through configuration settings.
The project suits users experiencing slow Telegram performance or connectivity issues in their region who want a lightweight, self-contained solution. It provides platform-specific builds for Windows, macOS, and Linux, as well as Docker deployment options. The tool includes optional advanced configurations such as Cloudflare Worker integration, Cloudflare domain proxying, and Fake TLS with Nginx upstream support for users needing additional layers of obfuscation or routing flexibility.
Development activity shows consistent maintenance with documentation covering multiple deployment scenarios and platform-specific setup guides. The project maintains builds for various Windows versions and architectures, indicating attention to compatibility across different user environments. Contributor guidelines are documented, suggesting openness to external contributions.
