explaingit

telemt/telemt

Analysis updated 2026-07-03

3,712RustAudience · ops devopsComplexity · 3/5LicenseSetup · moderate

TLDR

A Rust-based Telegram MTProxy server that disguises traffic as normal HTTPS to bypass censorship filters, with replay attack protection, async connection handling, and a single-binary install.

Mindmap

mindmap
  root((telemt))
    What it does
      Telegram MTProxy server
      Bypasses regional blocks
      Disguises traffic as HTTPS
    Connection modes
      Classic MTProxy
      Secure mode
      Fake TLS fronting
    Security
      Replay attack protection
      Forward unknown traffic
    Tech Stack
      Rust
      Tokio async
      TOML config
    Setup
      Single binary
      One shell command
      IPv6 support
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Deploy a Telegram proxy on a VPS so users in regions that block Telegram can still connect.

USE CASE 2

Use fake-TLS mode to make Telegram proxy traffic look like normal HTTPS browsing to deep-packet inspection systems.

USE CASE 3

Run the proxy in forwarding mode so unrecognized connections go to a real web server, making the host look like a legitimate website.

USE CASE 4

Self-host a high-concurrency Telegram proxy on modest hardware using the async Rust design for low memory overhead.

What is it built with?

RustTokioMTProxyTOML

How does it compare?

telemt/telemtkube-rs/kubevlcn-io/cr-sqlite
Stars3,7123,7043,703
LanguageRustRustRust
Setup difficultymoderatehardmoderate
Complexity3/54/53/5
Audienceops devopsops devopsdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a VPS with a public IP, installation is one command but you need to write a TOML config file with proxy credentials.

Free and open source, use and redistribute without restriction.

In plain English

Telemt is a Telegram proxy server written in Rust. Telegram is a messaging app that some internet providers or governments block in certain regions. A proxy server sits between your device and Telegram's network, relaying your traffic so you can still connect. Telemt implements the protocol Telegram uses for its own official proxies, called MTProxy, and adds several production-focused improvements on top. The project is built with Rust and an asynchronous networking library called Tokio. Rust is a programming language known for predictable memory usage, no garbage collection pauses, and a safety model that reduces common server crashes or vulnerabilities. The async design allows the server to handle many simultaneous connections without creating a separate thread for each one, keeping resource usage low on the host machine. Telemt supports three connection modes from the official MTProto spec. The classic mode is the baseline. The secure mode adds a specific prefix to distinguish connections. The fake TLS mode makes proxy traffic look like normal HTTPS browsing to deep-packet inspection tools, using a technique called SNI fronting. The README describes the project's TLS-fronting implementation as one of the most carefully tested in this category, with documented validation traces against real traffic patterns. Additional features include replay attack protection, which prevents captured connection data from being reused to impersonate a client. There is also optional forwarding of unrecognized connections to a real web server, so the proxy can appear to be a legitimate site. The server supports configurable keepalive and timeout settings, IPv6, and graceful shutdown. Logging detail can be tuned via an environment variable. Installation takes a single shell command. Building from source requires the Rust toolchain and produces one binary. Configuration is handled through a TOML file passed as an argument at startup. The project is open source and free to use. The maintainer accepts cryptocurrency donations for infrastructure and continued development.

Copy-paste prompts

Prompt 1
Show me how to install telemt with a single command and write a TOML config file to run a Telegram MTProxy with fake-TLS mode enabled.
Prompt 2
How do I configure telemt to forward unrecognized connections to an nginx web server on the same machine so the proxy looks like a real site?
Prompt 3
Walk me through building telemt from source with the Rust toolchain and deploying the resulting binary as a systemd service.
Prompt 4
How do I enable IPv6 and tune the keepalive and timeout settings in telemt's TOML configuration?
Prompt 5
What does telemt's replay attack protection do, and how can I verify it is active and working?

Frequently asked questions

What is telemt?

A Rust-based Telegram MTProxy server that disguises traffic as normal HTTPS to bypass censorship filters, with replay attack protection, async connection handling, and a single-binary install.

What language is telemt written in?

Mainly Rust. The stack also includes Rust, Tokio, MTProxy.

What license does telemt use?

Free and open source, use and redistribute without restriction.

How hard is telemt to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is telemt for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub telemt on gitmyhub

Verify against the repo before relying on details.