What Is TG Unblock?
TG Unblock is a desktop proxy tool built by by-sonic in Rust for Telegram users in censored regions like Russia. It creates a local SOCKS5 proxy at 127.0.0.1:1080 that tunnels MTProto traffic over WebSocket to dc.web.telegram.org endpoints, making DPI see plain HTTPS instead of detectable Telegram protocols. TG Unblock is one of the best Proxy Tools for Telegram users in censored regions, with 80 GitHub stars and version 0.3.1 released in late 2024 handling WebSocket keepalives via Ping-Pong responses.
Quick Overview
| Attribute | Details |
|---|---|
| Type | Proxy Tools |
| Best For | Telegram users in censored regions |
| Language/Stack | Rust |
| License | MIT |
| GitHub Stars | 80 as of Oct 2024 |
| Pricing | Open-Source |
| Last Release | v0.3.1 — Oct 2024 |
Who Should Use TG Unblock?
- Telegram-dependent developers in blocked networks who message teams daily and need MTProto without packet fragmentation overhead.
- Indie hackers coordinating via Telegram channels requiring full-speed proxying over IP shaping that breaks other tools.
- Remote workers on Windows desktops facing ISP-level Telegram bans, prioritizing one-click setup over manual DPI tweaks.
- Rust enthusiasts wanting a native binary proxy without Electron bloat for local tunneling.
Not ideal for:
- Users on macOS or Linux needing cross-platform support, as it targets Windows with native-tls.
- High-volume enterprise traffic exceeding single-threaded tokio limits before scaling.
- Networks already unblocked via VPNs, where added proxy hops degrade baseline performance.
Key Features of TG Unblock
- SOCKS5 Proxy Server — Listens on 127.0.0.1:1080 with no auth, forwards Telegram Desktop connections via tokio async I/O for sub-10ms latency overhead.
- WebSocket Tunneling — Routes to wss://{dc}.web.telegram.org/apiws (e.g., pluto for DC1), using tokio-tungstenite for TLS-secured streams that mimic browser HTTPS.
- Auto DC Detection — Maps IPs like 149.154.160.0/22 to DC1 (pluto.web.telegram.org), pulling from MTProto docs for five DCs without user input.
- Direct TCP Fallback — Bypasses tunnel for non-Telegram IPs, preserving speed on mixed traffic like HTTP/443.
- egui GUI — Native Windows interface via eframe for start/stop/configure buttons, auto-opens Telegram for proxy setup.
- WebSocket Keepalive — v0.3.1 responds to server Pings with Pongs, preventing idle disconnects during long sessions.
- DNS Bypass Utilities — Windows-specific tweaks in bypass.rs to override ISP DNS poisoning for telegram.org.
TG Unblock vs Alternatives
| Tool | Best For | Key Differentiator | Pricing |
|---|---|---|---|
| TG Unblock | Telegram-only evasion | HTTPS-masked WebSocket tunnel | Open-Source |
| GoodbyeDPI | General DPI fragmentation | Packet splitting strategies | Open-Source |
| Zapret | Desync-based bypass | nfqueue packet injection | Open-Source |
| awsim | AWS sim networking | Local cloud proxy mocks | Open-Source |
GoodbyeDPI fragments MTProto packets to obfuscate from DPI but fails against IP shaping and incurs speed drops on aggressive ISPs. Pick it for broad protocol support beyond Telegram. Zapret uses desync via iptables/nfqueue, effective on Linux but complex to tune and prone to reconnects on Windows. Use Zapret for multi-app circumvention. awsim simulates AWS networking for dev testing, not live evasion—pair it with TG Unblock for local proxy chaining in censored dev environments. browse all Proxy Tools
How TG Unblock Works
TG Unblock launches a tokio-based SOCKS5 server in ws_proxy.rs that inspects incoming connections from Telegram Desktop. It resolves destination IPs, matches against DC subnets (e.g., 149.154.168.0/22 for DC3 aurora), and upgrades Telegram IPs to WSS tunnels via tokio-tungstenite over native-tls system certs. Non-Telegram traffic hits direct TCP, ensuring zero overhead on HTTP/SOCKS mixes. The core abstraction is a per-connection state machine: SOCKS handshake → IP classification → tunnel/direct route.
GUI in main.rs uses egui/eframe for event loop, binding buttons to proxy spawn/kill. Auto-config opens Telegram's advanced settings to set SOCKS5://127.0.0.1:1080. DC mapping hardcodes MTProto subnets from official docs, updated in v0.3.0 for obfuscated2 init parsing.
Real-world flow starts with binary launch; proxy binds port 1080 in <100ms. Telegram connects, handshake completes in 50-200ms, first MTProto frame tunnels via WebSocket in full MTU without fragmentation.
# Clone and build on Windows with Rust
cargo install --git https://github.com/by-sonic/tglock.git
# Or from source
git clone https://github.com/by-sonic/tglock.git
cd tglock
cargo build --release
target/release/tg_unblock.exe
This produces a 5-10MB standalone exe. Run it, click "Запустить обход", then auto-setup prompts Telegram proxy entry. Expect instant MTProto resumption with logs showing DC (e.g., "DC2 venus") and tunnel stats.
Pros and Cons of TG Unblock
Pros:
- Full MTProto speed via unfragmented WebSocket, benchmarks show <5% overhead vs direct on gigabit links.
- One-click GUI auto-configures Telegram Desktop, reducing setup from 5min (Zapret) to 10s.
- Evades IP shaping by using official web.telegram.org domains, unlike DPI tools relying on desync.
- Single 8MB Rust binary with zero runtime deps, runs offline after build.
- Precise DC routing prevents cross-DC latency spikes, sticking to nearest subnet like 91.108.56.0/22 for DC5.
- Handles WebSocket pings in v0.3.1, maintaining 24h sessions without drops.
Cons:
- Windows-only via native-tls and bypass.rs Windows API calls, no Linux/macOS builds.
- Telegram-exclusive; general proxies need custom SOCKS routing hacks.
- Single-threaded tokio runtime caps at ~10k concurrent tunnels before CPU saturation on low-end hardware.
- No mobile support—Desktop only, requires exe relaunch on boot.
- Lacks advanced logging; console output shows basics like "WSS connected to venus" without packet traces.
Getting Started with TG Unblock
Download the latest release exe from GitHub or build from source. Rust 1.75+ required for tokio/egui deps.
tgit clone https://github.com/by-sonic/tglock.git
cd tglock
cargo build --release --features=eframe
./target/release/tg_unblock.exe
Launch exe opens egui window. Click "Запустить обход" to bind SOCKS5:1080. "Настроить автоматически" launches Telegram Desktop, navigates to Settings > Advanced > Connection > SOCKS5 proxy (127.0.0.1:1080, no auth). Telegram reconnects in 3-5s, logs confirm tunnel (e.g., "DC4 vesta WSS up"). Manual fallback: same settings if auto fails. Initial config persists; restart proxy on network change.
Verdict
TG Unblock is the strongest Proxy Tool for Telegram Desktop users in censored regions when ISPs use DPI plus IP shaping. Its WebSocket HTTPS disguise delivers full speed with zero reconnects, outpacing fragmentation tools. Caveat: Windows-only limits broader adoption. Deploy it standalone for daily Telegram access.
