Tg Ws Proxy Telegram Socks5

If you're in a region where Telegram gets blocked at the network level, this sets up a local SOCKS5 proxy that tunnels your Telegram Desktop traffic through WebSocket connections to Telegram's data centers. It intercepts the MTProto handshake to figure out which DC you're connecting to, then wraps everything in WSS. Ships as a Python package with optional system tray apps for Windows, macOS, and Linux. The approach is clever because it bypasses DPI without needing a remote VPS. Setup is straightforward: install via pip or grab a binary, point Telegram Desktop to 127.0.0.1:1080, and you're done. Falls back to direct TCP if the WebSocket route doesn't work.

skills.sh installs: 837
GitHub stars: 61
last updated: Jul 14, 2026

View on GitHub

Install

$ npx -y skills add aradotso/trending-skills --skill tg-ws-proxy-telegram-socks5 --agent claude-code

Installs into .claude/skills of the current project.

Files

TG WS Proxy

Skill by ara.so — Daily 2026 Skills collection.

TG WS Proxy is a local SOCKS5 proxy server for Telegram Desktop that reroutes traffic through WebSocket (WSS) connections to Telegram's Data Centers, bypassing network-level blocking without external servers.

Telegram Desktop → SOCKS5 (127.0.0.1:1080) → TG WS Proxy → WSS → Telegram DC

How It Works

Starts a local SOCKS5 proxy on 127.0.0.1:1080
Intercepts connections to Telegram IP addresses
Extracts DC ID from MTProto obfuscation init packet
Opens a WebSocket (TLS) connection to the matching DC via Telegram domains
Falls back to direct TCP if WebSocket returns a 302 redirect

Installation

From Source (All Platforms)

git clone https://github.com/Flowseal/tg-ws-proxy.git
cd tg-ws-proxy
pip install -e .

Run Console Proxy (No GUI)

tg-ws-proxy

Run with Tray GUI

# Windows
tg-ws-proxy-tray-win

# macOS
tg-ws-proxy-tray-macos

# Linux
tg-ws-proxy-tray-linux

Linux — AUR (Arch-based)

SKILL.md on GitHub

Details

Repository: github.com/aradotso/trending-skills
Category: Backend & APIs
First seen: May 16, 2026