Telegram Proxy Link Generator (MTProto / SOCKS5)
Enter the server, port and secret to generate one-tap tg and t.me import links, with an MTProto and SOCKS5 field comparison and setup troubleshooting.

| Type | Required fields | Link prefix | Use case |
|---|---|---|---|
| MTProto | server, port, secret | tg://proxy or https://t.me/proxy | Telegram-specific - strong anti-blocking, recommended first |
| SOCKS5 | server, port, user/pass (optional) | tg://socks or https://t.me/socks | General proxy - compatible with provider nodes |
How do I set up a SOCKS5 proxy in Telegram to connect?
Path: on desktop click the top-left three lines > Settings > Advanced > Connection type / Proxy > Add proxy; on macOS: Settings > Data > Use proxy; on iOS/Android: Settings > Data and Storage > Proxy.
How to fill it in: choose SOCKS5, set the server to 127.0.0.1 (when using a VPN client on your own machine), and set the port to the client actual local listening port. This is the easiest pitfall: the port must match the local port in Clash, v2rayN and the like (Clash mixed port is commonly 7890, the v2rayN SOCKS5 port is commonly 10808, Shadowsocks is commonly 1080, based on each software actual setting). Note the built-in proxy box accepts only SOCKS5, not HTTP proxies; when not logged in you must restart Telegram after setup for it to take effect.
Where do I enter the proxy server IP address on the paper plane?
Enter it in the built-in proxy settings inside Telegram (the paper plane): on desktop go to Settings > Advanced > Connection type / Proxy > Add proxy; on mobile go to Settings > Data and Storage > Proxy.
Under the SOCKS5 type, if you use a VPN client on your own machine, set the server IP to 127.0.0.1 and the port to the client actual local port (Clash is commonly 7890, the v2rayN SOCKS5 port is commonly 10808). If it is a remote SOCKS5 node someone gave you, enter the IP and port they provided. MTProto proxies are more often imported via a one-tap link (tap tg://proxy?server=...&port=...&secret=... to auto-fill and enable it). Note the built-in box accepts only SOCKS5, not HTTP proxies; restart Telegram after setup.

Which is better to use, Telegram MTProto proxy or SOCKS5 proxy?
Both are officially supported by Telegram built-in proxy, and which to pick depends on what you have. MTProto is a proxy protocol Telegram built specifically to fight blocking (launched in 2018 to counter the Russia and Iran blocks),
it is usually shared via one-tap t.me/proxy links, and a secret starting with dd means fake-TLS is on, disguising traffic as ordinary HTTPS to resist detection, which suits the case of having no VPN of your own and wanting to just tap a link and connect. SOCKS5 suits you if you already run Clash or v2rayN locally: just fill in 127.0.0.1 plus the local port, flexible but you must match the port yourself. In short: use someone MTProto link if you have a ready-made node, and SOCKS5 if you have a local client.
Where is the built-in Telegram proxy set up, step by step?
Find the entry by platform: on mobile (iOS/Android) it is Settings > Data and Storage > Proxy; on desktop it is the top-left three lines > Settings > Advanced > Connection type / Proxy; on Mac it is Settings > Data > Use proxy.
Once there, tap Add proxy and choose the SOCKS5 protocol: set the server to 127.0.0.1 and the port to the actual local port of your VPN client on this machine. Even easier is to just tap a t.me/proxy or tg://proxy link someone shared, and Telegram one-tap imports the MTProto proxy. Be sure to restart Telegram once after setup, and when the status shows Connected it has succeeded. Note it only routes Telegram own traffic.
How do I obtain a Telegram MTProto proxy server address?
MTProto proxies are provided and distributed by third parties, and the official app does not endorse specific nodes.
The common way to get one is for someone to share it as a tg://proxy?server=...&port=...&secret=... or https://t.me/proxy?server=...&port=...&secret= link; tap the link inside Telegram to one-tap import and enable it, and when the status shows Connected it has succeeded. Note that node stability and safety are on you, and free public nodes may be unstable or risky. If you have your own server, you can self-host using the official open-source MTProxy (GitHub: TelegramMessenger/MTProxy).
Which number do I usually enter for the Telegram proxy port?
It depends on the actual local port your VPN client is listening on, and an unaligned port is the most common root cause of being stuck on Connecting on desktop.
Common defaults: Clash / Clash Verge mixed port 7890, the v2rayN SOCKS5 default 10808, and Shadowsocks commonly 1080. In Telegram, set the proxy to SOCKS5, the server to 127.0.0.1, and the port to the client actual local port (based on the software setting), then restart Telegram after setup.
Does the Telegram proxy need a password and a secret?
It depends on the protocol. With a SOCKS5 proxy, set the server to 127.0.0.1 and the port to the client local port; a local client usually needs no username or password (unless your proxy server requires authentication).
With an official MTProto proxy you need a secret, usually imported one-tap by tapping a tg://proxy or t.me/proxy link with the secret already included in the link; a secret starting with dd means fake-TLS is on, disguising traffic as ordinary HTTPS to better resist detection.
How do I one-tap import a proxy link someone shared on Telegram?
Just tap the link inside Telegram to one-tap import and enable it. Common formats are tg://proxy?server=...&port=...&secret=... or https://t.me/proxy?s
erver=...&port=...&secret=...; after you tap it, Telegram pops up a dialog asking you to confirm Use this proxy, and once the status shows Connected it has succeeded. A secret starting with dd means fake-TLS is on, disguising traffic as ordinary HTTPS to resist detection. Note that such nodes are distributed by third parties and not endorsed by the official app, so stability and safety are on you.
What is the difference between a Telegram SOCKS5 proxy and an HTTP proxy?
The most practical difference for Telegram is that its built-in Use Proxy box accepts only SOCKS5, not HTTP/HTTPS proxies.
So when using a proxy to reach Telegram you should choose SOCKS5, set the server to 127.0.0.1, and set the port to the local port of your VPN client. If you want a more detection-resistant approach, switch to Telegram official MTProto proxy (it uses a dedicated protocol and is imported via a one-tap link). In short: use SOCKS5 or MTProto to reach Telegram; an HTTP proxy is of no use in the Telegram built-in proxy.
Are free public Telegram proxies safe, or will they leak my privacy?
Be careful. Free public proxy nodes distributed by third parties are not endorsed by the official app, and node stability and safety are on you, since you do not know whether the node operator logs traffic.
Telegram own end-to-end encryption protects Secret Chats, but using an unknown proxy still carries risk. A safer choice is a VPN tool you control yourself, or self-hosting Telegram official open-source MTProxy (GitHub: TelegramMessenger/MTProxy), where MTProto fake-TLS (a secret starting with dd) can disguise traffic as HTTPS to resist detection. Use an unknown free node if it works, but do not handle anything sensitive over it.
Sources: Telegram MTProto Protocol · Telegram Developer Documentation · Telegram Official FAQ