tg-proxy v1.2.0

tg-proxy v1.2.0

Telegram, where Telegram is blocked: one small binary, no server, no VPN.
Tunnels Telegram over WebSocket — direct, with SNI fronting, through a free
Cloudflare Worker, Cloudflare-proxied domains, or plain TCP — and tells you
which routes work on your network.

Download

Platform	File
Linux x86_64 (static)	tg-proxy-linux-x86_64
Linux aarch64 (static)	tg-proxy-linux-aarch64
Windows x86_64	tg-proxy-windows-x86_64.exe
macOS Intel	tg-proxy-macos-x86_64
macOS Apple Silicon	tg-proxy-macos-aarch64

Verify with SHA256SUMS.txt.

Quick start

chmod +x tg-proxy-linux-x86_64 && ./tg-proxy-linux-x86_64     # Linux / macOS
tg-proxy-windows-x86_64.exe                                   # Windows

Click the tg://proxy?… link it prints to add the proxy to Telegram.
Something wrong? Run tg-proxy --check to see which routes work.

Docs: English ·
Русский ·
Cloudflare Worker guide

macOS may block unsigned binaries on first run: right-click → Open, or
xattr -d com.apple.quarantine ./tg-proxy-macos-*.

tg-proxy v1.1.0

tg-proxy v1.1.0

Telegram, where Telegram is blocked: one small binary, no server, no VPN.
Tunnels Telegram over WebSocket — direct, with SNI fronting, through a free
Cloudflare Worker, Cloudflare-proxied domains, or plain TCP — and tells you
which routes work on your network.

Download

Platform	File
Linux x86_64 (static)	tg-proxy-linux-x86_64
Linux aarch64 (static)	tg-proxy-linux-aarch64
Windows x86_64	tg-proxy-windows-x86_64.exe
macOS Intel	tg-proxy-macos-x86_64
macOS Apple Silicon	tg-proxy-macos-aarch64

Verify with SHA256SUMS.txt.

Quick start

chmod +x tg-proxy-linux-x86_64 && ./tg-proxy-linux-x86_64     # Linux / macOS
tg-proxy-windows-x86_64.exe                                   # Windows

Click the tg://proxy?… link it prints to add the proxy to Telegram.
Something wrong? Run tg-proxy --check to see which routes work.

Docs: English ·
Русский ·
Cloudflare Worker guide

macOS may block unsigned binaries on first run: right-click → Open, or
xattr -d com.apple.quarantine ./tg-proxy-macos-*.

tg-proxy v1.0.1

tg-proxy v1.0.1

High-performance Telegram WebSocket bridge proxy written in Rust.

Binaries

Platform	File
Linux x86_64 (static)	tg-proxy-linux-x86_64
Linux aarch64 (static)	tg-proxy-linux-aarch64
Windows x86_64	tg-proxy-windows-x86_64.exe
macOS Intel	tg-proxy-macos-x86_64
macOS Apple Silicon	tg-proxy-macos-aarch64

Quick start

# Linux/macOS
chmod +x tg-proxy-linux-x86_64
./tg-proxy-linux-x86_64

# Windows
tg-proxy-windows-x86_64.exe

Then configure Telegram Desktop: Settings → Advanced → Connection type → Proxy → SOCKS5 → 127.0.0.1:1080

Or open in Telegram automatically: tg://socks?server=127.0.0.1&port=1080

Mobile (LAN): run with --host 0.0.0.0 and connect from your phone to your LAN IP.