# flowseal/tg-ws-proxy

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/flowseal-tg-ws-proxy).**

_How this analysis was created: the description and tags below were written by an AI model that read this project's README and public documentation pages; stars, license and language come straight from the GitHub API. The model does not read the source code._

7,906 stars · 380 forks · Python · MIT

## Links

- GitHub: https://github.com/Flowseal/tg-ws-proxy
- awesome-repositories: https://awesome-repositories.com/repository/flowseal-tg-ws-proxy.md

## Topics

`proxy` `telegram` `tg-ws-proxy`

## Description

tg-ws-proxy is a local proxy server and network tool designed to route Telegram traffic through WebSocket connections. It functions as a bridge that tunnels MTProto protocol traffic to bypass network restrictions and circumvent firewalls that block direct connections to messaging services.

The project includes a system tray proxy manager that provides a desktop interface for controlling the server state. This manager allows for updating connection secrets, viewing server logs, and restarting services through a native OS desktop tray icon.

The system supports establishing proxy connections via specialized connection strings or manual entry of addresses, ports, and secrets. It manages traffic by intercepting outgoing client requests and redirecting them through a local loopback to a remote endpoint.

## Tags

### Networking & Communication

- [MTProto Implementations](https://awesome-repositories.com/f/networking-communication/custom-protocol-implementations/mtproto-implementations.md) — Implements the MTProto protocol to securely forward encrypted Telegram traffic between local clients and remote servers.
- [WebSocket Proxy Tunnels](https://awesome-repositories.com/f/networking-communication/distributed-systems-p2p/distributed-computing/communication-protocols/websocket-implementations/websocket-servers/websocket-proxy-tunnels.md) — Wraps MTProto traffic inside WebSocket streams to tunnel communication across restricted network boundaries.
- [Censorship Bypass Routing](https://awesome-repositories.com/f/networking-communication/network-infrastructure-routing/network-infrastructure-configuration/network-infrastructure/traffic-routing-proxies/censorship-bypass-routing.md) — Routes traffic through WebSocket tunnels specifically to circumvent internet censorship and network blocks.
- [Local Loopback](https://awesome-repositories.com/f/networking-communication/proxy-servers/local-loopback.md) — Binds to local loopback interfaces to intercept outgoing Telegram requests and tunnel them to a remote endpoint.
- [MTProto](https://awesome-repositories.com/f/networking-communication/proxy-servers/mtproto.md) — Functions as a local proxy server that routes Telegram traffic through WebSocket connections to bypass restrictions.
- [Restrictive Network Connectivity](https://awesome-repositories.com/f/networking-communication/restrictive-network-connectivity.md) — Ensures communication stability in restrictive environments by wrapping messaging traffic in WebSocket streams. ([source](https://github.com/flowseal/tg-ws-proxy#readme))
- [MTProto Proxy Clients](https://awesome-repositories.com/f/networking-communication/socks5-proxies/mtproto-proxy-clients.md) — Implements an MTProto proxy client to maintain messaging service access when direct connections are restricted.
- [Traffic Tunneling](https://awesome-repositories.com/f/networking-communication/traffic-tunneling.md) — Redirects MTProto traffic through a secure bridge to maintain connectivity to blocked messaging services.
- [MTProto Proxy Management](https://awesome-repositories.com/f/networking-communication/mtproto-proxy-management.md) — Provides a dedicated system tray tool for monitoring logs and updating connection secrets for the MTProto proxy.
- [Proxy Management Systems](https://awesome-repositories.com/f/networking-communication/proxy-management-systems.md) — Offers a management interface to monitor server logs, edit configurations, and control proxy connection states. ([source](https://github.com/flowseal/tg-ws-proxy#readme))
- [Tray-Based Controllers](https://awesome-repositories.com/f/networking-communication/proxy-management-systems/tray-based-controllers.md) — Provides a desktop interface via a system tray icon to update secrets and manage server states.

### Development Tools & Productivity

- [Process Controllers](https://awesome-repositories.com/f/development-tools-productivity/system-tray-managers/process-controllers.md) — Provides a native OS desktop tray icon to control background server lifecycles and update configurations.